Skip to content
Protocol primitive

Submit batch job

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

POSTapi.tikultra.com/v1/jobs/submitper task
Upstreamgateway · async batch queue (up to 500 tasks)Every plan

Parameters

NameTypeDescription
tasksrequiredobject[]Up to 500 tasks, each a path and its query.
e.g. [{"path":"/v1/video","query":{"aweme_id":"7705852133855161377"}}]
webhook_urlstringCalled when the job finishes.
e.g. https://example.com/hooks/tikultra

Pricing

Each task in a job costs what its endpoint costs.

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

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"}'
{
  "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"
}
Try it in the playgroundFull reference in the docs

More in Devices, signing & primitives

GET/v1/resolveResolve2 crPOST/v1/resolveResolve (POST)2 crGET/v1/tools/id-converterID converter2 crPOST/v1/tools/protobuf-decodeProtobuf decode2 crGET/v1/jobs/{id}Get jobFreeGET/v1/devicesList devicesFreePOST/v1/devices/provisionProvision device10 crGET/v1/devices/templatesHardware templatesFreeGET/v1/apps/versionsApp versionsFreeGET/v1/devices/{id}Get deviceFreePOST/v1/devices/{id}/bootstrapBootstrap device10 crPOST/v1/devices/{id}/reportDevice security report10 crPOST/v1/crypto/signSign request2 crPOST/v1/crypto/x-cylonsX-Cylons token2 crPOST/v1/crypto/x-argus/decryptX-Argus decrypt2 crPOST/v1/crypto/x-ladon/decryptX-Ladon decrypt2 crPOST/v1/crypto/x-gorgon/decryptX-Gorgon decrypt2 crPOST/v1/crypto/ttencrypt/encryptTTEncrypt encode2 crPOST/v1/crypto/ttencrypt/decryptTTEncrypt decode2 crPOST/v1/crypto/zstd/compresszstd compress2 crPOST/v1/crypto/zstd/decompresszstd decompress2 crPOST/v1/crypto/passport-hashPassport identifier hash2 cr

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API keySee pricing