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

# Parallel

> Connect Parallel AI for web search, content extraction, and deep research tasks in your workflows.

## How to set up Parallel

### Authentication

Parallel uses API key authentication:

1. Sign up at [parallel.ai](https://parallel.ai)
2. Create an API key in your Parallel dashboard
3. Paste the API key in Cargo when connecting

Parallel runs on your own Parallel account: usage is billed by Parallel against your API key, not through Cargo credits.

<Note>
  **Code slugs** — integration slug: `parallel` · actions: `search`, `extract`, `createTask`. Use them in code as `integrations.parallel.search(...)`.
</Note>

## Parallel actions

### Search

Search the web with Parallel AI and return ranked results with relevant excerpts.

**Required fields:**

* **Search queries**: Concise keyword queries, 3-6 words each; provide 2-3 for best results

**Optional fields:**

* **Objective**: Natural-language description of the question or goal driving the search
* **Search mode**: `basic` for lowest latency, `advanced` for higher quality (default)
* **Number of results**: Maximum results to return (1-100)
* **Max characters total**: Upper bound on total characters across excerpts
* **Include domains**: Only return results from these domains (accepts `.gov`-style extensions)
* **Exclude domains**: Exclude results from these domains
* **After date**: Only include results published on or after this date (YYYY-MM-DD)

**Use case:** Find recent news, funding announcements, or public signals about an account before outreach.

### Extract

Extract relevant content from specific web URLs.

**Required fields:**

* **URLs**: URLs to extract content from (up to 20)

**Optional fields:**

* **Objective**: Natural-language goal used to focus excerpts on the most relevant content
* **Search queries**: Keyword queries used together with the objective to focus excerpts
* **Max characters total**: Upper bound on total characters across extracted excerpts
* **Include full content**: Also return the full page content as markdown

**Use case:** Pull pricing, careers, or product details from known pages of a prospect's website for enrichment.

### Create Task

Execute a full web research task — complex queries that require deep research, analysis, and structured output. The task runs asynchronously on Parallel's side and the workflow resumes when it completes (up to 60 minutes).

**Required fields:**

* **Input**: A natural-language question or a description of what to research
* **Processor**: `base` (fastest/cheapest), `core` (balanced, default), `pro` (higher quality), or `reason` (complex reasoning)

**Optional fields:**

* **Output schema**: Description of the desired output — natural language or a JSON schema as a string
* **Include domains**: Only use results from these domains
* **Exclude domains**: Exclude results from these domains
* **After date**: Only include results published on or after this date (YYYY-MM-DD)
* **Location**: ISO 3166-1 alpha-2 country code for geo-targeted results (e.g., `us`, `gb`)

The result includes the task output, output metadata (citations and confidence), and the sources used.

**Use case:** Research an entire account — business model, ICP fit, recent initiatives — and return it as a structured object for scoring.

## Best practices

* Use Search for quick lookups and Create Task for research that needs synthesis across many sources
* Give Create Task an output schema to get structured, mappable results instead of free text
* Scope searches with include/exclude domains and an after date to cut noise and stale results
* Pick the cheapest processor that does the job: `base` for simple lookups, `reason` only for genuinely complex questions
* Account for Create Task's asynchronous nature (up to 60 minutes) when designing time-sensitive workflows