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.

Parametry zapytania

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

Treść odpowiedzi

query
string
wymagane

The search query that produced these results.

locale
string
wymagane

The documentation locale the results were drawn from.

results
array of object
wymagane

Matching documentation sections, ordered by descending relevance.

Pokaż atrybuty podrzędne