Parallel Research

Overview

Deep web research, competitive intelligence, entity discovery, and data enrichment using Parallel AI's specialized APIs.

Quick Decision Tree

What do you need?
│
├── Quick factual answer (3-5 seconds)
│   └── Chat API ($0.005/request)
│   └── Script: scripts/parallel_research.py chat "question"
│
├── Comprehensive research report (5min-2hr)
│   └── Deep Research API ($0.30/report for ultra)
│   └── Script: scripts/parallel_research.py research "topic"
│
├── Find entities matching criteria (companies, people)
│   └── FindAll API ($0.03 + $0.10/match)
│   └── Script: scripts/parallel_research.py findall "query"
│
└── Enrich existing data (add fields to records)
    └── Task API with schema ($0.025/record for core)
    └── Script: scripts/parallel_research.py enrich data.csv

Environment Setup

# Required in .env
PARALLEL_API_KEY=your_api_key_here

Get your API key: https://platform.parallel.ai/settings/api-keys

Common Usage

Quick Q&A

python scripts/parallel_research.py chat "What is Anthropic's latest funding round?"

Deep Research Report

python scripts/parallel_research.py research "Competitive landscape of AI code editors in 2025" --processor ultra

Find Companies

python scripts/parallel_research.py findall "AI code editor companies that raised funding in 2024-2025" --limit 50

Basic Research (Simplified)

python scripts/basic_research.py "Company Name"

Vendor Selection

python scripts/vendor_selection.py "CRM software" --requirements "enterprise,API,automation"

Processor Tiers

Cost Estimates

Free Tier

20,000 requests free (combined across all APIs).

Security Notes

Credential Handling

• •Store PARALLEL_API_KEY in .env file (never commit to git)
• •Regenerate keys at https://platform.parallel.ai/settings/api-keys
• •Never log or print API keys in script output
• •Use environment variables, not hardcoded values

Data Privacy

• •Research queries are sent to Parallel AI servers
• •Research outputs may contain third-party company information
• •Results are stored locally in .tmp/ directory
• •Parallel AI may log queries for service improvement
• •Avoid including sensitive internal data in research queries

Access Scopes

• •API key provides full access to all research endpoints
• •No granular permission scopes available
• •Monitor usage and costs via Parallel AI dashboard

Compliance Considerations

• •Data Sources: Research pulls from public web sources
• •Citation: Always cite sources in research outputs
• •Accuracy: AI-generated research should be verified
• •Competitive Intel: Ensure competitive research complies with policies
• •Third-Party Data: Respect intellectual property of sources
• •PII in Results: Research results may contain company/individual PII
• •Data Freshness: Verify currency of time-sensitive information

Troubleshooting

Common Issues

Issue: Processor timeout

Symptoms: Request times out or returns partial results Cause: Complex query requiring more processing time than allowed Solution:

• •Use a faster processor tier (lite or base instead of ultra)
• •Simplify the research query
• •Break complex queries into multiple smaller requests
• •Increase timeout in script if configurable

Issue: Credits exhausted

Symptoms: "Insufficient credits" or quota error Cause: Account credits depleted Solution:

• •Check balance at https://platform.parallel.ai/dashboard
• •Upgrade plan or purchase additional credits
• •Use lower-cost processor tiers for less critical queries
• •Monitor usage to avoid unexpected depletion

Issue: Invalid response format

Symptoms: JSON parsing error or unexpected response structure Cause: API returned error or malformed response Solution:

• •Check query format matches API requirements
• •Retry the request (may be transient issue)
• •Verify API key is valid and active
• •Review API documentation for expected response format

Issue: Empty or irrelevant results

Symptoms: Research returns no results or off-topic content Cause: Query too narrow, ambiguous, or poorly structured Solution:

• •Broaden the search query
• •Add context to clarify query intent
• •Try different phrasing or keywords
• •Use Chat API first to validate query understanding

Issue: API authentication failed

Symptoms: "Invalid API key" or 401 error Cause: API key expired, invalid, or not set Solution:

• •Regenerate key at https://platform.parallel.ai/settings/api-keys
• •Verify PARALLEL_API_KEY is set correctly in .env
• •Check for leading/trailing whitespace in key
• •Ensure key has not been revoked

Issue: Rate limited

Symptoms: 429 error or "rate limit exceeded" Cause: Too many concurrent requests Solution:

• •Add delays between requests
• •Reduce parallel request count
• •Implement exponential backoff
• •Contact support for higher rate limits if needed

Resources

• •references/api-guide.md - Complete API documentation
• •references/basic-research.md - Simple company research
• •references/vendor-selection.md - Vendor comparison workflow

Integration Patterns

Research to Report

Skills: parallel-research → content-generation Use case: Create polished reports from research findings Flow:

1. •Run deep research on topic/company
2. •Generate structured research output
3. •Format into branded document via content-generation

FindAll to CRM

Skills: parallel-research → attio-crm Use case: Populate CRM with discovered companies Flow:

1. •Use FindAll to discover companies matching criteria
2. •Enrich each company with additional data
3. •Create/update company records in Attio CRM

Research to Sheets

Skills: parallel-research → google-workspace Use case: Build research database in Google Sheets Flow:

1. •Run FindAll or batch research on multiple entities
2. •Structure results as tabular data
3. •Upload to Google Sheets for team collaboration