curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/mentions/share-of-voice?by=occupation&level=major&speakers=all&limit=10"{
"attributed_mentions": 123,
"by": "occupation",
"end": "<string>",
"groups": [
{
"code": "<string>",
"episodes": 123,
"mentions": 123,
"share": 123,
"speakers": 123,
"title": "<string>",
"buckets": [
{
"mentions": 123,
"start": "<string>"
}
]
}
],
"level": "major",
"mentions": 123,
"start": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
},
"entity": {
"id": "<string>",
"name": "<string>",
"slug": "<string>",
"company": {
"id": "<string>",
"domain": "<string>",
"ticker": "<string>"
},
"description": "<string>",
"image_url": "<string>",
"person": {
"id": "<string>",
"company": "<string>",
"image_url": "<string>",
"title": "<string>"
},
"type": {
"name": "<string>",
"slug": "<string>"
},
"wikipedia_url": "<string>"
}
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Get mention share of voice
Splits the podcast lines mentioning an entity by the occupations or fields of the people who said them: what share of what is said about it comes from, say, journalists or economists. A line counts when its speaker is linked to a person with an expertise reading and, for a guest, the appearance read does not doubt it is them; a person counts under every code listed for them, so shares can sum past 1. Ad reads are excluded unless include_ads. The window defaults to the last 30 days and may span 365; interval adds each group’s mentions per bucket. Requires entity_id or company_id. For the mentions themselves, use GET /v1/podcasts/mentions; for their counts over time, GET /v1/podcasts/mentions/timeseries.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/mentions/share-of-voice?by=occupation&level=major&speakers=all&limit=10"{
"attributed_mentions": 123,
"by": "occupation",
"end": "<string>",
"groups": [
{
"code": "<string>",
"episodes": 123,
"mentions": 123,
"share": 123,
"speakers": 123,
"title": "<string>",
"buckets": [
{
"mentions": 123,
"start": "<string>"
}
]
}
],
"level": "major",
"mentions": 123,
"start": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
},
"entity": {
"id": "<string>",
"name": "<string>",
"slug": "<string>",
"company": {
"id": "<string>",
"domain": "<string>",
"ticker": "<string>"
},
"description": "<string>",
"image_url": "<string>",
"person": {
"id": "<string>",
"company": "<string>",
"image_url": "<string>",
"title": "<string>"
},
"type": {
"name": "<string>",
"slug": "<string>"
},
"wikipedia_url": "<string>"
}
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
Entity slug (e.g., 'sam-altman') or ID. Required when company_id is not set.
Company slug, domain, or ID. Required when entity_id is not set. Resolves to the company's linked entity.
Group the speakers by SOC 2018 occupation or ANZSRC 2020 field of research.
occupation, field SOC major groups or detailed occupations; ANZSRC divisions or groups.
major, detailed Attribute every speaker's lines, hosts included, or guests' and panelists' only.
all, guests Restrict to mentions inside one podcast.
Restrict to mentions on podcasts attributed to one publisher (network), by slug or ID.
Mentions inside ad reads are excluded by default. Pass true to include them.
Only episodes published on or after this date. Defaults to 30 days before published_before; the window may span at most 365 days.
"2026-09-01"
Only episodes published on or before this date. Defaults to now.
"2026-10-01"
Add each group's mentions per bucket of this width.
day, week, month Groups to return, most mentioned first.
1 <= x <= 50Response
OK
Of those, the lines spoken by someone with an expertise reading (and, for a guest, whose appearance read does not doubt it is them). Shares are of these.
What the groups are: SOC 2018 occupations or ANZSRC 2020 fields of research.
occupation, field Day the window ends (UTC), excluded: the window is [start, end), so a published_before date shows as the day after it.
The groups with the most attributed mentions, most first. A person listed under several codes counts in each, so shares can sum past 1.
Show child attributes
Show child attributes
The groups' level: SOC major groups or detailed occupations; ANZSRC divisions or groups.
major, detailed Lines mentioning the entity in the window, from every speaker. Ad reads are left out unless include_ads.
First day of the window (UTC), included.
The company the entity was resolved from, when company_id was given.
Show child attributes
Show child attributes
The entity whose mentions are split.
Show child attributes
Show child attributes
Was this page helpful?