Get the audience
Each account's audience as last read: its followers, and the people who engaged with its content this month, by age, gender, country and city (YouTube without city), and when its followers are active, by the hour in UTC (activeHours), from TikTok, for accounts with advanced access or a verified business account, and 100 followers or more. Rizamo reads it once a week for Instagram, TikTok, Threads and YouTube accounts (Instagram through either login). Followers come only for accounts with 100 followers or more. Instagram gives the engaged audience only when each group has more than 100 people; TikTok and Threads give none; YouTube gives no followers (followers is null). A YouTube channel's engaged audience is its viewers this month (last month until the 8th, as YouTube's numbers come 2 to 3 days late), counted by their views. Facebook no longer gives a Page's audience, and other networks are not read yet: their accounts come with why.
apiKeyAuthorizationBearer <token>An API key from the web app, under Developers. It starts with rz_live_.
profileId?stringOnly this profile's (prof_): one brand or client, from List profiles.
length <= 100accountId?stringOnly this account (acc_).
length <= 100OK
application/json- response
accounts*array<>Every account in reach, with its latest audience or why it has none.
curl -X GET 'https://api.rizamo.com/v1/analytics/audience?profileId=prof_01m40k9k80fxd8cvng8derm7g9'{ "accounts": [ { "accountId": "acc_01m423bp00fz39kp5pc7m42tsw", "profileId": "prof_01m40k9k80fxd8cvng8derm7g9", "network": "instagram", "day": "2026-11-02", "readAt": "2026-11-02T06:10:00.000Z", "followers": { "age": [ { "value": "25-34", "count": 4120 }, { "value": "35-44", "count": 2680 }, { "value": "18-24", "count": 1970 } ], "gender": [ { "value": "female", "count": 5900 }, { "value": "male", "count": 3810 }, { "value": "unknown", "count": 120 } ], "country": [ { "value": "PT", "count": 8020 }, { "value": "BR", "count": 710 }, { "value": "ES", "count": 380 } ], "city": [ { "value": "Lisbon, Lisbon District", "count": 5160 }, { "value": "Porto, Porto District", "count": 880 } ] }, "followersGap": null, "engaged": { "age": [ { "value": "25-34", "count": 412 }, { "value": "35-44", "count": 268 }, { "value": "18-24", "count": 197 } ], "gender": [ { "value": "female", "count": 590 }, { "value": "male", "count": 381 }, { "value": "unknown", "count": 12 } ], "country": [ { "value": "PT", "count": 802 }, { "value": "BR", "count": 71 }, { "value": "ES", "count": 38 } ], "city": [ { "value": "Lisbon, Lisbon District", "count": 516 }, { "value": "Porto, Porto District", "count": 88 } ] }, "engagedGap": null, "activeHours": null, "activeHoursGap": "Rizamo does not read when this network's followers are active yet." }, { "accountId": "acc_01m43kdrr0ebxa6wpz9f3zmaqa", "profileId": "prof_01m40k9k80fxd8cvng8derm7g9", "network": "tiktok", "day": "2026-11-02", "readAt": "2026-11-02T10:04:00.000Z", "followers": { "age": [ { "value": "25-34", "count": 2060 }, { "value": "35-44", "count": 1340 }, { "value": "18-24", "count": 985 } ], "gender": [ { "value": "female", "count": 2950 }, { "value": "male", "count": 1905 }, { "value": "unknown", "count": 60 } ], "country": [ { "value": "PT", "count": 4010 }, { "value": "BR", "count": 355 }, { "value": "ES", "count": 190 } ], "city": [ { "value": "Lisbon, Lisbon District", "count": 2580 }, { "value": "Porto, Porto District", "count": 440 } ] }, "followersGap": null, "engaged": null, "engagedGap": "TikTok gives no breakdown of the accounts that engaged.", "activeHours": { "day": "2026-10-31", "hours": [ { "hour": 0, "followers": 60 }, { "hour": 1, "followers": 40 }, { "hour": 2, "followers": 30 }, { "hour": 3, "followers": 20 }, { "hour": 4, "followers": 20 }, { "hour": 5, "followers": 30 }, { "hour": 6, "followers": 60 }, { "hour": 7, "followers": 110 }, { "hour": 8, "followers": 180 }, { "hour": 9, "followers": 240 }, { "hour": 10, "followers": 270 }, { "hour": 11, "followers": 290 }, { "hour": 12, "followers": 330 }, { "hour": 13, "followers": 310 }, { "hour": 14, "followers": 290 }, { "hour": 15, "followers": 300 }, { "hour": 16, "followers": 340 }, { "hour": 17, "followers": 410 }, { "hour": 18, "followers": 520 }, { "hour": 19, "followers": 610 }, { "hour": 20, "followers": 660 }, { "hour": 21, "followers": 580 }, { "hour": 22, "followers": 370 }, { "hour": 23, "followers": 150 } ] }, "activeHoursGap": null } ]}List how each post did GET
Every post published in the period on the team's accounts, made in Rizamo or anywhere else, deleted ones included, with its numbers so far: its lifetime totals as Rizamo last read them, every one its network gives in `metrics`, and its `details` (rates, traffic sources, viewer types, retention, viewers) where its network gives them. Sorted by views unless asked otherwise, a page at a time. Days are the profile's, and a period of `days` ends yesterday, as in Analytics overview.
Get plan and usage GET
Billed per connected account, the first 2 free. Only keys and people that reach every profile see it, since the plan counts every profile's accounts.