Skip to main content
POST
Request sponsorship research

Authorizations

X-API-Key
string
header
required

Body

application/json
idempotency_key
string
required
Required string length: 1 - 256
platforms
enum<string>[]
required
Required array length: 1 - 3 elements
Available options:
instagram,
youtube,
tiktok
budget
DemandBudget · object
required
publication_ids
string[]
Maximum array length: 1000
keywords
string[]
Maximum array length: 100
categories
string[]
Maximum array length: 100
category_subject
enum<string>
default:publication_vertical
Available options:
publication_vertical,
sponsor_industry
unknown_category_policy
enum<string>
default:report_partial
Available options:
report_partial,
bounded_recall
recall_terms
string[]
Maximum array length: 100
published_from
string<date-time> | null
published_until
string<date-time> | null
include_undated
boolean
default:true
evidence_surfaces
enum<string>[]
Available options:
canonical_text,
full_transcript,
ocr

Response

Successful Response

request_id
string
required
Required string length: 1 - 256
status
enum<string>
required
Available options:
queued,
processing,
waiting,
complete,
partial
scanned_rows
integer
required
Required range: x >= 0
matched_candidates
integer
required
Required range: x >= 0
completed_candidates
integer
required
Required range: x >= 0
pending_candidates
integer
required
Required range: x >= 0
unknown_rows
integer
required
Required range: x >= 0
scan_complete
boolean
required
coverage
Coverage · object | null
source_boundary
ContentReadBoundary · object | null
captured_at
string<date-time> | null
reasons
string[]
results
DemandResultProof · object[]