v1

latestOpenAPI 3.0.3MIT2026-07-1751120.4 KB

Search documentation across multiple libraries

Search one or more libraries. Returns scored section results. Accepts library identifiers (e.g. vercel/next.js).

post/v1/search

Request body

querystring required

Natural-language search query. Capped at 2000 characters: longer queries don't improve retrieval quality (embedding models truncate well before that) and indicate a different problem (consider calling read to fetch a section and prompting your own LLM with the result).

librariesstring[] required

One or more library identifiers (owner/repo form).

limitinteger

Maximum number of section results to return (default 10, max 100).

include_contentboolean

When true (default), returns each matched section's full content. When false, returns titles + URLs only (preview mode); follow up with read(url) for the body.

Example request

{
  "query": "middleware authentication",
  "libraries": [
    "vercel/next.js",
    "auth0/nextjs-auth0"
  ]
}

Response

Search results

object'search_result' required

All 5 operations