> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parallel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Extract Migration Guide: Beta to GA

> Migrate from Beta to GA (V1) Extract API

<div className="sr-only" aria-hidden="false">
  For AI agents: a documentation index is available at [https://docs.parallel.ai/llms.txt](https://docs.parallel.ai/llms.txt). The full text of all docs is at [https://docs.parallel.ai/llms-full.txt](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.
</div>

This guide helps you migrate from the Beta Extract API (`/v1beta`) to the GA version (`/v1`).

<Note>
  Both the Beta and V1 APIs continue to be supported. We recommend migrating to the V1 API for the latest features and improvements.
</Note>

## 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](/extract/advanced-extract-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

| Component | Beta | V1 |
| - | - | - |
| **Endpoint** | `/v1beta/extract` | `/v1/extract` |
| **SDK method** | `client.beta.extract()` | `client.extract()` |
| **`urls` limit** | Up to 10 URLs per request | Up to 20 URLs per request |
| **`objective` limit** | Up to 3000 characters | Up to 5000 characters |
| **Excerpts** | Configurable via top-level `excerpts` (bool or object); can be disabled with `excerpts: false` | Always returned; size controlled via `advanced_settings.excerpt_settings.max_chars_per_result` (cannot be disabled) |
| **`max_chars_total`** | Inside `excerpts` object | Promoted to top-level request field (controls total excerpt size; does not affect `full_content`) |
| **`client_model`** (new) | — | Top-level field for model-specific optimizations |
| **`session_id`** (new) | — | Top-level field for grouping related Search and Extract calls made by an agent as part of the same task. Server returns one on every response if not provided. |
| **`advanced_settings`** | — | New object nesting `fetch_policy`, `excerpt_settings`, and `full_content` |

## Migration Example

### Before (Beta)

<CodeGroup>
  ```bash cURL theme={"system"}
  curl https://api.parallel.ai/v1beta/extract \
    -H "Content-Type: application/json" \
    -H "x-api-key: $PARALLEL_API_KEY" \
    -d '{
      "urls": ["https://www.un.org/en/about-us/history-of-the-un"],
      "objective": "When was the United Nations established?",
      "excerpts": {
        "max_chars_per_result": 5000,
        "max_chars_total": 50000
      },
      "full_content": {
        "max_chars_per_result": 50000
      }
    }'
  ```

  ```python Python theme={"system"}
  from parallel import Parallel
  import os

  client = Parallel(api_key=os.environ["PARALLEL_API_KEY"])

  extract = client.beta.extract(
      urls=["https://www.un.org/en/about-us/history-of-the-un"],
      objective="When was the United Nations established?",
      excerpts={"max_chars_per_result": 5000, "max_chars_total": 50000},
      full_content={"max_chars_per_result": 50000},
  )

  print(extract.results)
  ```

  ```typescript TypeScript theme={"system"}
  import Parallel from "parallel-web";

  const client = new Parallel({ apiKey: process.env.PARALLEL_API_KEY });

  const extract = await client.beta.extract({
      urls: ["https://www.un.org/en/about-us/history-of-the-un"],
      objective: "When was the United Nations established?",
      excerpts: { max_chars_per_result: 5000, max_chars_total: 50000 },
      full_content: { max_chars_per_result: 50000 },
  });

  console.log(extract.results);
  ```
</CodeGroup>

### After (V1)

<CodeGroup>
  ```bash cURL theme={"system"}
  curl https://api.parallel.ai/v1/extract \
    -H "Content-Type: application/json" \
    -H "x-api-key: $PARALLEL_API_KEY" \
    -d '{
      "urls": ["https://www.un.org/en/about-us/history-of-the-un"],
      "objective": "When was the United Nations established?",
      "max_chars_total": 50000,
      "advanced_settings": {
        "excerpt_settings": {
          "max_chars_per_result": 5000
        },
        "full_content": {
          "max_chars_per_result": 50000
        }
      }
    }'
  ```

  ```python Python theme={"system"}
  from parallel import Parallel
  import os

  client = Parallel(api_key=os.environ["PARALLEL_API_KEY"])

  extract = client.extract(
      urls=["https://www.un.org/en/about-us/history-of-the-un"],
      objective="When was the United Nations established?",
      max_chars_total=50000,
      advanced_settings={
          "excerpt_settings": {"max_chars_per_result": 5000},
          "full_content": {"max_chars_per_result": 50000},
      },
  )

  print(extract.results)
  ```

  ```typescript TypeScript theme={"system"}
  import Parallel from "parallel-web";

  const client = new Parallel({ apiKey: process.env.PARALLEL_API_KEY });

  const extract = await client.extract({
      urls: ["https://www.un.org/en/about-us/history-of-the-un"],
      objective: "When was the United Nations established?",
      max_chars_total: 50000,
      advanced_settings: {
          excerpt_settings: { max_chars_per_result: 5000 },
          full_content: { max_chars_per_result: 50000 },
      },
  });

  console.log(extract.results);
  ```
</CodeGroup>

## Additional Resources

* [Extract Quickstart](/extract/extract-quickstart) - Get started with the V1 Extract API
* [Best Practices](/extract/best-practices) - Optimize your extract requests
* [API Reference](/api-reference/extract/extract) - Complete parameter specifications

Questions? Contact [support@parallel.ai](mailto:support@parallel.ai).