Ad Insights

Poll an async insights report run

Changed on

Checks progress of a background Meta insights report and returns its results once it has finished.

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}

Request

  • Base URL
    https://zernio.com/api
  • Auth
    HTTP bearer

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.

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • info

      added the media type application/json for the response with the status