Wire
Pre-built API actions for popular websites — scrape, browse, and extract structured data
Run pre-built automation actions across hundreds of popular websites. Each action handles browser rendering, authentication, and structured data extraction. Jobs are processed asynchronously — submit a task and poll for results.
How It Works
- Discover an action — list catalogs or search to find an
action_idand its parameter schema - Submit a task — call
POST /v1/holocron/taskwith theaction_idand your parameters - Poll for results — use the returned
job_idto check status and retrieve data
Browse available actions from the Wire dashboard or via the discovery endpoints below.
Endpoints
/v1/holocron/catalogList Catalogs — every supported website with its action count
/v1/holocron/catalog/{slug}Catalog Details — single catalog plus its full action list & schemas
/v1/holocron/searchSearch Actions — find an action_id by query, catalog, or category
/v1/holocron/taskExecute Task — run a pre-built action and get a job ID
/v1/holocron/jobs/{id}Get Job Status — poll for status and retrieve results
Identities & credentials
An identity is a named account on a website (e.g. "Personal Amazon", "Work Amazon"). Each identity holds one or more credentials (cookies, API keys, etc.) — the encrypted auth data needed to run tasks as that account.
To use multi-auth: list your identities, copy the credential_id you want, pass it as credential_id on POST /v1/holocron/task. Identities and credentials are created and managed via the Wire dashboard — the API endpoints below are read-only for discovery.
/v1/holocron/identitiesList all your identities (or one by ID) with their credentials inline
Errors
Common error responses on POST /v1/holocron/task:
| Status | Code | When | Action |
|---|---|---|---|
401 | AUTH_REQUIRED | Action needs auth and you have no credential for this catalog | Visit the connect_url in the response to connect your account |
401 | AUTH_EXPIRED | The credential_id exists but its session is no longer valid (cookies expired, token revoked, password changed) | Have the user reconnect — GET /identities will show status: "expired" on the credential |
403 | FORBIDDEN | The credential_id doesn't belong to you, or belongs to a different catalog than the action | Re-fetch valid credential IDs via GET /v1/holocron/identities |
402 | INSUFFICIENT_CREDITS | Your account balance can't cover the action's credits_per_call | Top up credits or use a smaller-cost action |
500 | EXECUTION_FAILED | Transient submission failure — engine couldn't enqueue the task. Credits are not deducted | Retry the request; if it persists, contact support |