Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaLead GenAvailable now

Particle · Episode search

particle/podcasts/episodes/search

Find companies, people and contact details with Particle · Episode search from Alexandria through one Spiral API key. Use to find episodes that discussed something. This is the entry point: it returns ids the other podcast capabilities take. For every line about one person or company use podcasts/mentions instead. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.026189 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
roleone of
guest, host, panelist, correspondent, speaker, mention
—

How the entity must relate to the episode: a speaking role, speaker for any speaking role, or mention for being talked about.

sortone of
relevance, recency
—

relevance (default) or recency.

typeone of
INTRO, PERSONAL_BANTER, TOPIC_DISCUSSION, INTERVIEW, TRANSITION, AD, OUTRO
—

Only segments of this type.

limitnumber
1 to 100
25

Maximum records to return.

sincetext—

Only segments from episodes published after this date.

untiltext—

Only segments from episodes published on or before this date. A bare date covers the whole day.

cursortext—

Opaque cursor from a previous page. Omit for the first page; send the same filters with it.

contextnumber
1 to 15
1

Lines of surrounding dialogue around each matched line. Widen this instead of fetching the transcript.

languagetext—

ISO 639-1 language code, for example en or fr. Matches the primary subtag, so fr covers fr-CA.

entity_idtext—

Restrict to episodes featuring this entity, by slug or id. Ranking still comes from the search terms.

company_idtext—

Restrict to episodes featuring this company, by slug, domain or id.

episode_idtext—

Restrict to one episode, by slug or id.

podcast_idtext—

Restrict to one show, by slug, id or Apple collection id.

entity_typetext—

Restrict to episodes that mention any entity of this category slug (company, school, book). Not combinable with role.

keyword_matchone of
required, ranked
required

How unquoted keyword terms apply: required filters to segments containing every term (and constrains a hybrid query to their intersection); ranked lets them only boost.

keyword_searchtext—

Exact tokens or phrases to match in the transcript, ranked BM25. Use for tickers, drug names, product codes. Wrap a phrase in double quotes to require it contiguously.

semantic_searchtext—

What was talked about, in your own words. Paraphrase-tolerant, so it finds dialogue that means this without containing these exact words. Describe a topic, not a name: for a person or company use entity_id or podcasts/mentions.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "particle/podcasts/episodes/search",
    "input": {
      "semantic_search": "<semantic_search>"
    }
  }'

Frequently asked questions

How much does Particle · Episode search cost?

$0.026189 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Particle · Episode search through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "particle/podcasts/episodes/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use Particle · Episode search?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use Particle · Episode search?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.