Audience composition breakdown API
Group an audience along one dimension — country, industry, employees, company type, language, declared country, or technology category. Costs 1 credit.
Frequently asked questions
Which dimensions are available?
Which dimensions are available?
country, industry, employees, company_type. Website dimensions from the crawl — language, web_country. And category, which rolls the group’s technology stack up per category instead of profiling the companies.Why are values lowercase?
Why are values lowercase?
What is matched, and why is it lower than total?
What is matched, and why is it lower than total?
total is the audience size; matched is how many members have data on the dimension you asked for, and it is the denominator for share_of_matched. Company dimensions only cover members with a matched company record, which is roughly 23–30% of technology domains.Why does by=category exist when the technology report has categories?
Why does by=category exist when the technology report has categories?
by=category computes distinct domains per category server-side, which is the number you actually want.Can I combine a breakdown with a filter?
Can I combine a breakdown with a filter?
Authorizations
API key in format tapi_live_[32-char] (live) or tapi_test_[32-char] (test)
Path Parameters
The audience id.
"seg_8f3a2c1b"
Query Parameters
The dimension to group by.
country, industry, employees, company_type, language, web_country, category "country"
Filter to companies in this country (case-insensitive).
Filter to companies in this city (case-insensitive).
Filter to companies in this state or region (case-insensitive).
Filter to companies in this industry (case-insensitive).
Filter by exact LinkedIn industry code.
Filter by exact LinkedIn employee band. Unknown bands are rejected with INVALID_EMPLOYEE_BAND and the allowed list.
Filter by exact company type.
Only companies founded in or after this year.
1800 <= x <= 2025Only companies founded in or before this year.
1800 <= x <= 2025Filter to domains where the crawler found (or did not find) an email address. false is a real filter, not a no-op.
Filter to domains where the crawler found (or did not find) a phone number.
Filter to domains publishing a profile on this platform.
linkedin, x, facebook, instagram, youtube, github, tiktok, discord, reddit, crunchbase, slack Filter by the site's primary language.
Filter by the country the site declares in its schema.org markup. Accepts ISO-2, English name or common variants.