Parallel Data Enrichment
Enrich company or entity data into structured JSON using the Task API. Use core (1-5 min, $0.025) or base (15-100s, $0.01) for structured output.
CLI alternative (recommended): Install parallel-cli for official skill: npx skills add parallel-web/parallel-agent-skills --skill parallel-data-enrichment
Setup
API_KEY=$(grep "^PARALLEL_API_KEY=" .env.local | cut -d= -f2)
Create Enrichment 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": "OpenAI",
"processor": "core",
"output_schema": {
"type": "object",
"properties": {
"name": {"type": "string"},
"founded_year": {"type": "integer"},
"headquarters": {"type": "string"},
"employee_count": {"type": "integer"},
"key_products": {"type": "array", "items": {"type": "string"}}
}
}
}'
Response: {"id": "task_abc123", "status": "queued"}
Check Result
curl -s "https://api.parallel.ai/v1beta/tasks/runs/task_abc123"
-H "x-api-key: $API_KEY"
{ "id": "task_abc123", "status": "completed", "result": { "content": { "name": "OpenAI", "founded_year": 2015, "headquarters": "San Francisco, CA", "employee_count": 770, "key_products": ["ChatGPT", "GPT-4", "DALL-E", "Whisper"] }, "basis": { "citations": [{"url": "...", "excerpt": "..."}] } } }
Processors
Processor Speed Cost Use For
base 15-100s $0.01/task Quick lookups, simple data
core 1-5 min $0.025/task Enrichment, verification, structured data
Tips for output_schema
-
Keep schemas simple — fewer fields = more reliable
-
Use "type": "string" broadly; avoid strict enums
-
Omit optional fields from the schema
When to Use
-
Company or person data enrichment
-
Structured data extraction with typed schemas
-
Lead qualification, CRM enrichment, research
For narrative reports, use parallel-deep-research . For web search, use parallel-web-search .