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.

GET /v1/companies/{id}/statement-characteristics

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/companies/{id}/statement-characteristics?current_only=true&interval=month&examples=0"

200

{
  "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
}

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id · string · required

Company slug (e.g., 'apple'), domain (e.g., 'apple.com'), or ID

Query Parameters

current_only · boolean · default: true

When true (default), only the people currently in a role at the company count. Set false to include people in past roles there.

since · string

Only lines published on or after this date. Defaults to a year before until.

Example:

"2026-01-01"

until · string

Only lines published on or before this date. Defaults to now.

Example:

"2026-06-30"

interval · enum<string> · default: month

Bucket width. Weeks start on Monday (UTC).

Available options: week, month

examples · integer<int64> · default: 0

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.

Required range: 0 <= x <= 3

Response

200

application/json

OK

buckets · object[] | null · required

Contiguous zero-filled buckets in ascending order.

Show child attributes

characteristics · object · required

The window's scored lines by their label on each axis.

Show child attributes

characteristics_version · string · required

Opaque version of the speaker statement characteristics counted. Compare breakdowns only when it is equal.

company · object · required

The company whose people's lines are counted.

Show child attributes

current_only · boolean · required

Whether only the people in a current role at the company are counted.

end · string · required

UTC date of the window's exclusive upper bound.

episodes · integer<int64> · required

Distinct episodes those lines were said in.

interval · enum<string> · required

Bucket width.

Available options: week, month

people · integer<int64> · required

Of the company's people, how many said scored lines in the window.

scored_lines · integer<int64> · required

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 · string · required

Start of the first bucket as a UTC date.

low_sample · boolean

Fewer than 20 scored lines stand behind the shares. Read them as examples, not as a distribution.