Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Enriching thousands to millions of records: batching, webhooks, and throughput math.
curl -X POST https://api.up2data.ai/v1/batch \
-H "X-API-Key: $UP2DATA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: import-2026-07-07-chunk-014" \
-d '{
"items": [
{ "type": "profile", "url": "https://linkedin.com/in/a" },
{ "type": "profile", "url": "https://linkedin.com/in/b" },
{ "type": "company", "url": "https://linkedin.com/company/acme" }
],
"webhook_url": "https://app.example.com/hooks/up2data"
}'
{
"data": {
"job_id": "job_7hd92kfa",
"status": "processing",
"total": 3,
"estimated_completion": "2026-07-07T14:03:00Z"
},
"meta": { "creditsUsed": 0, "billed": false, "reason": "job_accepted" }
}
Idempotency-Key header makes retried submissions safe: same key, same job, no duplicates.
batch.completed event fires when the job finishes, carrying the summary and a results URL. Signature verification in Webhooks.
Polling: GET /v1/batch/{job_id} is free, returns per-item status while processing, and the full result set when done:
{
"data": {
"job_id": "job_7hd92kfa",
"status": "completed",
"total": 1000,
"succeeded": 968,
"failed": 32,
"results": [ { "type": "profile", "url": "…", "status": "ok", "data": { } } ],
"failures": [ { "type": "profile", "url": "…", "status": "unprocessable_target" } ]
},
"meta": { "creditsUsed": 968, "creditsRemaining": 421032, "billed": true }
}
| Jobs | 1,000 jobs × 1,000 items |
| Concurrency | 5 concurrent jobs by default — email us for more |
| Credits | ~1M × success rate (typically 95%+) |
| Cost | ≈ 1.50/1Krecordsatthe1Mtier→∗∗ 1,440 consumed for ~960K resolved profiles** |
batch.completed webhooks. A dead-simple loop — submit next chunk on each completion — saturates your concurrency without ever hitting a rate limit.