Search that returns up to 20 matching datasets. Results are ordered by relevance.

Parameters:

q – [str] Query term(s) for full text search. The value for this parameter can be a simple word or a phrase. Wildcards can be added to the simple word parameters only, e.g. q=*puma*

type – [str] Type of dataset, options include OCCURRENCE, etc.

keyword – [str] Keyword to search by. Datasets can be tagged by keywords, which you can search on. The search is done on the merged collection of tags, the dataset keywordCollections and temporalCoverages. SEEMS TO NOT BE WORKING ANYMORE AS OF 2016-09-02.

decade – [str] Decade, e.g., 1980. Filters datasets by their temporal coverage broken down to decades. Decades are given as a full year, e.g. 1880, 1960, 2000, etc, and will return datasets wholly contained in the decade as well as those that cover the entire decade or more. Facet by decade to get the break down, e.g. /search?facet=DECADE&facet_only=true (see example below)

Full text search across all datasets. Results are ordered by relevance.

Parameters:

q – [str] Query term(s) for full text search. The value for this parameter
can be a simple word or a phrase. Wildcards can be added to the simple word
parameters only, e.g. q=*puma*

type – [str] Type of dataset, options include OCCURRENCE, etc.

keyword – [str] Keyword to search by. Datasets can be tagged by keywords, which
you can search on. The search is done on the merged collection of tags, the
dataset keywordCollections and temporalCoverages. SEEMS TO NOT BE WORKING
ANYMORE AS OF 2016-09-02.

decade – [str] Decade, e.g., 1980. Filters datasets by their temporal coverage
broken down to decades. Decades are given as a full year, e.g. 1880, 1960, 2000,
etc, and will return datasets wholly contained in the decade as well as those
that cover the entire decade or more. Facet by decade to get the break down,
e.g. /search?facet=DECADE&facet_only=true (see example below)

facet – [str] A list of facet names used to retrieve the 100 most frequent values
for a field. Allowed facets are: type, keyword, publishingOrg, hostingOrg, decade,
and publishingCountry. Additionally subtype and country are legal values but not
yet implemented, so data will not yet be returned for them.

hl – [bool] Set hl=True to highlight terms matching the query when in fulltext
search fields. The highlight will be an emphasis tag of class ‘gbifH1’ e.g.
http://api.gbif.org/v1/dataset/search?q=plant&hl=true
Fulltext search fields include: title, keyword, country, publishing country,
publishing organization title, hosting organization title, and description. One
additional full text field is searched which includes information from metadata
documents, but the text of this field is not returned in the response.

limit – [int] Number of results to return. Default: 300

offset – [int] Record to start at. Default: 0

Note:

Note that you can pass in additional faceting parameters on a per field basis.
For example, if you want to limit the numbef of facets returned from a field foo to
3 results, pass in foo_facetLimit=3. GBIF does not allow all per field parameters,
but does allow some. See also examples.

data – [str] The type of data to get. Default is all data. If not all, then one
or more of contact, endpoint, identifier, tag, machineTag,
comment, hostedDataset, ownedDataset, deleted, pending,
nonPublishing.

uuid – [str] UUID of the data node provider. This must be specified if data
is anything other than all.

q – [str] Query nodes. Only used when data='all'. Ignored otherwise.

identifier – [fixnum] The value for this parameter can be a simple string or integer,
e.g. identifier=120