Skip to main content
GET
/
v1
/
podcasts
/
mentions
Search podcast dialogue for entity mentions
curl --request GET \
  --url https://api.particle.pro/v1/podcasts/mentions \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "episode": {
        "id": "<string>",
        "title": "<string>",
        "podcast": {
          "id": "<string>",
          "title": "<string>",
          "image_url": "<string>",
          "slug": "<string>"
        },
        "published_at": "2023-11-07T05:31:56Z"
      },
      "mention_count": 123,
      "mention_variants": [
        "<string>"
      ],
      "windows": [
        {
          "end_seconds": 123,
          "lines": [
            {
              "end_seconds": 123,
              "number": 123,
              "speaker": "<string>",
              "start_seconds": 123,
              "text": "<string>",
              "is_match": true,
              "is_mention": true,
              "role": "<string>"
            }
          ],
          "start_seconds": 123,
          "segment": {
            "id": "<string>",
            "title": "<string>",
            "type": "<string>"
          }
        }
      ],
      "truncated": true
    }
  ],
  "has_more": true,
  "cursor": "<string>",
  "entity": {
    "id": "<string>",
    "name": "<string>",
    "slug": "<string>",
    "company": {
      "id": "<string>",
      "domain": "<string>",
      "ticker": "<string>"
    },
    "description": "<string>",
    "person": {
      "id": "<string>",
      "company": "<string>",
      "image_url": "<string>",
      "title": "<string>"
    },
    "wikipedia_url": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.particle.pro/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-Key
string
header
required

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

Query Parameters

entity_id
string

Entity slug (e.g., 'sam-altman') or ID. Required when company_id is not set.

company_id
string

Company slug, domain, or ID. Required when entity_id is not set. Resolves to the company's linked entity.

podcast_id
string

Restrict to mentions inside one podcast.

episode_id
string

Restrict to mentions inside one episode (cross-corpus result still surfaces a single episode group).

role
enum<string>

Constrain how the entity participates: guest, host, panelist, correspondent, or mention.

Available options:
guest,
host,
panelist,
correspondent,
mention
since
string

Only episodes published after this date.

Example:

"2024-01-01"

until
string

Only episodes published before this date.

Example:

"2024-06-01"

context_lines
integer<int64>
default:2

Surrounding dialogue lines around each mention.

Required range: 0 <= x <= 20
limit
integer<int64>
default:25

Episodes per page (1-100, default 25). Each episode's full set of mention windows is returned in a single page; episodes never split across pages.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from a previous response.

Response

OK

data
object[] | null
required

Episodes on this page, ordered by recency (default) or salience

has_more
boolean
required

More episodes available

cursor
string

Opaque cursor; pass back as ?cursor= for the next page

entity
object

Resolved entity. Omitted on empty pages where neither entity_id nor company_id resolved.