API referenceReport data

Report data

Read a campaign report — posts, audience and spend — with an API key.

What this is

A campaign report's data, the same figures its shared dashboard draws, as JSON or CSV. It is read with a bearer key and is separate from the campaigns API: there is nothing to enrol or post, only a report to read. One key reads one report.

The figures update daily. Audience is weighted by views and carries country, age and gender wherever the creators' own insights reported them. Money is the creator payout and excludes the agency fee.

Authentication

Send the key you were issued as a bearer token on every request. It begins `acr_report_`, resolves the one report it was issued for and nothing else, and belongs on a server rather than in a browser or a mobile build.

cURL
curl "https://acrune.com/dashboard/api/reports/export?format=json" \
  -H "Authorization: Bearer $ACRUNE_REPORT_KEY"

A refused key returns 401 invalid_key. A lost key is rotated, not recovered: ask for a new one and the old key stops working.

The whole report as JSON

`format=json` returns one object: the report's title and campaigns, the headline totals, the view-weighted audience, a row per section and a row per post.

Response
{
  "report": { "title": "...", "updatedAt": "...", "campaigns": ["..."] },
  "totals": {
    "approvedPosts": 164, "notPaidPosts": 84, "views": 5332748,
    "likes": 249036, "engagementRatePct": 4.83,
    "budgetUsd": 10000, "earnedUsd": 5171.34, "remainingUsd": 4828.66
  },
  "audience": {
    "tier1Pct": 70.4,
    "countries": [{ "name": "United States", "pct": 57.2 }],
    "age": [{ "name": "25-34", "pct": 42.7 }],
    "gender": [{ "name": "Men", "pct": 91.8 }]
  },
  "sections": [{
    "campaign": "...", "approvedPosts": 149, "views": 3417952,
    "cpmUsd": null, "budgetUsd": 3600, "earnedUsd": 2642.61
  }],
  "posts": [{
    "campaign": "...", "status": "Approved", "url": "...",
    "platform": "Instagram", "account": "...", "publishedAt": "...",
    "views": 1178704, "likes": 74516, "comments": 204, "shares": 3120,
    "engagementRatePct": 6.6, "earnedUsd": null,
    "audience": { "tier1Pct": 89.7, "topCountry": { "name": "United States", "pct": 84.3 } }
  }]
}

As CSV

`format=csv` returns one row per post for a sheet or a warehouse: campaign, status, the not-paid reason, the post URL, account, published date, views, likes, comments, shares, engagement rate, earned, tier 1 share and top countries.

Google Apps Script
const csv = UrlFetchApp.fetch(
  "https://acrune.com/dashboard/api/reports/export?format=csv",
  { headers: { Authorization: "Bearer " + KEY } }
).getContentText();

Fields

FieldMeaning
totals.earnedUsdWhat the views earned at the campaign's rate, each post capped. Creator payout, before the agency fee.
audience.tier1PctShare of views from the report's tier 1 countries, counted from the countries each source lists, so it is a floor.
audience.age / genderViewer age bands and gender split, where the creators' insights reported them.
posts[].statusApproved, Pending or Not paid.
posts[].pendingReasonWhy a pending post is waiting, such as below the minimum views or in review.
posts[].metricsSourceWhere the views, likes, comments and shares were read from.
posts[].audience.sourceHow the audience was captured: screen_recording, screenshot, oauth or unknown.
posts[].audience.levelWhat it describes: post, account (the whole page) or sample (a sample of the campaign).
dataSourcesWhere each kind of figure in the report came from, as metric and source pairs.
posts[].engagementRatePct(likes + comments + shares) / views, as a percent.

A null amount means unknown, not zero. Money is in whole US dollars.