TEASEDocs
API ReferenceVault

Recommend unseen content for a cohort

Recommends unseen vault content for a cohort, defined either by a seed content_id (whoever buys it) or by the audience-filter querystring (the same shape the broadcast composer uses), excluding content already sent to that cohort. 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

Query Parameters

content_id?|

Seed content whose buyers define the cohort.

source?|

Audience filter: traffic source.

country?|

Audience filter: ISO country.

rfm_tag?|

Audience filter: RFM segment tag.

spend_min?|

Audience filter: minimum lifetime spend (cents).

spend_max?|

Audience filter: maximum lifetime spend (cents).

inactive_days?|

Audience filter: days since last activity.

bought_ppv?|

Audience filter: has bought a PPV.

new_vs_returning?|

Audience filter: new or returning.

is_trial?|

Audience filter: trial subscribers.

limit?integer

Maximum recommendations.

Range1 <= value <= 200
Default20

Response Body

application/json

application/json

GET
/api/admin/vault/recommend
curl -X GET "https://example.com/api/admin/vault/recommend"
{  "items": [    {      "media_id": "612",      "media_type": "video",      "has_cover": true    }  ],  "cohort_size": 184,  "thin_data": false}
{  "detail": "Not authenticated"}

Dormant content

Returns vault media with zero send activity in the last window_days (content that was neither sold nor sent). Requires a read-scoped key.

A folder as a content drop

Returns a folder packaged as a drop: items classified by role (video / photoset / BTS) plus the ordered bundle media_ids for one-tap selection of the whole drop. Requires a read-scoped key.