Get how a Person speaks

Breaks the Person’s podcast lines down by speaker statement characteristic, 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. Each bucket names its strongest lines for every outer label, with the episode and a link that plays the moment. A line counts when its speaker is settled as the Person, in any role; lines too short to read carry no characteristics. The parameter accepts the Person slug (recommended) or the encoded Person UUID. To find their lines said a certain way about a topic, use GET /v1/podcasts/episodes/search with speaker and speaker_statement_characteristics.

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

cURL

cURL

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

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>",
  "end": "<string>",
  "episodes": 123,
  "interval": "week",
  "person": {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "image_url": "<string>",
    "slug": "<string>"
  },
  "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

Person identifier. Accepts the Person slug (recommended) or the encoded Person UUID.

Query Parameters

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: 1

How many of each bucket's strongest lines to return per outer label (0 for counts only).

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.

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

person · object · required

The person whose lines are counted.

Show child attributes

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.