Parallel Deep Research

Comprehensive research reports with multi-source synthesis. Use pro (3-9 min, $0.10) or ultra (5-25 min, $0.30) for deep analysis.

CLI alternative (recommended): Install parallel-cli for official skill: npx skills add parallel-web/parallel-agent-skills --skill parallel-deep-research

Setup

API_KEY=$(grep "^PARALLEL_API_KEY=" .env.local | cut -d= -f2)

Create Research Task

curl -s -X POST "https://api.parallel.ai/v1beta/tasks/runs" \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Analyze the AI chatbot market. Include: size, growth, key players, trends, competitive threats",
    "processor": "pro",
    "output_schema": "text"
  }'

Response: {"id": "task_abc123", "status": "queued"}

Polling Loop

TASK_ID="task_abc123"

while true; do
  RESULT=$(curl -s "https://api.parallel.ai/v1beta/tasks/runs/$TASK_ID" \
    -H "x-api-key: $API_KEY")

  STATUS=$(echo $RESULT | grep -o '"status":"[^"]*"' | cut -d'"' -f4)

  if [ "$STATUS" = "completed" ]; then
    echo "$RESULT"
    break
  elif [ "$STATUS" = "failed" ]; then
    echo "Task failed: $RESULT"
    break
  fi

  sleep 5
done

Processors

Processor	Speed	Cost	Use For
pro	3-9 min	$0.10/task	Market analysis, strategic reports
ultra	5-25 min	$0.30/task	Comprehensive deep research

Example: Market Analysis

{
  "input": "Analyze the AI chip market in 2024. Include market size, growth rate, key players (NVIDIA, AMD, Intel), emerging competitors, and 2025 outlook.",
  "processor": "pro",
  "output_schema": "text"
}

Result: Markdown report with citations.

When to Use

• Market research and competitive analysis
• Strategic reports requiring multiple sources
• Research that needs synthesis across many documents

For quick facts, use parallel-web-search. For structured data extraction, use parallel-data-enrichment.

Timeout

Set polling timeout to 1800s (30 min) for ultra tasks. Pro tasks typically complete in 3-9 min.