Skip to main content
GET
cURL

Authorizations

X-API-Key
string
header
required

Query Parameters

brand_id
string | null
deprecated

Deprecated: use sponsor_id.

sponsor_id
string | null

Filter to placements from the sponsor with this identifier. Sponsor identifiers appear in the sponsor_id field of results.

sponsor_channel_id
string | null

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.

brand_name
string | null

Deprecated. Same as sponsor_name - filter placements by sponsor/brand name

sponsor_name
string | null

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.

publication_url
string | null

Filter placements by a creator's publication URL (YouTube channel, Substack newsletter, podcast, etc.). Cannot be combined with categories.

platforms
enum<string>[] | null

Platforms to include (e.g., substack, podcast, youtube). If omitted, includes all. Repeat platforms to provide multiple values.

Available options:
beehiiv,
ghost,
instagram,
newsletter,
podcast,
substack,
tiktok,
youtube
platform
enum<string>[] | null

Alias for platforms. Prefer platforms; repeat platforms to provide multiple values.

Available options:
beehiiv,
ghost,
instagram,
newsletter,
podcast,
substack,
tiktok,
youtube
categories
string[] | null

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.

Maximum array length: 3
sponsor_types
string[] | null

Only 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'].

sponsor_type
string[] | null

Alternate name for sponsor_types; accepts one or more values.

monetization_types
string[] | null

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.

monetization_type
string[] | null

Alternate name for monetization_types; accepts one or more values.

disclosure_tiers
string[] | null

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.

disclosure_tier
string[] | null

Alternate name for disclosure_tiers; accepts one or more values.

is_first_party
boolean | null

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.

confidence_threshold
number
default:0.5

Only return placements with at least this sponsorship confidence (0-1). Defaults to 0.5, which excludes lower-confidence matches.

Required range: 0 <= x <= 1
days_back
integer
default:90

Time window in days (default 90). Ignored when since is provided.

Required range: 1 <= x <= 365
since
string | null

Start date (YYYY-MM-DD, inclusive). Overrides days_back. Required when until is provided.

until
string | null

End date (YYYY-MM-DD, inclusive). Defaults to today when only since is provided.

activity_after
string | null

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.

sync_token
string | null

Opaque checkpoint returned as next_sync_token by an earlier activity request. Use it instead of activity_after to start the next request.

include_evidence
boolean
default:false

Include structured evidence (source, excerpt, transcript offset) when available.

include_inferred
boolean
default:false

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.

limit
integer
default:20

Maximum number of results per page. Requesting more than 20 results requires a credits-based plan.

Required range: 1 <= x <= 50
cursor
string | null

Pagination cursor. To continue a paginated activity request, pass this cursor with the same filters and omit activity_after and sync_token.

Response

Successful Response

results
SponsorshipPlacement · object[]
required

List of sponsorship placements. Each record connects one sponsor, piece of content, and publication. Coauthored content can appear once for each participating publication.

total_count
integer
required

Number of placement records. Coauthored content can count more than once because each participating publication has its own record.

next_cursor
string | null

Cursor for fetching the next page

has_more
boolean
default:false

Whether more results are available

next_sync_token
string | null

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
SponsorshipTrackingStatus · object | null

Tracking status when publication_url is provided.