Skip to main content

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.

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 advertising/get_podcast_sponsors. For top advertisers across the catalog use advertising/sponsor_leaderboard.

Inputs

FieldTypeRequiredDefaultDescription
company_slugstringyesCompany 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 resolve_company.

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]. 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]
- Shopify — Shopify commerce platform on The Ben Shapiro Show (the-ben-shapiro-show) [HOST_READ]

Example

Agent calls: advertising/get_company_ad_presence { "company_slug": "nvidia" }