Get who an account reaches
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.
bearerAuthorizationBearer <token>An API key (tb_live_...) from the dashboard, or an OAuth access token.
id*stringuuidTebar-Profile?stringLimits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.
The audience, or empty lists before the first read.
curl -X GET 'https://api.tebar.app/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/audience'Best times to post on an account GET
When the account's own posts of the last 90 days did best, in 2-hour blocks and by weekday of tz (Asia/Jakarta by default): each block's score is the median outlier multiplier of its posts (1.0 is the account's usual), null with fewer than 5 posts there. TikTok adds the followers' activity per block (audience_share). recommended: up to 3 blocks, best first. A correlation from the account's own posts, not a promise. Requires the read scope.
List posts on an account GET
A page at a time, newest first, with the full text: { account_id, source, data, next_cursor }. Requires the read scope.