Home / Developers

Developer center

Wire databurger into your training pipeline with APIs: search datasets, pull samples, create labeling and evaluation tasks, subscribe to delivery webhooks.

Exact API paths, parameters and response samples are visible after signing in to the developer center. The developer center is separate from the marketing site and gates interface details by platform policy.

Open capabilities

Covering the full data lifecycle — metered by usage, with quota packages for enterprise accounts.

Dataset search & purchase

GET /datasets lists packages for sale by domain; /{did} for detail, /sample for a free sample, /report for the QA report; POST /{did}/buy to order, GET /datasets/mine to list purchases.

Video evaluation tasks

POST /tasks publishes a task and freezes its funds; workers /claim and /evaluate; the buyer's /accept triggers settlement; /reject returns it for rework with a reason.

Labeling jobs

/labeling/jobs to create and claim, /submit to deliver results, /qc for the QA verdict; plus a pending-QA queue and consistency statistics.

Scenario task library

GET /scenario-tasks searches SOP scenarios by category and keyword (public, no auth); /meta for the category tree and totals; /{tid}/claim to claim.

Account & funds

GET /ledger for transactions, /invoices, POST /recharge, /withdrawals and /withdraw for payouts, POST /kyc for identity verification.

Projects & progress

GET /projects for stage and progress, /collections for collection batches, /notifications, and /metrics/public for public platform metrics (no auth required).

Authentication & tokens

Sign in to obtain a session token and send it with each request. The token is equivalent to your account credential — use it server-side only.
Auth details →
StepEndpointKey parametersReturns
1. Sign inPOST /login-passwordphone, password, roletoken and account info
1'. Code sign-inPOST /send-code → POST /loginphone, code, roletoken and account info
2. Send the tokenAll business endpointsHeader Authorization: Bearer <token>—
3. VerifyGET /me—Account ID, role, balance, KYC status

Roles determine what you can call

Buyers (buyer) publish tasks, recharge and buy datasets; workers (judge) claim, submit and score. Out-of-role calls return 403 with a specific reason.

Token expiry & sign-in protection

An expired token returns 401 {"detail":"Not signed in or session expired"} — sign in again. Five failed attempts for the same phone number within 15 minutes triggers a temporary lock that returns 429.
Version 1 does not provide an API key / scope system. Do not integrate any third-party page or tool claiming to offer self-service databurger API key management.

Quick start

Three steps: sign in for a token → verify with read-only calls → publish a task and drive it to settlement.
Full integration guide →

Sign in and get a token

POST /login-password with your phone number and password returns a token.

Verify with read-only calls

Call GET /me and GET /datasets first to confirm auth and connectivity (the latter needs no token).

Publish a task and drive it to settlement

POST /tasks freezes the task funds; after the worker claims and submits, the buyer's /accept settles it.

Copy# 1) Sign in and get a token
curl -X POST "https://aidataburger.com/api/v1/login-password" \
  -H "Content-Type: application/json" \
  -d '{"phone":"13800000000","password":"********","role":"buyer"}'

# 2) Search datasets (read-only, no token needed)
curl "https://aidataburger.com/api/v1/datasets?domain=medical"

# 3) Publish a video evaluation task
curl -X POST "https://aidataburger.com/api/v1/tasks" \
  -H "Authorization: Bearer $DB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Livestream clip compliance review","video_url":"https://.../a.mp4"}'
These commands can be copied and run as-is. Replace the sample phone number and password with your own account.

Samples & integration

No official SDK package in version 1; the docs provide runnable native Python and JavaScript samples.

Event retrieval

No webhook callbacks in version 1 — poll /tasks/mine, /notifications and /projects for status.

Calling conventions

Read-only endpoints are free; tasks and purchases are billed by amount. Retry with backoff on 5xx and network errors only.

Status & support

Availability, changelog and remediation notes during incidents.