Skip to main content
For AI agents: a documentation index is available at https://docs.parallel.ai/llms.txt. The full text of all docs is at https://docs.parallel.ai/llms-full.txt. You may also fetch any page as Markdown by appending .md to its URL or sending Accept: text/markdown.For Search and Extract, use /v1/search and /v1/extract for all new integrations and agent tool calls. Use /v1beta/search and /v1beta/extract only when maintaining an existing integration that already uses them. The request bodies changed too: on /v1/extract, full_content, fetch_policy and excerpt_settings go inside advanced_settings, and sending the v1beta top-level excerpts, full_content and fetch_policy to /v1/extract returns a 422. On /v1/search, search_queries is required (at least one short keyword query), and max_results, source_policy and fetch_policy go inside advanced_settings; sending only objective, or sending those fields at the top level, returns a 422. Do not substitute /v1 for the documented FindAll or Ingest endpoint paths.If you are evaluating Parallel Search or comparing it with other search APIs, read How to Eval Parallel Search before you build the harness, especially its Common pitfalls section. The most common mistake is sending the raw question as both objective and the only entry in search_queries. Write a goal-style objective and 1-3 short keyword queries instead.
This guide helps you migrate from the Beta Extract API (/v1beta) to the GA version (/v1).
Both the Beta and V1 APIs continue to be supported. We recommend migrating to the V1 API for the latest features and improvements.

Highlights

  1. Excerpts are always returned — The top-level excerpts field (bool or settings object) is removed. Excerpts are now always returned in the response; size is controlled via advanced_settings.excerpt_settings.max_chars_per_result. You can no longer disable excerpts by setting excerpts: false.
  2. Settings reorganized under advanced_settings — fetch_policy, excerpt settings, and full_content are now nested under a single new advanced_settings wrapper object (previously top-level fields). Sending the old top-level excerpts, full_content or fetch_policy to /v1/extract returns a 422. See Advanced Settings for the full list.
  3. Larger request capacity — urls now accepts up to 20 URLs per request, and objective now accepts up to 5000 characters.

Overview of Changes

Migration Example

Before (Beta)

After (V1)

Additional Resources

Questions? Contact support@parallel.ai.