tebarDocs
GuidePlatformsDevelopersAPI ReferenceChangelog
Insights

List the stories still up on an account

GET
/v1/accounts/{id}/stories

Instagram, read from the platform now (kept for a minute): { account_id, supported, insights, data }. data[] holds the stories of the last 24 hours, newest first: { id, media_type (image or video), media_url, thumbnail_url, permalink, posted_at, expires_at, metrics }. metrics: { views, reach, replies, shares, total_interactions, follows, profile_visits, navigation } so far, each null when Instagram gave none; metrics itself is null when insights is false (the account did not grant the statistics permission) or Instagram gave no numbers for the story (it withholds them under 5 viewers). URLs are signed platform CDN links that expire. supported false on platforms whose stories Tebar does not read (data is then empty). 422 account_plan_inactive for an account over the plan's account limit, 422 account_expired for one that needs reconnecting; neither calls Instagram.

Requires the read scope.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Path Parameters

id*string
Formatuuid

Header Parameters

Tebar-Profile?string

Limits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.

Response Body

The stories.

Example Request
curl -X GET 'https://api.tebar.app/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/stories'
Example Response
Empty