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. Do not substitute /v1 for the documented FindAll or Ingest endpoint paths.
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.