particle_company_get_podcast_ad_presence

In the podcast_advertising category, which is opt-in — it is callable by name on any connection, but only advertised on tools/list when selected via ?include=podcast_advertising. See Tool sets & discovery.

Sponsor-side ad analytics for one company: total ads, distinct podcasts and episodes reached, host-read vs pre-recorded breakdown, and the most recent ad placements with podcast attribution. This is the “where does company X show up as a sponsor” view. For “who sponsors podcast Y” use particle_podcast_get_sponsors. For top advertisers across the catalog use particle_podcast_get_sponsor_leaderboard.

Inputs

Field	Type	Required	Default	Description
`company_slug`	string	yes	—	Company identifier — accepts slug (e.g. `"nvidia"`), domain (e.g. `"nvidia.com"`), or canonical ID. If you already know the domain you can call this tool directly without first running `particle_company_resolve`.
`include`	string[]	no	`[]`	Optional sections: `publishers` (top publishers carrying this company’s ads, aggregated across every sponsor alias — spots network-bundle buys), `podcasts` (ranked list of shows carrying the ads), `segments` (most recent actual ad-read segments with AI summaries, episode slugs, and playback offsets — what the ads literally said), `co_advertisers` (sponsor pairs most frequently sharing episodes with this company). The `podcasts` and `segments` sections are scoped to the company’s most-recently-active sponsor record, so multi-brand advertisers may not see every alias’s activity there.

Output

A markdown document with ## Ad presence for <company_id> and KV lines for **Total ads:**, **Podcast reach:** (distinct podcasts), **Episode reach:** (distinct episodes), **Read mix:** (host-read vs pre-recorded counts). When recent placements exist, a ### Recent placements section follows with bullets formatted Sponsor — Product on Podcast (podcast_slug) [HOST_READ|PRE_RECORDED]. When include=["publishers"] is set, a ### Top publishers section follows with bullets formatted Publisher Name (publisher_slug) — N ads on M of K podcasts (P% of catalog). include=["podcasts"] adds a ### Podcasts section (Title (podcast-slug) — N ads across M episodes, last YYYY-MM-DD), include=["segments"] a ### Recent ad reads section (bold segment title with read type, episode attribution and slug, playback offsets, and the AI summary on the following line), and include=["co_advertisers"] a ### Co-advertisers section (Sponsor A (slug) × Sponsor B (slug) — N shared episodes). For ad volume over time, see particle_podcast_get_ad_trends with mode=timeseries. Sample (company_slug="shopify"):

## Ad presence for shopify.com

**Total ads:** 11269
**Podcast reach:** 959
**Episode reach:** 9860
**Read mix:** 8205 host-read, 3064 pre-recorded
### Recent placements

- Shopify — Commerce platform for building online stores on The Ben Shapiro Show (the-ben-shapiro-show) [HOST_READ]
- Shopify — e-commerce platform on The Ben Shapiro Show (the-ben-shapiro-show) [HOST_READ]

Example

Agent calls: particle_company_get_podcast_ad_presence { "company_slug": "nvidia" }

# With publisher footprint
Agent calls: particle_company_get_podcast_ad_presence {
  "company_slug": "public.com",
  "include": ["publishers"]
}

REST equivalent: GET /v1/companies/{id}/podcast/advertising.
Inverse view: particle_podcast_get_sponsors.
Cross-catalog ranking: particle_podcast_get_sponsor_leaderboard.

Get started

Tools

particle_company_get_podcast_ad_presence

Inputs

Output

Example

​Inputs

​Output

​Example

​Related

Inputs

Output

Example

Related