Sign inGet Started

Get documentation search results

GET
/v1/docs/search
bird docs search <q>

Searches the documentation and returns matching sections, best match first. Each result links to its section heading and includes the page's slug; read the full page with GET /v1/docs/pages.

No authentication is required. A blank query returns 400, and 503 means search is temporarily unavailable.

Paramètres de requête

qstring

The text to search the documentation for. Must not be blank.

localestring

Documentation locale to search, as a language-region code such as en-us. Defaults to en-us when omitted or unavailable.

limitinteger

Maximum number of results to return (1–25).

contentsstring

How much of each matching section to return. snippet (the default) returns a short preview; highlights additionally returns the passages that match the query. For the full text, fetch a result's markdown_url.

Possible values: snippet, highlights

Contenu de la réponse

query
string
obligatoire

The search query that produced these results.

locale
string
obligatoire

The documentation locale the results were drawn from.

results
array of object
obligatoire

Matching documentation sections, ordered by descending relevance.

Afficher les attributs enfants