v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Ad Insights

Poll an async insights report run

Status and results for a report run created via POST /v1/ads/insights/reports. While the job runs, returns status and percentCompletion. Once status is "Job Completed" the response also carries a data page, cursor-paginated via limit / after.

get/v1/ads/insights/reports/{reportRunId}

Path parameters

reportRunIdstring required

Query parameters

accountIdstring required

Zernio SocialAccount id used to resolve the Meta token (must be the same connection that created the run).

limitinteger
afterstring

Response

Report run status (plus results when completed)

reportRunIdstring
statusstring

Meta async_status: Job Not Started, Job Started, Job Running, Job Completed, Job Failed, Job Skipped.

percentCompletioninteger
dateStartstring
dateStopstring
dataobject[]

Present only when status is Job Completed.