Search podcast dialogue for entity mentions

Search podcast dialogue for entity mentions. Returns every line of dialogue that mentions a person or company, grouped by episode and ordered by recency.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://api.particle.pro/v1/podcasts/mentions

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "language": "fr",
    "since": "2024-01-01",
    "until": "2024-06-01"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "company_id": {
              "description": "Company slug, domain, or ID. Required when entity_id is not set. Resolves to the company's linked entity; a company with no linked entity falls back to name matching (matched_by=name).",
              "type": "string"
            },
            "context_lines": {
              "description": "Surrounding dialogue lines around each mention.",
              "format": "int64",
              "type": "integer"
            },
            "cursor": {
              "description": "Opaque cursor from a previous response.",
              "type": "string"
            },
            "entity_id": {
              "description": "Entity slug (e.g., 'sam-altman') or ID. A person slug or ID resolves via the person's linked knowledge graph entity; a person with no linked entity falls back to name matching (matched_by=name). Required when company_id is not set.",
              "type": "string"
            },
            "episode_id": {
              "description": "Restrict to mentions inside one episode by slug or ID (cross-corpus result still surfaces a single episode group).",
              "type": "string"
            },
            "include_ads": {
              "description": "Mentions inside ad reads (sponsor ad segments, or lines spoken by an advertiser) are excluded by default. Pass true to include them.",
              "type": "boolean"
            },
            "language": {
              "description": "Restrict to episodes of podcasts in this language (ISO 639-1 code, e.g. 'fr'). Matches the podcast's primary language subtag, so 'fr' covers 'fr-FR'.",
              "type": "string"
            },
            "limit": {
              "description": "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.",
              "format": "int64",
              "type": "integer"
            },
            "podcast_id": {
              "description": "Restrict to mentions inside one podcast.",
              "type": "string"
            },
            "publisher_id": {
              "description": "Restrict to mentions on podcasts attributed to one publisher (network), by slug or ID.",
              "type": "string"
            },
            "role": {
              "description": "Constrain how the entity participates: guest, host, panelist, correspondent, or mention.",
              "enum": [
                "guest",
                "host",
                "panelist",
                "correspondent",
                "mention"
              ],
              "type": "string"
            },
            "since": {
              "description": "Only episodes published after this date.",
              "type": "string"
            },
            "sort": {
              "description": "Result ordering. recency (the default) returns the most recently published episodes first. popularity orders by the parent podcast's global popularity percentile \u2014 the biggest shows first, recency breaking ties within a show, non-charting podcasts last. favorites keeps the recency ordering but lifts the calling user's favorited shows to the top of each publication day; it requires an authenticated user session (401 for an API key or anonymous token) and falls back to plain recency for a user with no favorited podcasts. Pass the same sort alongside a cursor when paginating.",
              "enum": [
                "recency",
                "popularity",
                "favorites"
              ],
              "type": "string"
            },
            "until": {
              "description": "Only episodes published before this date.",
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON