Skip to content
Listener.comDevelopers

Sponsors

Sponsor matching, network bundle opportunities and sponsorship packages.

Match sponsors

GET/v1/sponsors/matches
sponsors:read

Rank the brands this workspace already knows (campaign brands, invites, network sponsors, cluster sponsor tags, show collaborations) by fit for a show, an episode or a free-text brief, with the reason and proof points for each. Send at least one of show_id, episode_id (with show_id) or brief. Contact emails are never returned.

SDKlistener.sponsors.matches()client.sponsors.matches()

Query parameters

  • show_idstringnullable
    A show id in this workspace (see GET /v1/shows).
  • episode_idstringnullable
    Episode id (see GET /v1/shows/{show_id}/episodes).
  • briefstringnullable
  • limitinteger1 to 10
    Maximum number of items to return.

    Default 5

Returns

200

OK

  • objectstringrequired
  • urlstringrequired
  • dataarray of objectsrequired
    Show child attributesHide child attributes
  • has_morebooleanrequired
  • next_cursorstringrequirednullable
    Pass as cursor to get the next page; null on the last page.
  • metaobjectrequired
    The result's non-list fields (window, coverage, freshness, totals, note …).
    Show child attributesHide child attributes

Errors

400parameter_invalid401credential_invalid403scope_missing404resource_not_found429rate_limited500internal_error

Network bundle opportunities

GET/v1/sponsors/opportunities
sponsors:read

Pairs of the workspace's shows worth bundling for a sponsor: shared categories, collaboration history, shared hosts and, with include_reach=true, their combined cluster reach and a score. Reach is skipped automatically on very large networks (meta.reach_aware=false).

SDKlistener.sponsors.opportunities()client.sponsors.opportunities()

Query parameters

  • limitinteger1 to 30
    Maximum number of items to return.

    Default 6

  • include_reachboolean

    Default true

  • include_empty_showsboolean

    Default false

Returns

200

OK

  • objectstringrequired
  • urlstringrequired
  • dataarray of objectsrequired
    Show child attributesHide child attributes
  • has_morebooleanrequired
  • next_cursorstringrequirednullable
    Pass as cursor to get the next page; null on the last page.
  • metaobjectrequired
    The result's non-list fields (window, coverage, freshness, totals, note …).
    Show child attributesHide child attributes

Errors

400parameter_invalid401credential_invalid403scope_missing404resource_not_found429rate_limited500internal_error

List sponsorship packages

GET/v1/shows/{show_id}/sponsorship-packages
sponsors:read

A show's sponsorship packages (rate card) with each deliverable's projected reach from recent content: average listens per audio read, views per video integration or social clip, opens per newsletter placement. window (30, 90 or 365 days) overrides each package's trailing window; averages built from measured content are marked verified.

SDKlistener.shows.sponsorshipPackages.list()client.shows.sponsorship_packages.list()

Path parameters

  • show_idstringrequired
    A show id in this workspace (see GET /v1/shows).

Query parameters

  • windowintegernullable
    Reporting window.
    One of3090365

Returns

200

OK

  • objectstringrequired
  • urlstringrequired
  • dataarray of objectsrequired
    Show child attributesHide child attributes
  • has_morebooleanrequired
  • next_cursorstringrequirednullable
    Pass as cursor to get the next page; null on the last page.
  • metaobjectrequired
    The result's non-list fields (window, coverage, freshness, totals, note …).
    Show child attributesHide child attributes

Errors

400parameter_invalid401credential_invalid403scope_missing404resource_not_found429rate_limited500internal_error