curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/companies/{id}/statement-characteristics?current_only=true&interval=month&examples=0"{
"buckets": [
{
"characteristics": {
"certainty": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"sentiment": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"specificity": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"temporal_orientation": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
]
},
"episodes": 123,
"scored_lines": 123,
"start": "<string>",
"examples": [
{
"characteristic": "sentiment",
"episode": {
"id": "<string>",
"title": "<string>",
"podcast": {
"id": "<string>",
"title": "<string>",
"best_rank": {
"captured_at": "2023-11-07T05:31:56Z",
"chart_type": "top_podcasts",
"rank": 123,
"source": "apple",
"category_slug": "<string>",
"country": "<string>"
},
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>",
"web_url": "<string>"
},
"label": "<string>",
"start_offset_seconds": 123,
"text": "<string>",
"speaker": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"image_url": "<string>",
"slug": "<string>"
},
"speaker_statement_characteristics": {
"certainty": "hedged",
"sentiment": "negative",
"specificity": "vague",
"temporal_orientation": "past"
},
"url": "<string>"
}
],
"low_sample": true,
"partial": true,
"people": 123
}
],
"characteristics": {
"certainty": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"sentiment": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"specificity": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"temporal_orientation": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
]
},
"characteristics_version": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
},
"current_only": true,
"end": "<string>",
"episodes": 123,
"interval": "week",
"people": 123,
"scored_lines": 123,
"start": "<string>",
"low_sample": true
}{
"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 how a company's people speak
Breaks the podcast lines of a company’s people down by speaker statement characteristic, together, per week or month bucket and over the window (the last year by default): how many of their scored lines are negative, neutral or positive; hedged, neutral or confident; vague, neutral or specific; and about the past, present or future, each as a share, with how many of the people said them. With examples (none by default, since for the largest companies they take about twice as long as the counts), each bucket names its strongest lines for every outer label, with who said them, the episode and a link that plays the moment. The people are the ones GET /v1/companies//people lists: those in a current role by default, past roles too with current_only=false. Identify the company by slug (e.g., ‘apple’), domain, or ID. For one person, use GET /v1/people//statement-characteristics.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/companies/{id}/statement-characteristics?current_only=true&interval=month&examples=0"{
"buckets": [
{
"characteristics": {
"certainty": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"sentiment": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"specificity": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"temporal_orientation": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
]
},
"episodes": 123,
"scored_lines": 123,
"start": "<string>",
"examples": [
{
"characteristic": "sentiment",
"episode": {
"id": "<string>",
"title": "<string>",
"podcast": {
"id": "<string>",
"title": "<string>",
"best_rank": {
"captured_at": "2023-11-07T05:31:56Z",
"chart_type": "top_podcasts",
"rank": 123,
"source": "apple",
"category_slug": "<string>",
"country": "<string>"
},
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>",
"web_url": "<string>"
},
"label": "<string>",
"start_offset_seconds": 123,
"text": "<string>",
"speaker": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"image_url": "<string>",
"slug": "<string>"
},
"speaker_statement_characteristics": {
"certainty": "hedged",
"sentiment": "negative",
"specificity": "vague",
"temporal_orientation": "past"
},
"url": "<string>"
}
],
"low_sample": true,
"partial": true,
"people": 123
}
],
"characteristics": {
"certainty": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"sentiment": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"specificity": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
],
"temporal_orientation": [
{
"label": "<string>",
"lines": 123,
"share": 123
}
]
},
"characteristics_version": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
},
"current_only": true,
"end": "<string>",
"episodes": 123,
"interval": "week",
"people": 123,
"scored_lines": 123,
"start": "<string>",
"low_sample": true
}{
"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).
Path Parameters
Company slug (e.g., 'apple'), domain (e.g., 'apple.com'), or ID
Query Parameters
When true (default), only the people currently in a role at the company count. Set false to include people in past roles there.
Only lines published on or after this date. Defaults to a year before until.
"2026-01-01"
Only lines published on or before this date. Defaults to now.
"2026-06-30"
Bucket width. Weeks start on Monday (UTC).
week, month How many of each bucket's strongest lines to return per outer label, with who said them. None by default: for the largest companies they take about twice as long as the counts.
0 <= x <= 3Response
OK
Contiguous zero-filled buckets in ascending order.
Show child attributes
Show child attributes
The window's scored lines by their label on each axis.
Show child attributes
Show child attributes
Opaque version of the speaker statement characteristics counted. Compare breakdowns only when it is equal.
The company whose people's lines are counted.
Show child attributes
Show child attributes
Whether only the people in a current role at the company are counted.
UTC date of the window's exclusive upper bound.
Distinct episodes those lines were said in.
Bucket width.
week, month Of the company's people, how many said scored lines in the window.
The lines in the window that carry speaker statement characteristics: every share is of these. A line is counted when its speaker is settled as the person, or for a company as one of its people; lines too short to read are never scored.
Start of the first bucket as a UTC date.
Fewer than 20 scored lines stand behind the shares. Read them as examples, not as a distribution.
Was this page helpful?