Developers
CAELARIO API / V1

Build data workflows, not scraping infrastructure.

One authenticated API for durable jobs, hundred-target batches, recurring schedules, stored results and export-ready public social data.

API operationalBase URL https://api.caelario.comJSON over HTTPS
01

Quickstart

Create a key and run your first durable extraction.

Read guide →
02

Authentication

Use workspace-scoped API keys safely.

Read guide →
03

Jobs

Submit, poll, cancel and export one target.

Read guide →
04

Batches

Run one operation across as many as 100 targets.

Read guide →
05

Scheduling

Run once or recur daily, weekly or monthly.

Read guide →
06

Platforms

Targets, operations and result limits by network.

Read guide →
FIRST REQUEST

From API key to durable job in one call.

Create a workspace key in the customer dashboard. Caelario validates the request, reserves its maximum credit cost and returns a job ID immediately.

Open the five-minute quickstart →
cURL
curl -X POST "https://api.caelario.com/v1/jobs" \
  -H "X-API-Key: $CAELARIO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "instagram",
    "operation": "profile",
    "target": "nike",
    "include_posts": 5
  }'
01

Asynchronous by design

Submit work once, keep its ID, and poll from any process. No long-lived browser or HTTP connection.

02

Safe to retry

Idempotency keys protect uncertain submissions from duplicate reservations and duplicate work.

03

Pay for delivered results

Maximum cost is reserved up front. Failed work releases it; completed work settles only delivered results.

HTTP REFERENCE

Every public endpoint. No control-plane noise.

The human reference covers the public contract, while the filtered OpenAPI document remains available for tooling and code generation.

Developer supportSend integration questions to hello@caelario.com. For failed requests, include the X-Request-ID response header—never your API key.