Skip to main content

​
How to set up Parallel

​
Authentication

Parallel uses API key authentication:
  1. Sign up at 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.
Code slugs — integration slug: parallel · actions: search, extract, createTask. Use them in code as integrations.parallel.search(...).

​
Parallel actions

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