Skip to main content
GET
Audience composition breakdown API

Frequently asked questions

Company dimensions — 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.
Company dimensions group by normalized values, because raw source values are case-split — ‘United States’ and ‘united states’ would otherwise be two rows. Display uses the same vocabulary the filters accept, so a value you see here can be pasted straight back into a filter.
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.
Because summing per-technology counts double-counts domains running more than one tool in a category. by=category computes distinct domains per category server-side, which is the number you actually want.
Yes — the same inline firmographic parameters work here, so “the industry breakdown of the US slice of my list” is a single request.

Authorizations

Authorization
string
header
required

API key in format tapi_live_[32-char] (live) or tapi_test_[32-char] (test)

Path Parameters

id
string
required

The audience id.

Example:

"seg_8f3a2c1b"

Query Parameters

by
enum<string>
required

The dimension to group by.

Available options:
country,
industry,
employees,
company_type,
language,
web_country,
category
Example:

"country"

country
string

Filter to companies in this country (case-insensitive).

city
string

Filter to companies in this city (case-insensitive).

state
string

Filter to companies in this state or region (case-insensitive).

industry
string

Filter to companies in this industry (case-insensitive).

industry_code
integer

Filter by exact LinkedIn industry code.

employees
string

Filter by exact LinkedIn employee band. Unknown bands are rejected with INVALID_EMPLOYEE_BAND and the allowed list.

company_type
string

Filter by exact company type.

founded_min
integer

Only companies founded in or after this year.

Required range: 1800 <= x <= 2025
founded_max
integer

Only companies founded in or before this year.

Required range: 1800 <= x <= 2025
has_email
boolean

Filter to domains where the crawler found (or did not find) an email address. false is a real filter, not a no-op.

has_phone
boolean

Filter to domains where the crawler found (or did not find) a phone number.

social
enum<string>

Filter to domains publishing a profile on this platform.

Available options:
linkedin,
x,
facebook,
instagram,
youtube,
github,
tiktok,
discord,
reddit,
crunchbase,
slack
language
string

Filter by the site's primary language.

web_country
string

Filter by the country the site declares in its schema.org markup. Accepts ISO-2, English name or common variants.

Response

Member counts and shares per dimension value, top 50

success
boolean
Example:

true

data
object