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>"
},
"bias": "<string>",
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>",
"suitability_tier": "<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>"
},
"bias": "<string>",
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>",
"suitability_tier": "<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
Query Parameters
Response
OK
Was this page helpful?