Full text species search

Hello to everyone and thank you for this great site! I’m building a tool using the GBIF API and I have some questions about its usage.
First one: is it possible to do actual full text search on suggestions? E.g.

https://api.gbif.org/v1/species/suggest?q=Myrta&rank=GENUS
this correctly reports results.

https://api.gbif.org/v1/species/suggest?q=yrta&rank=GENUS
this does not return any result

Should I use a different syntax? Is that just not possible?

Thank you for your time!

The suggestion requires you to type the first letters of the word to work, so not providing the first letters will not give you any results. You could instead use the search function, e.g.: https://api.gbif.org/v1/species/search?q=yrta&rank=GENUS.

1 Like

Thank you for your suggestion. I will try your solution as soon as possible and report back.

Hi, @zanardi Did the suggested solution work for you? Please share your results.

@hamblingreg52 I am not working full time on that project so I did not test yet. I will as soon as possible. Thank you!

Quick update: testing on the browser, I see that the provided URL is not equivalent.

  • /v1/species/suggest?q=Myrta&rank=GENUS provides many results, amongst them “Myrtastrum”, “Myrtaciphyllum”, “Myrtama”
  • /v1/species/search?q=yrta&rank=GENUS provides just two results, both named “Cyrta”.

As I only need to retrieve names and not other details, I’ll keep the suggest endpoint.
Thank you!

1 Like

Thank you for testing this and I can see it was not what you were looking for since the search function only gives you the first fuzzy match. If you have not seen this blog post yet, it might be of value for future queries: (Almost) everything you want to know about the GBIF Species API - GBIF Data Blog

2 Likes