Sponsorships
Return individual sponsored placements (content-level rows).
Provide at least one of sponsor_name, sponsor_id, sponsor_channel_id, brand_id, publication_url, or categories. These can be combined, except publication_url and categories cannot be used together.
Authorizations
Query Parameters
Deprecated: use sponsor_id.
Filter to placements from the sponsor with this identifier. Sponsor identifiers appear in the sponsor_id field of results.
Filter to placements attributed to this sponsor-owned social account, given as a channel_id from the sponsor channels endpoints. Combine with sponsor_id to intersect the two filters.
Deprecated. Same as sponsor_name - filter placements by sponsor/brand name
Convenience filter for finding a sponsor by display name. Use the sponsor_id returned in results for later sponsor-specific requests because names can vary. Preferred over deprecated brand_name.
Filter placements by a creator's publication URL (YouTube channel, Substack newsletter, podcast, etc.). Cannot be combined with categories.
Platforms to include (e.g., substack, podcast, youtube). If omitted, includes all. Repeat platforms to provide multiple values.
beehiiv, ghost, instagram, newsletter, podcast, substack, tiktok, youtube Alias for platforms. Prefer platforms; repeat platforms to provide multiple values.
beehiiv, ghost, instagram, newsletter, podcast, substack, tiktok, youtube Content-vertical phrases or keywords (e.g. 'consumer tech', 'startup tools'). Not brand or company names. Free-form strings are normalized to our standard category taxonomy and matched against publication categories. Cannot be combined with publication_url.
3Only return placements whose sponsor_type is one of these values. Use monetization_type and disclosure_tier to filter by those fields. Defaults to ['explicit_ad', 'implicit_ad', 'affiliate', 'promotion', 'unknown'].
Alternate name for sponsor_types; accepts one or more values.
Only return placements whose monetization_type is one of these values (paid_partnership, affiliate, gifted, or unknown; some older placements carry promotion, self_promotion, or merch_store). Matches only placements where the field is populated. If omitted, does not filter.
Alternate name for monetization_types; accepts one or more values.
Only return placements whose disclosure_tier is one of these values (platform_verified, creator_disclosed, commercial_signal, or inferred). Matches only placements where the field is populated. Requesting inferred includes inferred placements without setting include_inferred. If omitted, does not filter.
Alternate name for disclosure_tiers; accepts one or more values.
Filter by counterparty. true returns only placements promoting the creator's own product, service, or store, which are excluded by default. false excludes those placements. If omitted, does not filter.
Only return placements with at least this sponsorship confidence (0-1). Defaults to 0.5, which excludes lower-confidence matches.
0 <= x <= 1Time window in days (default 90). Ignored when since is provided.
1 <= x <= 365Start date (YYYY-MM-DD, inclusive). Overrides days_back. Required when until is provided.
End date (YYYY-MM-DD, inclusive). Defaults to today when only since is provided.
Start a sponsorship activity request after this ISO-8601 datetime. Requires platforms. Earlier values use the first supported activity time. For later requests, save next_sync_token from a response and send it as sync_token.
Opaque checkpoint returned as next_sync_token by an earlier activity request. Use it instead of activity_after to start the next request.
Include structured evidence (source, excerpt, transcript offset) when available.
Include placements where the sponsorship was inferred rather than explicitly disclosed or verified. These are lower-confidence and are excluded by default. Each result's disclosure_tier and partner_confidence let you filter further.
Maximum number of results per page. Requesting more than 20 results requires a credits-based plan.
1 <= x <= 50Pagination cursor. To continue a paginated activity request, pass this cursor with the same filters and omit activity_after and sync_token.
Response
Successful Response
List of sponsorship placements. Each record connects one sponsor, piece of content, and publication. Coauthored content can appear once for each participating publication.
Number of placement records. Coauthored content can count more than once because each participating publication has its own record.
Cursor for fetching the next page
Whether more results are available
Token for starting the next sponsorship activity request. Save it after processing the results from this response that you intend to keep. Returned only for activity searches.
Tracking status when publication_url is provided.