Submit batch job

Up to 500 tasks, run async, billed per task.

POSTapi.tikultra.com/v1/jobs/submitper task

Upstream: gateway · async batch queue (up to 500 tasks)
Access: Every plan
Runs on: Primitive
Billing: Failed calls are free

Authorization

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Body

Send JSON with content-type: application/json.

tasksobject[]required

Up to 500 tasks, each a path and its query. For example [{"path":"/v1/video","query":{"aweme_id":"7705852133855161377"}}].

webhook_urlstring

Called when the job finishes. For example https://example.com/hooks/tikultra.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

cURLPythonNode.js

curl -X POST https://api.tikultra.com/v1/jobs/submit \
  -H "x-api-key: $TIKULTRA_KEY" \
  -H "content-type: application/json" \
  -d '{"tasks":[{"path":"/v1/video","query":{"aweme_id":"7705852133855161377"}},{"path":"/v1/user","query":{"username":"acme"}}],"webhook_url":"https://example.com/hooks/tikultra"}'

Try itper task

Run this endpoint with your own key in the dashboard playground. Every response shows its cost.

Open in playground

200 · sample

{
  "id": "job_8fK2xQ9mP4",
  "status": "queued",
  "tasks_total": 2,
  "tasks_done": 0,
  "webhook_url": "https://example.com/hooks/tikultra",
  "created_at": "2026-11-11T23:30:00Z"
}