Changelog

ChangedDiscovery usage limit — replaced the previous separate Discovery-credit allowance with a fair-use cap on the number of unique creators you can discover per billing period. When the cap is reached, POST /public/v1/discovery/ and POST /public/v1/discovery/creators/similar/ return 429 until your subscription renews. See Usage & limits.

AddedSocial Listening — monitor creators and receive their activity via webhooks. New endpoints under /public/v1/social/listening/:

Subscriptions

• GET subscription/ — list subscriptions
• POST subscription/ — create a subscription
• GET subscription/{subscription_id}/ — get a subscription
• PATCH subscription/{subscription_id}/ — update a subscription
• DELETE subscription/{subscription_id}/ — delete a subscription
• GET subscription/{subscription_id}/creators/ — list subscription creators
• POST subscription/{subscription_id}/creators/ — add subscription creators
• GET subscription/{subscription_id}/details/ — subscription stats
• GET subscription/{subscription_id}/details/export/ — export stats (CSV)

Campaigns

• GET campaign/ — list campaigns
• POST campaign/ — create a campaign
• GET campaign/{campaign_id}/ — get a campaign
• PATCH campaign/{campaign_id}/ — update a campaign
• DELETE campaign/{campaign_id}/ — archive a campaign
• GET campaign/{campaign_id}/creators/ — list campaign creators
• POST campaign/{campaign_id}/creators/ — add campaign creators
• DELETE campaign/{campaign_id}/creators/ — remove campaign creators
• GET campaign/{campaign_id}/overview/ — campaign overview
• GET campaign/{campaign_id}/content/ — campaign content feed

Events

• GET events/ — list events
• GET events/{event_id}/ — get an event

Usage

• GET usage/ — current limits and active subscription counts

AddedAPI Key Management — create and manage long-lived API keys under /public/v1/accounts/:

• GET tokens/ — list all keys (active and inactive), including raw values and an active flag per entry
• POST tokens/ — create a new key
• PATCH tokens/{token_id}/ — update label, scopes, active status, or expiration
• DELETE tokens/{token_id}/ — permanently delete a key

Added OAuth PKCE Flow — authorization code + PKCE flow for desktop and CLI integrations (S256 only), under /public/v1/oauth/:

• POST register/ — register a client once (no auth) for a persistent client_id
• GET authorize/ — browser-based consent flow
• POST token/ — exchange the authorization code for an access token

Added Connected OAuth Apps — manage the apps a user has authorized, under /public/v1/oauth/:

• GET apps/ — list connected apps
• GET apps/{app_id}/ — get a single app
• DELETE apps/{app_id}/ — revoke its access

Added Similar Creators — each account may include similarity_score (number): how closely that creator matches your reference (higher = stronger match).

AddedLocation Classifier — new search, offset, and limit query parameters. Use search for substring/prefix matching (e.g. "London", "United"); paginate with offset + limit (1–100 per page).

AddedLookalikes — Twitter support via the new SimilarCreatorsTwitterRequest schema. Look up by url, username, or id.

AddedEnrich by Handle (full) — audience demographics in the response when include_audience_data=true. Returns breakdowns for followers, commenters, and likers: geography, languages, age, gender, interests, brand affinities, plus credibility histograms and reachability.

AddedBatch Enrichment — new recommended download endpoint GET /public/v1/enrichment/batch/{batch_id}/download/ returns a short-lived presigned URL for downloading CSV results directly from cloud storage. The original GET /public/v1/enrichment/batch/{batch_id}/ is preserved as the direct-download fallback and is still required for JSON output via ?format=json.

AddedDiscovery — content-exclusion filters: keywords_not_in_captions (Instagram), keywords_not_in_tweets (Twitter), keywords_not_in_video_titles (YouTube), not_link_in_bio (Instagram, TikTok, Twitter, Twitch). Excludes creators whose recent content matches the given keywords.

AddedDiscovery — audience targeting for Instagram creators (10k+ followers). Filter by audience.location, audience.interests, audience.brand_categories, audience.brands. Backed by four new classifier endpoints under /public/v1/discovery/classifier/: audience-locations, audience-interests, audience-brand-categories, audience-brand-names.

AddedDiscovery — exclude_handles parameter. Accepts up to 10,000 handles to exclude from search results. Values are normalized automatically (lowercased, @ stripped, URLs parsed).

Breaking Discovery — include_lookalikes default flipped from true to false. Same request body, different result set.

	Before	After
Default	include_lookalikes: true	include_lookalikes: false
Result	Includes lookalike creators	Excludes lookalike creators

To restore previous behavior, set "include_lookalikes": true explicitly.

Deprecated Discovery — exclude_all parameter. Use exclude_handles instead. Minimum 12-month notice before removal.

AddedPost Details — type parameter now constrained to data | comments | transcript | audio. Instagram and TikTok support all four; YouTube supports only data and transcript.