<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  </head>
  <body bgcolor="#FFFFFF" text="#000000">
    Dear Markus,<br>
    <br>
    My idea is that based on the validation services provided by GBIF to
    implement a search form with similar functionality (autocomplete,
    etc.) as the "Search for scientific names" form at Catalogue of
    life:<br>
    <a moz-do-not-send="true"
      href="http://www.catalogueoflife.org/col/search/scientific">http://www.catalogueoflife.org/col/search/scientific</a><br>
    <br>
    What is your opinion, is this way with the GBIF suggest api plus
    client side filtering a proper way? Considering the possible number
    of unnecessary result records (everything where kingdomKey<>6)
    and the number of unnecessary fields in each record (everything
    except the GENUS field), wouldn't that be an unacceptable overload
    at GBIF side and performance / bandwidth issues at the requestor
    webapp side?<br>
    <br>
    Cheers:<br>
    József<br>
    <br>
    <br>
    <div class="moz-cite-prefix">2017-09-07 11:47 keltezéssel, Markus
      Döring írta:<br>
    </div>
    <blockquote type="cite"
      cite="mid:3E119820-1CD1-4BE6-BF9B-9A8F3F5A432B@gbif.org">
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
      this is unfortunately not possible.
      <div class="">You will have to filter them clientside checking for
        records with kingdomKey=6 or kingdom="Plantae"</div>
      <div class=""><br class="">
      </div>
      <div class="">Markus</div>
      <div class=""><br class="">
        <div class=""><br class="">
          <div>
            <blockquote type="cite" class="">
              <div class="">On 7. Sep 2017, at 11:22, Szlamka József
                <<a href="mailto:szlajozs@gmail.com" class=""
                  moz-do-not-send="true">szlajozs@gmail.com</a>>
                wrote:</div>
              <br class="Apple-interchange-newline">
              <div class="">
                <div bgcolor="#FFFFFF" text="#000000" class="">
                  <br>
                  Dear Markus,<br>
                  <br>
                  Thank you very much. Do you have any idea, using the
                  "suggest" API would it be possible somehow to filter
                  the results for the Plantae kingdom only?
                  <br class="">
                  <br>
                  József<br class="">
                  <br class="">
                  <br class="">
                  <div class="moz-cite-prefix">2017-09-07 10:17
                    keltezéssel, Markus Döring írta:<br class="">
                  </div>
                  <blockquote type="cite"
                    cite="mid:1A043384-B6E6-4DB7-8FC8-798724A1DDEA@gbif.org"
                    class="">
                    Hi József,
                    <div class=""><br class="">
                    </div>
                    <div class="">the GBIF API hardly anywhere accepts
                      wildcards. Apart from fuzzy matching entire words
                      the only place you can use is the suggest API
                      which should help you with your problem.</div>
                    <div class=""><br class="">
                    </div>
                    <div class="">It is a kind of autocomplete and you
                      have to match the beginning of a word. It wont
                      match in the middle or end. It does match on all
                      words or tokens of a string, so for a species name
                      it will match the genus part, the epithet or even
                      the authorship. Results are prioritized with
                      author based matches coming last and higher ranks
                      being more important.</div>
                    <div class=""><br class="">
                    </div>
                    <div class="">Here is an example:</div>
                    <div class=""><a
href="http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado"
                        class="" moz-do-not-send="true">http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado</a></div>
                    <div class=""><br class="">
                    </div>
                    <div class="">The suggest API only allows you to
                      retrieve 100 records though, but you can page
                      through results up to 100.000 records max:</div>
                    <div class="">
                      <div class=""><a
href="http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100"
                          class="" moz-do-not-send="true">http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100</a></div>
                    </div>
                    <div class="">-> returns first 100 genera
                      starting with Ado</div>
                    <div class="">
                      <div class=""><br class="">
                      </div>
                      <div class=""><a
href="http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100&offset=100"
                          class="" moz-do-not-send="true">http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100&offset=100</a></div>
                    </div>
                    <div class="">-> returns 49 more genera starting
                      with Ado</div>
                    <div class="">
                      <div class=""><br class="">
                      </div>
                      <div class=""><a
