Skip to content

docs(search): document the highlights parameter (on by default) - #1112

Open
mogery wants to merge 1 commit into
mainfrom
mogery/search-highlights-docs
Open

docs(search): document the highlights parameter (on by default)#1112
mogery wants to merge 1 commit into
mainfrom
mogery/search-highlights-docs

Conversation

@mogery

@mogery mogery commented Jul 7, 2026

Copy link
Copy Markdown
Member

Parallel to firecrawl/firecrawl#3958, which turns search result highlights on by default for v1 and v2 /search (hard 300ms internal budget, falls back to the provider description on index miss or timeout) and exposes highlights in all SDKs.

What

  • api-reference/v2-openapi.json + api-reference/v1-openapi.json: added the highlights boolean (default true) to the search request schemas, so the API reference pages pick it up.
  • features/search.mdx: new "Result Highlights" section under Advanced Search Options — explains the default-on behavior, the fallback guarantee, and shows the highlights: false opt-out in Python/JS/cURL; notes that news results carry the highlight in snippet.
  • agent-source-of-truth/{curl,node,python,java,rust,elixir}.mdx: added the highlights option to each search options list, matching each file's naming convention.

English files only — es/fr/pt-BR/ja/zh are autogenerated and untouched.

🤖 Generated with Claude Code

Search now replaces each result's description with query-relevant
highlights from Firecrawl's index by default (firecrawl/firecrawl#3958),
falling back to the provider description on index miss or timeout.
Documents the new `highlights` boolean (default true, false to opt out)
in the v1/v2 OpenAPI specs, the search feature page, and the
agent-source-of-truth option lists. English files only — translations
are autogenerated.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jul 7, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
firecrawl 🟢 Ready View Preview Jul 7, 2026, 1:30 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant