TEASEDocs
API ReferenceVault

Who bought this content, by cohort

Groups this content's buyers by source / RFM / spend tier and returns a lookalike non-buyer audience to re-target. A content with no sales returns empty cohorts and has_buyers=false. Requires a read-scoped key.

Authorization

bearerAuth
AuthorizationBearer <token>

Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.

In: header

Path Parameters

content_id*integer

Content id.

Response Body

application/json

application/json

application/json

GET
/api/admin/content/{content_id}/cohorts
curl -X GET "https://example.com/api/admin/content/0/cohorts"
{  "has_buyers": true,  "buyers_by_cohort": {    "source": {      "instagram": 41,      "tiktok": 22    },    "rfm_tag": {      "whale": 7    }  },  "retarget": {    "filters": {      "source": "instagram",      "rfm_tag": "whale"    },    "estimated_count": 320  },  "revenue_cents": 184000}
{  "detail": "Not authenticated"}
{  "detail": {    "code": "engine_not_connected",    "message": "Connect your engine to access this data."  }}

Content cover image

Returns a thumbnail image for one content item, or 404 if none exists. Requires a read-scoped key.

Suggested PPV price

Returns a suggested PPV price and a verdict (raise/lower/ok/insufficient_data); insufficient_data when there is too little sales history. All money in integer cents. Requires a read-scoped key.