Skip to main content
GET
/
v1
/
podcasts
/
search
cURL
curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/search?limit=25"
{
  "data": [
    {
      "episode": {
        "id": "<string>",
        "title": "<string>",
        "podcast": {
          "id": "<string>",
          "title": "<string>",
          "image_url": "<string>",
          "slug": "<string>"
        },
        "published_at": "2023-11-07T05:31:56Z",
        "slug": "<string>"
      },
      "match": {
        "source": "<string>",
        "relevance_score": 123
      },
      "segment": {
        "duration_seconds": 123,
        "end_seconds": 123,
        "id": "<string>",
        "number": 123,
        "start_seconds": 123,
        "title": "<string>",
        "type": "<string>",
        "audio_url": "<string>",
        "description": "<string>",
        "episode": {
          "id": "<string>",
          "title": "<string>",
          "podcast": {
            "id": "<string>",
            "title": "<string>",
            "image_url": "<string>",
            "slug": "<string>"
          },
          "published_at": "2023-11-07T05:31:56Z",
          "slug": "<string>"
        },
        "read_type": "<string>",
        "summary": "<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,
          "is_preview": true
        }
      ],
      "clips": [
        {
          "duration_seconds": 123,
          "end_seconds": 123,
          "engagement_score": 123,
          "id": "<string>",
          "start_seconds": 123,
          "title": "<string>",
          "audio_url": "<string>",
          "description": "<string>",
          "episode": {
            "id": "<string>",
            "title": "<string>",
            "podcast": {
              "id": "<string>",
              "title": "<string>",
              "image_url": "<string>",
              "slug": "<string>"
            },
            "published_at": "2023-11-07T05:31:56Z",
            "slug": "<string>"
          },
          "intro_statement": "<string>",
          "segment": {
            "id": "<string>",
            "title": "<string>",
            "type": "<string>"
          },
          "speaker": {
            "name": "<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>"
              },
              "type": {
                "name": "<string>",
                "slug": "<string>"
              },
              "wikipedia_url": "<string>"
            },
            "person": {
              "id": "<string>",
              "name": "<string>",
              "slug": "<string>",
              "verification_state": "<string>"
            },
            "person_link_kind": "<string>",
            "role": "<string>"
          }
        }
      ]
    }
  ],
  "has_more": true,
  "company": {
    "id": "<string>",
    "name": "<string>",
    "image_url": "<string>"
  },
  "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>"
    },
    "type": {
      "name": "<string>",
      "slug": "<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

​
semantic_search
string

Vector-similarity search by meaning. Express the query the way you'd describe the topic to a colleague — paraphrase tolerant, finds segments that express the same idea in different vocabulary. Combine with keyword_search for hybrid ranking.

Maximum string length: 500
​
keyword_search
string

BM25 lexical search over dialogue. Use when an exact token must appear verbatim — tickers, drug names, product codes. Wrap any token sequence in double quotes (e.g. "machine learning") to require an exact ordered phrase match. Multiple quoted phrases AND together (e.g. "central bank" "interest rates"); unquoted tokens still contribute to BM25 ranking.

Maximum string length: 500
​
entity_id
string

Optional entity slug or ID. Filters results to episodes featuring this entity. For 'every line about X', use /v1/podcasts/mentions instead.

​
entity_type
string

Optional entity category slug. Filters to episodes that mention any entity in that category (e.g. 'company', 'school', 'book'). Speakers are always people, so this filter only narrows mentioned entities. Cannot be combined with 'role'. Ignored when entity_id resolves to a specific entity. See GET /v1/entities/types for the available slugs.

​
company_id
string

Optional company slug, domain, or ID. Resolves to the company's linked entity and applies as a filter.

​
episode_id
string

Filter to a specific episode by slug or ID.

​
podcast_id
string

Podcast slug or ID.

​
type
enum<string>

Segment type filter.

Available options:
INTRO,
PERSONAL_BANTER,
TOPIC_DISCUSSION,
INTERVIEW,
TRANSITION,
AD,
OUTRO
​
role
enum<string>

Speaker/mention role filter on the entity_id / company_id filter.

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

Only segments from episodes published after this date.

Example:

"2024-01-01"

​
until
string

Only segments from episodes published before this date.

Example:

"2024-06-01"

​
sort
enum<string>

Sort order. Defaults to relevance.

Available options:
relevance,
recency
​
limit
integer<int64>
default:25

Results per page (1-100, default 25).

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

Opaque cursor from a previous response.

Response

OK

​
data
object[] | null
required

Matches on this page, ranked by relevance (default) or recency

​
has_more
boolean
required

More results available

​
company
object

Resolved company, when company_id filtered the result set. Omitted when only entity_id was provided.

​
cursor
string

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

​
entity
object

Resolved entity, when entity_id or company_id filtered the result set