tebarDocs
GuidePlatformsDevelopersAPI ReferenceChangelog
Insights

Get who an account reaches

GET
/v1/accounts/{id}/audience

Read from the platform once a day: { account_id, basis, countries, cities, ages, genders, reach, synced_at }. Each list holds { key, share } (0.25 is 25%), largest first: TikTok and YouTube give shares of all followers or viewers; Instagram and Threads report their top 45 values at most, and the shares are of those. A list the platform could not give on a day keeps the last one read. basis followers (Instagram, Threads, TikTok: the account's followers; at least 100 followers) or viewers (YouTube: who watched in the last 90 days); null with no data yet. countries are ISO 3166-1 alpha-2 codes, genders female, male, other, unknown. reach (Instagram): accounts reached in the last 30 days that follow the account and that do not, else null.

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 audience, or empty lists before the first read.

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