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.

Query Parameters

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

Response Payload

query
string
required

The search query that produced these results.

locale
string
required

The documentation locale the results were drawn from.

results
array of object
required

Matching documentation sections, ordered by descending relevance.

Show child attributes