href="http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100&offset=200"
                          class="" moz-do-not-send="true">http://api.gbif.org/v1/species/suggest?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS&q=Ado&limit=100&offset=200</a></div>
                      <div class="">-> returns 0 genera as expected</div>
                    </div>
                    <div class=""><br class="">
                    </div>
                    <div class=""><br class="">
                    </div>
                    <div class="">Cheers,</div>
                    <div class="">Markus</div>
                    <div class=""><br class="">
                    </div>
                    <div class=""><br class="">
                    </div>
                    <div class=""><br class="">
                      <div class="">
                        <blockquote type="cite" class="">
                          <div class="">On 7. Sep 2017, at 08:36,
                            Szlamka József <<a
                              href="mailto:szlajozs@gmail.com" class=""
                              moz-do-not-send="true">szlajozs@gmail.com</a>>
                            wrote:</div>
                          <br class="Apple-interchange-newline">
                          <div class="">
                            <div bgcolor="#FFFFFF" text="#000000"
                              class="">Dear Scott,<br class="">
                              <br class="">
                              Many thanks for your answer. I also added
                              the "&highertaxonKey=6" param to
                              narrow the results for plant genera only.<br
                                class="">
                              <br class="">
                              To be more precise what I exactly wish to
                              achieve is as follows:<br class="">
                              <br class="">
                              1./<br class="">
                              I only want to search within the "Plantae"
                              kingdom.<br class="">
                              <br class="">
                              2./<br class="">
                              Say, I look for the GENUS name "Adonis"
                              but I only remember that the name starts
                              with "Ado".<br class="">
                              <br class="">
                              3./<br class="">
                              So my ideal API call would run a wildcard
                              search within PLANT GENERA names for
                              "Ado*" and would result in a list of ALL
                              (without limit) plant genera names
                              starting with "Ado*".<br class="">
                              <br class="">
                              I played with the "/species/match",
                              "/species/search" and "/species/suggest"
                              sub-apis and with the "q" and "name"
                              params. They don't accept wildcards and
                              don't give the expected results for name
                              chunks without wildcards.<br class="">
                              <br class="">
                              Now my only hope is that I left out some
                              constellations or misused something.<br
                                class="">
                              <br class="">
                              József<br class="">
                              <br class="">
                              <br class="">
                              <div class="moz-cite-prefix">2017-09-06
                                23:21 keltezéssel, Scott Chamberlain
                                írta:<br class="">
                              </div>
                              <blockquote type="cite"
cite="mid:CAD-oS=9JK4Kkz72qNJhSNdyTrO2-dqOWUya9WaHbeHC0ss+2iQ@mail.gmail.com"
                                class="">
                                <div dir="ltr" class="">Have you tried
                                  something like 
                                  <div class=""><br class="">
                                  </div>
                                  <div class=""><a
href="http://api.gbif.org/v1/species/search?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS"
                                      moz-do-not-send="true" class="">http://api.gbif.org/v1/species/search?datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c&rank=GENUS</a><br
                                      class="">
                                  </div>
                                  <div class=""><br class="">
                                  </div>
                                  <div class="">where
                                    datasetkey=d7dddbf4-2cf0-4f39-9b2a-bb099caae36c
                                    is for the GBIF backbone taxonomy</div>
                                  <div class=""><br class="">
                                  </div>
                                  <div class="">Scott</div>
                                </div>
                                <br class="">
                                <div class="gmail_quote">
                                  <div dir="ltr" class="">On Wed, Sep 6,
                                    2017 at 2:10 PM Szlamka József <<a
                                      href="mailto:szlajozs@gmail.com"
                                      moz-do-not-send="true" class="">szlajozs@gmail.com</a>>
                                    wrote:<br class="">
                                  </div>
                                  <blockquote class="gmail_quote"
                                    style="margin:0 0 0
                                    .8ex;border-left:1px #ccc
                                    solid;padding-left:1ex">
                                    Hello to all list members,<br
                                      class="">
                                    <br class="">
                                    I'm new on this list and also new to
                                    the GBIF API. I'd like to get a<br
                                      class="">
                                    list of all the genus names occuring
                                    in the GBIF database. After several<br
                                      class="">
                                    hours of trying with the API, and no
                                    success, I found this mailing list.<br
                                      class="">
                                    I hope that API guru members on the
                                    list can show me the right way or<br
                                      class="">
                                    tell if this is not possible at all.<br
                                      class="">
                                    <br class="">
                                    Thank you in advance.<br class="">
                                    <br class="">
_______________________________________________<br class="">
                                    API-users mailing list<br class="">
                                    <a
                                      href="mailto:API-users@lists.gbif.org"
                                      target="_blank"
                                      moz-do-not-send="true" class="">API-users@lists.gbif.org</a><br
                                      class="">
                                    <a
                                      href="https://lists.gbif.org/mailman/listinfo/api-users"
                                      rel="noreferrer" target="_blank"
                                      moz-do-not-send="true" class="">https://lists.gbif.org/mailman/listinfo/api-users</a><br
                                      class="">
                                  </blockquote>
                                </div>
                              </blockquote>
                              <br class="">
                            </div>
_______________________________________________<br class="">
                            API-users mailing list<br class="">
                            <a href="mailto:API-users@lists.gbif.org"
                              class="" moz-do-not-send="true">API-users@lists.gbif.org</a><br
                              class="">
                            <a class="moz-txt-link-freetext"
                              href="https://lists.gbif.org/mailman/listinfo/api-users"
                              moz-do-not-send="true">https://lists.gbif.org/mailman/listinfo/api-users</a><br
                              class="">
                          </div>
                        </blockquote>
                      </div>
                      <br class="">
                    </div>
                  </blockquote>
                  <br class="">
                </div>
              </div>
            </blockquote>
          </div>
          <br class="">
        </div>
      </div>
    </blockquote>
    <br>
  </body>
</html>