# AdReads

AdReads is a searchable library of public podcast sponsor ad reads. It helps media buyers, operators, and competitive research teams inspect real sponsor mentions by brand, podcast, episode, promo code, offer, landing page, placement, timestamp, transcript snippet, and audio clip.

## Primary URLs

- Home and search: https://www.adreads.ai/
- Campaigns: https://www.adreads.ai/campaigns
- Reports: https://www.adreads.ai/reports
- Competitor reports: https://www.adreads.ai/reports/competitors
- Weekly advertiser reports: https://www.adreads.ai/reports/weekly
- Promo codes: https://www.adreads.ai/promo-codes
- Sponsors: https://www.adreads.ai/sponsors
- Categories: https://www.adreads.ai/categories
- Podcasts: https://www.adreads.ai/podcasts
- About: https://www.adreads.ai/about
- Sitemap: https://www.adreads.ai/sitemap.xml

## Agent Preview API

- Search endpoint: https://www.adreads.ai/api/v1/reads
- OpenAPI description: https://www.adreads.ai/openapi.json
- API catalog: https://www.adreads.ai/.well-known/api-catalog
- Example: https://www.adreads.ai/api/v1/reads?q=athletic&date=30&placement=MID_ROLL
- Supported filters include `q`, `sponsor`, `podcast`, `date`, `placement`, `sponsorCategory`, `podcastCategory`, `readType`, `offerType`, promo-code or landing-URL presence, duration, Apple rank, and sort order.
- The anonymous endpoint returns at most 10 concise results. It intentionally does not support pagination, cursors, bulk export, or full transcripts.
- Use each result's `canonicalUrl` for the public AdReads detail page and `episode.sourceUrl` to verify the source episode when available.
- When inputs support it, `estimatedCurrentPlacementValue` gives a wide, low-confidence USD range for a comparable single-episode placement today. It is not reported advertiser spend or a historical invoice; use its `methodologyUrl` for assumptions and limitations.

## Public Data Notes

- Public sponsor pages use `/sponsors/{slug}`.
- Public promo-code intelligence pages use `/promo-codes/{sponsor-slug}` and verify when a code was heard in a podcast ad, not whether it redeems at checkout.
- Public category pages use `/categories/{slug}`.
- Public podcast pages use `/podcasts/{slug}`.
- Public competitor comparisons use `/reports/competitors/{advertiser-a}-vs-{advertiser-b}` and summarize the latest complete rolling 30-day UTC window.
- Public ad-read detail pages use canonical `/promos/{read-slug}--{id}` URLs.
- Weekly reports rank activity detected in the AdReads dataset; they do not estimate advertiser spend or total market share.
- The Agent Preview API above is the only API intended as a public research source. Account, admin, auth, upgrade, internal API, and legacy redirect routes are not public research sources.
- Ad-read text is auto-transcribed and lightly cleaned, so verify important claims against the linked source episode when available.

## Contact

For product questions, data corrections, partnerships, account help, or takedown requests, contact hello@quicklets.ai.