List podcasts a company could advertise on next
Returns shows the company does NOT advertise on, ranked by how related they are to the shows it DOES — the buy-side prospect list. Each seed show counts by how much the company advertises there, so a list is anchored on its main venues; every show it has ever bought is excluded. Each row carries the podcast, a calibrated score in (0,1), a band (strong / moderate / weak), and with include=via the company's own shows that led there. Companies with no podcast advertising get an empty page.
Request
- Base URL: https://api.particle.pro
- URL: https://api.particle.pro/v1/companies/{id}/podcast/recommendations
- Auth: one of:
- API key in header X-API-Key
- HTTP bearer
Path parameters
Company identifier — slug, domain, or canonical ID
Query parameters
Results per page
Opaque pagination cursor from previous response
Optional response sections. Pass include=via to attach, for each recommendation, the company's own shows that led to it — the venues to cite when explaining why the recommendation fits.
Only recommendations at or above this score, applied within the 200 strongest recommendations the list holds. Omit (or 0) for every recommendation; the band field is the recommended way to filter by strength.
Only shows in this language (ISO 639-1 code, e.g. 'en', 'es'; a region suffix such as 'fr-CA' is reduced to the language), applied within the 200 strongest recommendations the list holds.
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.