Under the hood

  1. You'll need to request your specific access token from the CreativeX team. This is your unique token which will allow you to access your data in the CreativeX dashboard. This is required to be able to make any calls to any of our endpoints.
  2. Using your access token and other query parameters, you'll need to make a POST request to https://api.creativex.com/api/v3/reports. You'll receive a response with a Report ID and a Status. If you repeat a call with the same query parameters within 3 hours of the initial call, then you’ll receive back the same report id.
  3. As soon as you get the Report ID from the previous call, you’ll need to directly use that to make a GET request call to https://api.creativex.com/api/v3/reports/{id}/posts for all creative data available (including brands, markets and channels) for a given time period.
    1. The id in the path would need to be replaced by the Report ID.
    2. You’ll need to make sure that the status provided is “DONE” in order to have all the data available (keep in mind that if the status is “IN_PROGRESS” then you have to make a GET request call again until the status is “DONE”).
    3. Because the response will be paginated with 1,000 posts per page, you'll need to keep making GET requests for every page until there are no more pages available which means you've retrieved all the available data (when the "next_page" field is NULL). The next page can be retrieved with https://api.creativex.com/api/v3/reports/{id}/posts?page=page.
  4. Separately, if you're looking for a list of all the brands, markets and channels available for a given time period, then you'll need to make a GET request on the https://api.creativex.com/api/v3/reports/dimensions.