POST/developer/searchjwt or apiKey3 credits/request
Searches indexed sources only; this operation never starts ingestion or contacts upstream sources. The current ready source is `go:docs` and it covers only the 18 selected verified pages documented by `developer-sources`. Search matches Unicode-aware lexical terms and punctuation-bearing identifiers such as `context.Context`; passages retain byte/line locators into the indexed document. `types` accepts `doc`, `readme`, `issue`, and `pull_request`, but the current source supports only `doc`; unsupported values return 400. The `version` filter is not supported by the current unversioned source and returns 400. Continuation bodies contain only `cursor` and optional `limit`; their pages come from the frozen snapshot and do not repeat the search.
Required: request.
Open in Playground
GET/developer/sourcesjwt or apiKey0 credits/request
Returns the registered developer source catalog and each source's exact supported operations, filters, artifact types, and index state. The current catalog contains only `go:docs`, a selected set of 18 parser-verified Go documentation/specification pages. A source is `not_indexed` until a complete generation is promoted. The catalog does not accept a cursor; `limit` may be 1–100.
Optional: limit.
Sampled 14 Oct 2026: 1 item. Filled in every item: source_id, name, corpus, url, state, operations, filters, artifact_types and 2 more. In the sample: last_success_at: 2026-10-09; url: go.dev; operations: median 1 entry; filters: median 1 entry; artifact_types: median 1 entry.
Open in Playground
GET/web/capabilitiesapiKey0 credits/request
Returns the account's effective web retrieval limits and options: `available_operations`, `crawl_available`, `research_available`, `search_max_results`, `map_max_urls`, `crawl_max_pages`, `max_active_jobs`, and the accepted `render_modes`, `sitemap_modes` and `query_policies`. The operations list is empty while retrieval setup is incomplete.
Takes no parameters.
Sampled 14 Oct 2026: 27 fields returned with a value. In the sample: search_max_results: 50; crawl_available: true; available_operations: 19 entries; research_available: true; render_modes: 2 entries; sitemap_modes: 3 entries; query_policies: 2 entries; map_max_urls: 5,000.
Open in Playground
POST/web/crawlapiKey0 credits/request
Accepts an owner-scoped durable crawl job. `max_credits` is required; the accepted request and active reader/source revisions are frozen for idempotent replay. A repeated matching idempotency key returns the original job without preparing another reservation.
Required: request.
Open in Playground
GET/web/crawl/{job_id}apiKey0 credits/request
Returns status for a crawl job owned by the authenticated principal. This control call does not reserve or settle credits.
Required: job_id.
Open in Playground
POST/web/crawl/{job_id}/cancelapiKey0 credits/request
Requests cancellation of an owned crawl job. This control call does not reserve, charge, or settle credits; retained successful work is reconciled by the job settlement worker.
Required: job_id.
Open in Playground
GET/web/crawl/{job_id}/resultsapiKey0 credits/request
Reads committed outcomes in stable publication order. While running, `has_more=false` only means the job is currently drained; poll again with `next_cursor` to observe later outcomes. Each response is bounded to 1 MiB.
Required: job_id. Optional: cursor, limit.
Open in Playground
POST/web/mapapiKey21 credits/request
Maps a public site into a bounded, approximate URL list from its sitemaps and the seed page's links. The first request needs `url`; options are `scope`, `sitemap` (`include`, `only`, `skip`), `max_urls` (1 to 5000, default 1000) and `page_size` (1 to 500, default 100). Continue with `cursor`, optionally with `page_size`; the first page's snapshot lasts 30 minutes.
Required: request.
Open in Playground
POST/web/searchapiKey34 credits/request
Search Brave's public web results. limit (1-50, default 10) is honoured by reading up to 3 result pages; each successful result page read costs 3 credits, and optional page reads (5 credits each) remain scoped to each result host. country and language select the result locale (defaults us and en-us).
Required: request.
Open in Playground