# Particle API

## Docs

- [Get a company](https://docs.particle.pro/api-reference/companies/get-a-company.md): Returns a single company by slug (e.g., 'apple'), domain (e.g., 'apple.com'), or ID.
- [Get company advertising profile](https://docs.particle.pro/api-reference/companies/get-company-advertising-profile.md): Returns advertising intelligence for a specific company across the podcast ecosystem, including reach metrics and recent ad placements. Identify the company by slug (e.g., 'apple'), domain, or ID.
- [List companies](https://docs.particle.pro/api-reference/companies/list-companies.md): Returns a paginated list of companies. Filter by entity slug (e.g., 'apple'), ticker, domain, CIK, or QID. Search by name or fetch updates since a timestamp.
- [List company competitors](https://docs.particle.pro/api-reference/companies/list-company-competitors.md): Returns a paginated list of competitors for a company, each wrapped with the competitive basis describing the relationship. Identify the company by slug (e.g., 'apple'), domain, or ID.
- [List company products](https://docs.particle.pro/api-reference/companies/list-company-products.md): Returns the product hierarchy for a company as a nested tree. Segments contain product lines, which contain individual products. Identify the company by slug (e.g., 'apple'), domain, or ID. Defaults to active products only.
- [Get clip embed](https://docs.particle.pro/api-reference/embed/get-clip-embed.md): Returns a minimal public representation of a clip for embed rendering.
- [Get clip embed transcript](https://docs.particle.pro/api-reference/embed/get-clip-embed-transcript.md): Returns the diarized transcript for a clip embed.
- [Get an entity](https://docs.particle.pro/api-reference/entities/get-an-entity.md): Returns a single knowledge graph entity by slug (e.g., 'sam-altman', 'apple') or ID.
- [List entities](https://docs.particle.pro/api-reference/entities/list-entities.md): Search and list knowledge graph entities (people, organizations, places) across all podcast content. Filter by podcast slug or ID.
- [Introduction](https://docs.particle.pro/api-reference/introduction.md): Particle API reference — base URL, authentication, and machine-readable specs.
- [Get a sponsor](https://docs.particle.pro/api-reference/podcast-advertising/get-a-sponsor.md): Returns a single advertising sponsor with activity metrics. The {id} path parameter accepts a sponsor ID, a company ID, a company domain, or a company slug.
- [Get advertising leaderboard](https://docs.particle.pro/api-reference/podcast-advertising/get-advertising-leaderboard.md): Returns the top podcast advertising sponsors ranked by the specified metric, with optional time range and company filtering.
- [Get sponsor co-occurrence](https://docs.particle.pro/api-reference/podcast-advertising/get-sponsor-co-occurrence.md): Returns pairs of sponsors that frequently appear together in the same podcast episodes.
- [List podcasts for a sponsor](https://docs.particle.pro/api-reference/podcast-advertising/list-podcasts-for-a-sponsor.md): Returns a paginated list of podcasts where the sponsor advertises, ordered by the number of episodes featuring the sponsor.
- [List sponsors](https://docs.particle.pro/api-reference/podcast-advertising/list-sponsors.md): Returns a paginated list of podcast advertising sponsors, optionally filtered by name search or company.
- [Get a clip](https://docs.particle.pro/api-reference/podcast-clips/get-a-clip.md): Returns a single clip by its unique identifier.
- [List clips](https://docs.particle.pro/api-reference/podcast-clips/list-clips.md): Returns AI-extracted highlight clips across podcast episodes, ranked by engagement potential. For text-based clip discovery (semantic, keyword, or entity mention search), use GET /v1/podcasts/search — matching clips are embedded inside each search result alongside the parent segment and dialogue.
- [List clips for an episode](https://docs.particle.pro/api-reference/podcast-clips/list-clips-for-an-episode.md): Returns the AI-extracted highlight clips for a specific episode, sorted by engagement score.
- [Get an episode](https://docs.particle.pro/api-reference/podcast-episodes/get-an-episode.md): Returns a single episode by its unique identifier.
- [List entities in an episode](https://docs.particle.pro/api-reference/podcast-episodes/list-entities-in-an-episode.md): Returns knowledge graph entities mentioned in a specific episode, with salience scores and occurrence counts.
- [List episodes](https://docs.particle.pro/api-reference/podcast-episodes/list-episodes.md): Returns a paginated list of podcast episodes across all podcasts. Filter by podcast slug or ID, entity slug or ID, company slug or domain, date range, and language.
- [List speakers in an episode](https://docs.particle.pro/api-reference/podcast-episodes/list-speakers-in-an-episode.md): Returns the identified speakers in a specific episode with their roles and speaking durations.
- [List topics for an episode](https://docs.particle.pro/api-reference/podcast-episodes/list-topics-for-an-episode.md): Returns the topic taxonomy classifications for a specific episode.
- [Search podcast dialogue for entity mentions](https://docs.particle.pro/api-reference/podcast-search/search-podcast-dialogue-for-entity-mentions.md): Returns every line of dialogue that mentions a person or company, grouped by episode and ordered by recency. Each result is one episode plus all of that episode's mention windows — a window is a contiguous range of dialogue containing the mention with `context_lines` of surrounding context, and line…
- [Search podcasts by content](https://docs.particle.pro/api-reference/podcast-search/search-podcasts-by-content.md): Search the podcast catalog by what is said in episodes — by meaning (`semantic_search`), by exact phrase (`keyword_search`), or both at once (hybrid). Each result is a segment of an episode, returned with bounded preview windows of dialogue and any highlight clips that overlap the segment.
- [Get a segment](https://docs.particle.pro/api-reference/podcast-segments/get-a-segment.md): Returns a single segment by its unique identifier.
- [List segments](https://docs.particle.pro/api-reference/podcast-segments/list-segments.md): Returns AI-identified segments across podcast episodes. Segments represent structural sections like topic discussions, interviews, ads, etc.
- [List segments for an episode](https://docs.particle.pro/api-reference/podcast-segments/list-segments-for-an-episode.md): Returns the AI-identified segments for a specific episode in chronological order.
- [Get clip transcript](https://docs.particle.pro/api-reference/podcast-transcripts/get-clip-transcript.md): Returns the diarized transcript for a specific clip.
- [Get entity mentions in transcript](https://docs.particle.pro/api-reference/podcast-transcripts/get-entity-mentions-in-transcript.md): Finds all mentions of a specific entity within an episode's transcript and returns each mention with surrounding dialogue context. Useful for seeing exactly where and how an entity is discussed.
- [Get episode transcript](https://docs.particle.pro/api-reference/podcast-transcripts/get-episode-transcript.md): Returns the diarized transcript for a podcast episode. Supports dialogue (speaker-attributed lines), plain text, and SRT subtitle formats. Optionally filter by speaker or time range.
- [Get segment transcript](https://docs.particle.pro/api-reference/podcast-transcripts/get-segment-transcript.md): Returns the diarized transcript for a specific segment.
- [Get word-level transcript](https://docs.particle.pro/api-reference/podcast-transcripts/get-word-level-transcript.md): Returns the word-level timestamped transcript for a podcast episode. Use start/end parameters to extract a time range for long episodes.
- [Get a podcast](https://docs.particle.pro/api-reference/podcasts/get-a-podcast.md): Returns a single podcast by slug (e.g., 'all-in') or ID. Slugs are human-readable identifiers included in every podcast response.
- [Get a podcast's latest bias analysis](https://docs.particle.pro/api-reference/podcasts/get-a-podcasts-latest-bias-analysis.md): Returns the most recent automated political bias analysis for a podcast, including the agent's reasoning, transcript evidence, web research evidence, and the sample episodes that informed the rating. Returns 404 when the podcast is not found or when it has not yet been analyzed.
- [Get podcast advertising profile](https://docs.particle.pro/api-reference/podcasts/get-podcast-advertising-profile.md): Returns advertising intelligence for a specific podcast, including aggregate stats, read type breakdown, and top sponsors. Identify the podcast by slug (e.g., 'all-in') or ID.
- [List entity mentions in a podcast](https://docs.particle.pro/api-reference/podcasts/list-entity-mentions-in-a-podcast.md): Returns episodes where a specific entity appears within a podcast, ordered by most recent. Each result includes the episode, salience score, occurrence count, and speaker roles. Requires entity_id or company_id.
- [List episodes for a podcast](https://docs.particle.pro/api-reference/podcasts/list-episodes-for-a-podcast.md): Returns a paginated list of episodes for a specific podcast, identified by slug (e.g., 'all-in') or ID.
- [List podcast topics](https://docs.particle.pro/api-reference/podcasts/list-podcast-topics.md): Returns the top-level topics covered across all podcasts, sorted by the number of podcasts covering each topic.
- [List podcasts](https://docs.particle.pro/api-reference/podcasts/list-podcasts.md): Returns a paginated list of podcasts, optionally filtered by text search, topic, or language.
- [Get a topic](https://docs.particle.pro/api-reference/topics/get-a-topic.md): Returns a single topic by its unique identifier, including ancestors and direct children.
- [List topics](https://docs.particle.pro/api-reference/topics/list-topics.md): Returns the hierarchical topic taxonomy. Use parent_id to navigate the tree.
- [Companies](https://docs.particle.pro/companies/overview.md): Cross-referenced company profiles with SEC, Wikidata, ticker, domain, and knowledge-graph identifiers.
- [Products](https://docs.particle.pro/companies/products.md): Three-level product hierarchies with lifecycle status.
- [Concepts](https://docs.particle.pro/concepts.md): Cross-cutting conventions: IDs, pagination, errors, pricing weight, and choosing the right endpoint.
- [Error reference](https://docs.particle.pro/errors/overview.md): Structured error responses and how to handle them
- [Particle API](https://docs.particle.pro/index.md): Inside every podcast: transcripts, speakers, entities, sponsors, and a knowledge graph that connects people and companies across episodes.
- [Entities](https://docs.particle.pro/knowledge-graph/entities.md): People, organizations, places, and concepts — the connective tissue across audio and structured data.
- [Topics](https://docs.particle.pro/knowledge-graph/topics.md): Hierarchical topic taxonomy used to classify episodes.
- [Advertising](https://docs.particle.pro/podcasts/advertising.md): Sponsor analytics across the podcast catalog: leaderboards, per-company presence, and co-occurrence.
- [Episodes](https://docs.particle.pro/podcasts/episodes.md): Discover and filter episodes across the catalog, with rich per-episode sub-resources.
- [Mentions](https://docs.particle.pro/podcasts/mentions.md): Every line of dialogue where a person or company is named, grouped by episode. The right endpoint for read-everything-about-X workflows.
- [Podcasts](https://docs.particle.pro/podcasts/overview.md): What's inside every episode — transcripts, speakers, segments, clips, sponsors, and bias.
- [Search](https://docs.particle.pro/podcasts/search.md): Search the podcast catalog by what is said in episodes — by meaning, by exact phrase, or both. For 'every line about a person or company', see Mentions.
- [Segments & clips](https://docs.particle.pro/podcasts/segments-and-clips.md): AI-identified structural sections of every episode and engagement-scored highlight clips.
- [Transcripts](https://docs.particle.pro/podcasts/transcripts.md): Diarized dialogue, word-level timestamps, entity mentions in context, and SRT export.
- [Quickstart](https://docs.particle.pro/quickstart.md): Trace one person across podcasts, dialogue, and companies in five minutes.

## OpenAPI Specs

- [openapi](https://docs.particle.pro/openapi.json)
- [openapi-full](https://docs.particle.pro/openapi-full.json)