---
title: "Get the audience"
method: GET
path: "/analytics/audience"
tags: ["Analytics"]
---

# Get the audience

`GET /analytics/audience`

## Request

- Base URL: `https://api.rizamo.com/v1`
- URL: `https://api.rizamo.com/v1/analytics/audience`
- Auth: HTTP bearer

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 (LinkedIn without age or gender, and by industry, job function, seniority and company size; 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, LinkedIn 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, Threads and LinkedIn 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.

## Query parameters

- `profileId` string: Only this profile's (`prof_`): one brand or client, from List profiles. A profile you do not reach is refused as not found.
- `accountId` string: Only this account (`acc_`).

## Response `200`

OK

- Audience
  - `accounts` AccountAudience[], required: Every account in reach, with its latest audience or why it has none.
    - `accountId` string, required
    - `profileId` string, required
    - `network` 'instagram' | 'facebook' | 'threads' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'pinterest' | 'google', required
    - `day` string, date, nullable, required: The network's day it was read on (Meta's and YouTube's run on Pacific time, TikTok's on UTC). Null when it never was.
    - `readAt` string, date-time, nullable, required
    - `followers` AudienceBreakdowns, nullable, required
      - `age` AudienceShare[], required
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `gender` AudienceShare[], required
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `country` AudienceShare[], required: The top 45, as the network gives them (LinkedIn its top 100).
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `city` AudienceShare[], required: The top 45, as the network gives them; on LinkedIn, its market areas, its top 100.
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `industry` AudienceShare[]: LinkedIn only: a Page's followers by industry, its top 100.
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `jobFunction` AudienceShare[]: LinkedIn only: a Page's followers by job function.
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `seniority` AudienceShare[]: LinkedIn only: a Page's followers by seniority.
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `companySize` AudienceShare[]: LinkedIn only: a Page's followers by the size of the company they work at.
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
    - `followersGap` string, nullable, required
    - `engaged` AudienceBreakdowns, nullable, required
      - `age` AudienceShare[], required
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `gender` AudienceShare[], required
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `country` AudienceShare[], required: The top 45, as the network gives them (LinkedIn its top 100).
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `city` AudienceShare[], required: The top 45, as the network gives them; on LinkedIn, its market areas, its top 100.
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `industry` AudienceShare[]: LinkedIn only: a Page's followers by industry, its top 100.
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `jobFunction` AudienceShare[]: LinkedIn only: a Page's followers by job function.
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `seniority` AudienceShare[]: LinkedIn only: a Page's followers by seniority.
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `companySize` AudienceShare[]: LinkedIn only: a Page's followers by the size of the company they work at.
        - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
        - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
        - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
    - `engagedGap` string, nullable, required
    - `activeHours` ActiveHours, nullable: The account's followers by the hour they are active, the best times to post as data, on the newest day the network gave: TikTok, for accounts with advanced access or a verified business account, and 100 followers or more. Read with the audience, once a week. Null where the network gives none, and `activeHoursGap` says why.
      - `day` string, date, required: The day the network counted them on: the newest it gave when Rizamo read the audience.
      - `hours` object[], required: From hour 0. An hour the network left out is missing.
        - `hour` integer, required: The hour, 0 to 23, in UTC: 13 is 13:00 to 14:00 UTC. Shift it into the profile's time zone to schedule.
        - `followers` integer, required: How many of the account's followers were active on the network in that hour.
    - `activeHoursGap` string, nullable: Why `activeHours` is null.

## Other responses

- `400`: `invalid_request`: A field is missing or wrong, or the request cannot be done as asked: the message names the field or says what to change.
- `401`: `unauthorized`: No API key or sign-in, or the key does not work: it was deleted, or it expired.
- `403`: `forbidden`: The caller may not do this: the key or agent lacks the scope (the message names it), or the action needs another role or a fresh sign-in.
- `404`: `not_found`: No such object, or it is outside your team or the profiles your key reaches.
- `429`: `rate_limited`: Over one of Rizamo's limits, or a network asked Rizamo to slow down: wait for `Retry-After` seconds, or as long as the message says.
- `500`: `internal`: Our side failed: retry, and send the `requestId` if it keeps failing.
- `503`: `timeout`: The request took too long to work out, most often a report: try again in a moment, or ask a report for a shorter period or one profile.

---

[API](https://skmtc.dev/rizamo/apis/rizamo-api.md) - [All operations](https://skmtc.dev/rizamo/apis/rizamo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rizamo/apis/rizamo-api/revisions/31b0c1b1ffb5?raw)
