Developer GuidesData and integrations
Data Schema
Schemas for Live Submissions, Delivery Items, Frontiers, and Tasks.
Live Submission
Returned by GET /v1/live/pull.
| Field | Type | Description |
|---|---|---|
submission_id | string | Submission Snowflake and pagination cursor. |
task_id | string | Task associated with the Submission. |
campaign_id | string | Campaign associated with the Submission. |
data | object | Structured data. Its schema depends on the Template. |
quality_score | number | Quality score. |
quality_grade | string | S, A, B, C, or D. |
unit_price_usd | number | Per-item price used by the Subscription. |
source | string | Source of the Submission. |
created_at | string | ISO timestamp. |
Frontier Summary
Returned by GET /v1/frontiers. It includes domain_id, title, status, task_count, and total_submissions.
Task Summary
Returned by GET /v1/frontiers/tasks?domain_id=<id>. It includes task_id, domain_id, name, task_type, status, and submission_count.
Quality Grades
| Grade | Score | Meaning |
|---|---|---|
| S | 0.97 | Exceptional quality |
| A | 0.85 | High quality |
| B | 0.70 | Standard quality |
| C | 0.50 | Below average |
| D | 0.30 | Low quality |
Delivery Item
A simulated Vertical Subscription item includes an Item ID, Vertical, Topic, Payload, quality information, per-item price, and creation time. The Payload schema depends on the Vertical; process it according to the API response and the relevant Vertical description.