--- title: "Discovery API" method: POST path: "/public/v1/discovery/" tags: ["Discovery API"] --- # Discovery API `POST /public/v1/discovery/` Search and discover creators across multiple platforms using advanced filtering and search. **What you get** - Paginated list of creator profiles with profile info, follower counts, engagement rates, and analytics. Instagram creators (10k+ followers) also include audience demographics and interest data. - Supports Instagram, YouTube, TikTok, Twitch, Twitter, and OnlyFans platforms. **Platform-specific filters** - The available filters depend on the `platform` you choose — switching `platform` changes the filter fields in the request body. - Use the Dictionary endpoints to retrieve valid values for filters such as locations, languages, brands, audience interests, and audience locations. **Natural-language search** - Optional — `filters` work on their own. Sending an `nlp_search` brief lets you describe who you're looking for in plain language instead of building filters by hand, and you can combine the two. - The 200 response adds `applied_filters` (what the search actually ran with) and `nlp_search` (what the AI inferred, and why anything was dropped). **Credits** - **0.01 credits per creator returned** — 0 creators, 0 credits. - Every request that returns creators is billed, even with identical filters. Monitoring your request volume and credit usage is your responsibility. - Usage is capped per billing period — see [Usage & limits](guides/usage-limits.md#discovery-fair-use-cap) for how the cap works and what happens when you reach it. **Premium: matched filter values** - `return_filter_values=true` — each returned creator includes a `matched_filters` object showing exactly which of your filter values it matched; see its schema in the 200 response for the shape of each field. 0.03 credits per creator instead of 0.01, and the unique-handle cap is unchanged. See [the FAQ](/guides/faq#can-i-see-which-filter-values-each-creator-matched) for an example.
## Query parameters - `return_filter_values` boolean ## Request body - union - DiscoveryInstagramRequest - `platform` 'instagram', required - `nlp_search` string, nullable — Natural-language brief describing who you're looking for (e.g. "fitness creators in New York with over 100k followers"). It's mapped to discovery filters by AI to fill in fields you didn't set — your explicit `filters` take precedence. The search always runs on the `platform` you send; if the brief names another platform it's ignored. - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required — Page number (0-indexed). The first page is 0, not 1. - `sort` SortRequest - `sort_by` 'relevancy' | 'engagement_rate' | 'number_of_followers' | 'growth_rate' - `sort_order` 'asc' | 'desc' - `filters` InstagramDiscoveryFilters, required - `location` string[] - `type` string, nullable - `gender` string, nullable - `profile_language` string[] - `ai_search` string, nullable — Finds creators matching a single niche (e.g., 'plant-based recipes'), 3-150 characters; only letters, numbers and # - / , . ! ? + are supported. For best results, use one niche at a time—long or multi-topic phrases return weaker matches. - `keywords_in_bio` string[], nullable - `exclude_keywords_in_bio` string[], nullable - `hashtags` string[], nullable - `not_hashtags` string[], nullable - `keywords_in_captions` string[], nullable - `keywords_not_in_captions` string[], nullable - `link_in_bio` string[], nullable - `not_link_in_bio` string[], nullable - `number_of_followers` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `engagement_percent` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_likes` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_comments` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `number_of_posts` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `reels_percent` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_views_for_reels` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `posting_frequency` number, double, nullable - `follower_growth` GrowthRequest - `growth_percentage` number, double, nullable - `time_range_months` integer, nullable - `income` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `last_post` string, nullable — Allowed values: any, 90, 365 - `has_videos` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `exclude_private_profile` boolean, nullable - `is_verified` boolean, nullable - `brands` string[], nullable - `audience` AudienceFilterRequest - `location` AudienceLocationFilterRequest[], nullable - `name` string, nullable - `type` 'country' | 'state' | 'city', nullable - `min_pct` number, double, nullable - `gender` AudienceGenderFilterRequest - `type` string - `min_pct` number, double, nullable - `language` AudienceLanguageFilterRequest[], nullable - `language_abbr` string, nullable - `min_pct` number, double, nullable - `age` AudienceAgeFilterRequest[], nullable - `range` '13-17' | '18-24' | '25-34' | '35-44' | '45-64' | '65-' | '65+', nullable - `min_pct` number, double, nullable - `interests` AudienceInterestFilterRequest[], nullable - `name` string, nullable - `min_pct` number, double, nullable - `brands` string[], nullable - `brand_categories` string[], nullable - `credibility` 'bad' | 'low' | 'normal' | 'good' | 'high' | 'best', nullable - `creator_has` CreatorHasRequest - `has_amazonaffiliates` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_applemusic` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_bandcamp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_behance` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_buymeacoffee` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_cameo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_canva` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_clubhouse` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_discord` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_dribbble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_etsy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_facebook` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_fiverr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_github` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_gofundme` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_goodreads` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_instagram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kakao` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kickstarter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kofi` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linkedin` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linktree` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_medium` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_onlyfans` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_patreon` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_personal_website` boolean, nullable — Only true is meaningful. Filters for creators with a website on their Instagram, TikTok or YouTube profile. Sending false or null has no effect (equivalent to omitting the field). - `has_phone` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_pinterest` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_podcast` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_redbubble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopltk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_snapchat` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spotify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spring` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_streamlabs` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_substack` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_telegram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tiktok` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tumblr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitch` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_udemy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_viber` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vimeo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_weebly` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_whatsApp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_youtube` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_wix` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_anchor` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_soundcloud` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_community` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `promotes_affiliate_links` boolean, nullable - `has_done_brand_deals` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_link_in_bio` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `does_live_streaming` boolean, nullable - `has_merch` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `exclude_role_based_emails` boolean, nullable - `exclude_handles` string[] - `exclude_list` integer[] — IDs of exclusion lists to apply. Create and manage these via the Exclusion lists endpoints, then pass their IDs here; only lists for this platform are applied. - `exclude_default_list` boolean — When true, applies the team's default exclusion list for this platform. - `exclude_all_lists` boolean — When true, applies every exclusion list for this platform (the default list and all specific lists). - DiscoveryYouTubeRequest - `platform` 'youtube', required - `nlp_search` string, nullable — Natural-language brief describing who you're looking for (e.g. "fitness creators in New York with over 100k followers"). It's mapped to discovery filters by AI to fill in fields you didn't set — your explicit `filters` take precedence. The search always runs on the `platform` you send; if the brief names another platform it's ignored. - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required — Page number (0-indexed). The first page is 0, not 1. - `sort` SortRequest - `sort_by` 'relevancy' | 'engagement_rate' | 'number_of_followers' | 'growth_rate' - `sort_order` 'asc' | 'desc' - `filters` YouTubeDiscoveryFilters, required - `location` string[] - `type` string, nullable - `gender` string, nullable - `profile_language` string[] - `ai_search` string, nullable — Finds creators matching a single niche (e.g., 'plant-based recipes'), 3-150 characters; only letters, numbers and # - / , . ! ? + are supported. For best results, use one niche at a time—long or multi-topic phrases return weaker matches. - `keywords_in_description` string[], nullable - `keywords_not_in_description` string[], nullable - `keywords_in_video_description` string[], nullable - `keywords_not_in_video_description` string[], nullable - `keywords_in_video_titles` string[], nullable - `keywords_not_in_video_titles` string[], nullable - `hashtags` string[], nullable - `not_hashtags` string[], nullable - `topics` string[], nullable - `links_from_video_description` string[], nullable - `links_from_description` string[], nullable - `number_of_subscribers` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `engagement_percent` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_views_on_long_videos` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `median_views_long` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_views_on_shorts` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `number_of_videos` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `posting_frequency` number, double, nullable - `subscriber_growth` GrowthRequest - `growth_percentage` number, double, nullable - `time_range_months` integer, nullable - `is_verified` boolean, nullable - `last_upload_long_video` string, nullable — Allowed values: any, 90, 365 - `last_upload_short_video` string, nullable — Allowed values: any, 90, 365 - `has_shorts` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `shorts_percentage` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `has_community_posts` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `streams_live` boolean, nullable - `has_merch` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_podcast` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_courses` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_membership` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_live_videos` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `is_monetizing` boolean, nullable - `income` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `long_video_duration` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_stream_views` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_stream_duration` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `last_stream_upload` string, nullable — Allowed values: any, 90, 180, 365 - `brands` string[], nullable - `creator_has` CreatorHasRequest - `has_amazonaffiliates` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_applemusic` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_bandcamp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_behance` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_buymeacoffee` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_cameo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_canva` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_clubhouse` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_discord` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_dribbble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_etsy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_facebook` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_fiverr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_github` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_gofundme` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_goodreads` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_instagram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kakao` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kickstarter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kofi` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linkedin` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linktree` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_medium` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_onlyfans` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_patreon` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_personal_website` boolean, nullable — Only true is meaningful. Filters for creators with a website on their Instagram, TikTok or YouTube profile. Sending false or null has no effect (equivalent to omitting the field). - `has_phone` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_pinterest` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_podcast` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_redbubble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopltk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_snapchat` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spotify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spring` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_streamlabs` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_substack` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_telegram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tiktok` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tumblr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitch` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_udemy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_viber` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vimeo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_weebly` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_whatsApp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_youtube` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_wix` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_anchor` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_soundcloud` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_community` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `promotes_affiliate_links` boolean, nullable - `has_done_brand_deals` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_link_in_bio` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `does_live_streaming` boolean, nullable - `exclude_role_based_emails` boolean, nullable - `exclude_handles` string[] - `exclude_list` integer[] — IDs of exclusion lists to apply. Create and manage these via the Exclusion lists endpoints, then pass their IDs here; only lists for this platform are applied. - `exclude_default_list` boolean — When true, applies the team's default exclusion list for this platform. - `exclude_all_lists` boolean — When true, applies every exclusion list for this platform (the default list and all specific lists). - DiscoveryTikTokRequest - `platform` 'tiktok', required - `nlp_search` string, nullable — Natural-language brief describing who you're looking for (e.g. "fitness creators in New York with over 100k followers"). It's mapped to discovery filters by AI to fill in fields you didn't set — your explicit `filters` take precedence. The search always runs on the `platform` you send; if the brief names another platform it's ignored. - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required — Page number (0-indexed). The first page is 0, not 1. - `sort` SortRequest - `sort_by` 'relevancy' | 'engagement_rate' | 'number_of_followers' | 'growth_rate' - `sort_order` 'asc' | 'desc' - `filters` TikTokDiscoveryFilters, required - `location` string[] - `type` string, nullable - `gender` string, nullable - `profile_language` string[] - `ai_search` string, nullable — Finds creators matching a single niche (e.g., 'plant-based recipes'), 3-150 characters; only letters, numbers and # - / , . ! ? + are supported. For best results, use one niche at a time—long or multi-topic phrases return weaker matches. - `keywords_in_bio` string[], nullable - `exclude_keywords_in_bio` string[], nullable - `link_in_bio` string[], nullable - `not_link_in_bio` string[], nullable - `hashtags` string[], nullable - `not_hashtags` string[], nullable - `video_description` string[], nullable - `not_video_description` string[], nullable - `last_post` string, nullable — Allowed values: any, 90, 365 - `number_of_followers` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `video_count` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `engagement_percent` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_views` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_likes` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_comments` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_video_downloads` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `posting_frequency` number, double, nullable - `follower_growth` GrowthRequest - `growth_percentage` number, double, nullable - `time_range_months` integer, nullable - `has_tik_tok_shop` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `exclude_private_profile` boolean, nullable - `is_verified` boolean, nullable - `brands` string[], nullable - `creator_has` CreatorHasRequest - `has_amazonaffiliates` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_applemusic` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_bandcamp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_behance` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_buymeacoffee` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_cameo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_canva` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_clubhouse` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_discord` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_dribbble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_etsy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_facebook` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_fiverr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_github` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_gofundme` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_goodreads` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_instagram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kakao` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kickstarter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kofi` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linkedin` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linktree` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_medium` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_onlyfans` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_patreon` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_personal_website` boolean, nullable — Only true is meaningful. Filters for creators with a website on their Instagram, TikTok or YouTube profile. Sending false or null has no effect (equivalent to omitting the field). - `has_phone` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_pinterest` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_podcast` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_redbubble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopltk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_snapchat` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spotify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spring` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_streamlabs` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_substack` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_telegram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tiktok` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tumblr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitch` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_udemy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_viber` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vimeo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_weebly` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_whatsApp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_youtube` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_wix` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_anchor` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_soundcloud` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_community` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `promotes_affiliate_links` boolean, nullable - `has_done_brand_deals` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_link_in_bio` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `does_live_streaming` boolean, nullable - `has_merch` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `exclude_role_based_emails` boolean, nullable - `exclude_handles` string[] - `exclude_list` integer[] — IDs of exclusion lists to apply. Create and manage these via the Exclusion lists endpoints, then pass their IDs here; only lists for this platform are applied. - `exclude_default_list` boolean — When true, applies the team's default exclusion list for this platform. - `exclude_all_lists` boolean — When true, applies every exclusion list for this platform (the default list and all specific lists). - DiscoveryTwitterRequest - `platform` 'twitter', required - `nlp_search` string, nullable — Natural-language brief describing who you're looking for (e.g. "fitness creators in New York with over 100k followers"). It's mapped to discovery filters by AI to fill in fields you didn't set — your explicit `filters` take precedence. The search always runs on the `platform` you send; if the brief names another platform it's ignored. - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required — Page number (0-indexed). The first page is 0, not 1. - `sort` SortRequest - `sort_by` 'relevancy' | 'engagement_rate' | 'number_of_followers' | 'growth_rate' - `sort_order` 'asc' | 'desc' - `filters` TwitterDiscoveryFilters, required - `location` string[] - `type` string, nullable - `gender` string, nullable - `profile_language` string[] - `ai_search` string, nullable — Finds creators matching a single niche (e.g., 'plant-based recipes'), 3-150 characters; only letters, numbers and # - / , . ! ? + are supported. For best results, use one niche at a time—long or multi-topic phrases return weaker matches. - `keywords_in_bio` string[], nullable - `exclude_keywords_in_bio` string[], nullable - `hashtags` string[], nullable - `not_hashtags` string[], nullable - `number_of_followers` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `link_in_bio` string[], nullable - `not_link_in_bio` string[], nullable - `keywords_in_tweets` string[], nullable - `keywords_not_in_tweets` string[], nullable - `last_post` string, nullable — Allowed values: any, 90, 365 - `tweets_count` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `engagement_percent` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `average_likes` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `brands` string[], nullable - `creator_has` CreatorHasRequest - `has_amazonaffiliates` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_applemusic` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_bandcamp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_behance` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_buymeacoffee` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_cameo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_canva` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_clubhouse` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_discord` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_dribbble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_etsy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_facebook` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_fiverr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_github` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_gofundme` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_goodreads` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_instagram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kakao` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kickstarter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kofi` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linkedin` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linktree` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_medium` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_onlyfans` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_patreon` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_personal_website` boolean, nullable — Only true is meaningful. Filters for creators with a website on their Instagram, TikTok or YouTube profile. Sending false or null has no effect (equivalent to omitting the field). - `has_phone` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_pinterest` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_podcast` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_redbubble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopltk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_snapchat` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spotify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spring` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_streamlabs` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_substack` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_telegram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tiktok` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tumblr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitch` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_udemy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_viber` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vimeo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_weebly` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_whatsApp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_youtube` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_wix` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_anchor` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_soundcloud` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_community` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `promotes_affiliate_links` boolean, nullable - `has_done_brand_deals` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_link_in_bio` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `does_live_streaming` boolean, nullable - `has_merch` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `exclude_role_based_emails` boolean, nullable - `exclude_handles` string[] - `exclude_list` integer[] — IDs of exclusion lists to apply. Create and manage these via the Exclusion lists endpoints, then pass their IDs here; only lists for this platform are applied. - `exclude_default_list` boolean — When true, applies the team's default exclusion list for this platform. - `exclude_all_lists` boolean — When true, applies every exclusion list for this platform (the default list and all specific lists). - DiscoveryTwitchRequest - `platform` 'twitch', required - `nlp_search` string, nullable — Natural-language brief describing who you're looking for (e.g. "fitness creators in New York with over 100k followers"). It's mapped to discovery filters by AI to fill in fields you didn't set — your explicit `filters` take precedence. The search always runs on the `platform` you send; if the brief names another platform it's ignored. - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required — Page number (0-indexed). The first page is 0, not 1. - `sort` SortRequest - `sort_by` 'relevancy' | 'engagement_rate' | 'number_of_followers' | 'growth_rate' - `sort_order` 'asc' | 'desc' - `filters` TwitchDiscoveryFilters, required - `location` string[] - `gender` string, nullable - `profile_language` string[] - `ai_search` string, nullable — Finds creators matching a single niche (e.g., 'plant-based recipes'), 3-150 characters; only letters, numbers and # - / , . ! ? + are supported. For best results, use one niche at a time—long or multi-topic phrases return weaker matches. - `games_played` string[], nullable - `is_twitch_partner` boolean, nullable - `keywords_in_description` string[], nullable - `link_in_bio` string[], nullable - `not_link_in_bio` string[], nullable - `most_recent_stream_date` string, nullable — Allowed values: any, 30, 60, 90 - `followers` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `avg_views_last_30_days` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `streamed_hours_last_30_days` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `streams_count_last_30_days` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `maximum_views_count` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `brands` string[], nullable - `creator_has` CreatorHasRequest - `has_amazonaffiliates` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_applemusic` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_bandcamp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_behance` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_buymeacoffee` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_cameo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_canva` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_clubhouse` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_discord` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_dribbble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_etsy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_facebook` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_fiverr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_github` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_gofundme` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_goodreads` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_instagram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kakao` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kickstarter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kofi` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linkedin` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linktree` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_medium` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_onlyfans` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_patreon` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_personal_website` boolean, nullable — Only true is meaningful. Filters for creators with a website on their Instagram, TikTok or YouTube profile. Sending false or null has no effect (equivalent to omitting the field). - `has_phone` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_pinterest` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_podcast` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_redbubble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopltk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_snapchat` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spotify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spring` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_streamlabs` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_substack` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_telegram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tiktok` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tumblr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitch` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_udemy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_viber` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vimeo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_weebly` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_whatsApp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_youtube` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_wix` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_anchor` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_soundcloud` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_community` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `promotes_affiliate_links` boolean, nullable - `has_done_brand_deals` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_link_in_bio` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `does_live_streaming` boolean, nullable - `has_merch` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `exclude_role_based_emails` boolean, nullable - `exclude_handles` string[] - `exclude_list` integer[] — IDs of exclusion lists to apply. Create and manage these via the Exclusion lists endpoints, then pass their IDs here; only lists for this platform are applied. - `exclude_default_list` boolean — When true, applies the team's default exclusion list for this platform. - `exclude_all_lists` boolean — When true, applies every exclusion list for this platform (the default list and all specific lists). - DiscoveryOnlyFansRequest - `platform` 'onlyfans', required - `nlp_search` string, nullable — Natural-language brief describing who you're looking for (e.g. "fitness creators in New York with over 100k followers"). It's mapped to discovery filters by AI to fill in fields you didn't set — your explicit `filters` take precedence. The search always runs on the `platform` you send; if the brief names another platform it's ignored. - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required — Page number (0-indexed). The first page is 0, not 1. - `sort` SortRequest - `sort_by` 'relevancy' | 'engagement_rate' | 'number_of_followers' | 'growth_rate' - `sort_order` 'asc' | 'desc' - `filters` OnlyFansDiscoveryFilters, required - `location` string[] - `gender` string, nullable - `profile_language` string[] - `ai_search` string, nullable — Finds creators matching a single niche (e.g., 'plant-based recipes'), 3-150 characters; only letters, numbers and # - / , . ! ? + are supported. For best results, use one niche at a time—long or multi-topic phrases return weaker matches. - `number_of_likes` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `number_of_photos` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `subscription_price` RangeRequest - `min` number, double, nullable - `max` number, double, nullable - `is_verified` boolean, nullable - `has_videos` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_free_account` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_live_streams` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `last_active` string, nullable — Allowed values: any, 90, 365 - `brands` string[], nullable - `creator_has` CreatorHasRequest - `has_amazonaffiliates` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_applemusic` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_bandcamp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_behance` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_buymeacoffee` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_cameo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_canva` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_clubhouse` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_discord` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_dribbble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_etsy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_facebook` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_fiverr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_github` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_gofundme` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_goodreads` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_instagram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kakao` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kickstarter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kofi` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linkedin` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linktree` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_medium` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_onlyfans` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_patreon` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_personal_website` boolean, nullable — Only true is meaningful. Filters for creators with a website on their Instagram, TikTok or YouTube profile. Sending false or null has no effect (equivalent to omitting the field). - `has_phone` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_pinterest` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_podcast` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_redbubble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopltk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_snapchat` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spotify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spring` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_streamlabs` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_substack` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_telegram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tiktok` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tumblr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitch` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_udemy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_viber` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vimeo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_weebly` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_whatsApp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_youtube` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_wix` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_anchor` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_soundcloud` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_community` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `promotes_affiliate_links` boolean, nullable - `has_done_brand_deals` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `has_link_in_bio` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `does_live_streaming` boolean, nullable - `has_merch` boolean, nullable — Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `exclude_role_based_emails` boolean, nullable - `exclude_handles` string[] - `exclude_list` integer[] — IDs of exclusion lists to apply. Create and manage these via the Exclusion lists endpoints, then pass their IDs here; only lists for this platform are applied. - `exclude_default_list` boolean — When true, applies the team's default exclusion list for this platform. - `exclude_all_lists` boolean — When true, applies every exclusion list for this platform (the default list and all specific lists). ## Response `200` - DiscoverySearchResponse - `total` integer, required - `limit` integer, required - `credits_left` string, decimal, required - `accounts` AccountResponse[] - `user_id` string, required — The creator's unique platform identifier. - `profile` AccountProfile, required - `full_name` string, required - `username` string, required — The creator's username on the platform. - `picture` string, uri, required — URL to the creator's profile picture. This URL is temporary and expires after 24 hours. To keep the image, download it to your own storage before it expires. - `followers` integer, required - `engagement_percent` number, double, required - `similarity_score` number, double — How closely this creator matches your reference. Higher values indicate a stronger match. - `matched_filters` MatchedFilters - `audience_location` string[] — Echoed location conditions, e.g. ["US>30%"]. - `audience_gender` string — Echoed gender condition, e.g. "female>60%". - `audience_age` string[] — Echoed age conditions, e.g. ["18-24>40%"]. - `audience_interests` string[] — Echoed interest conditions. - `audience_language` string[] — Echoed language conditions. - `audience_credibility` string — Echoed audience credibility class. - `creator_has` CreatorHas - `has_amazonaffiliates` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_applemusic` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_bandcamp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_behance` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_buymeacoffee` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_cameo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_canva` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_clubhouse` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_discord` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_dribbble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_etsy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_facebook` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_fiverr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_github` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_gofundme` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_goodreads` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_instagram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kakao` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kickstarter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_kofi` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linkedin` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_linktree` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_medium` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_onlyfans` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_patreon` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_personal_website` boolean, nullable — Only true is meaningful. Filters for creators with a website on their Instagram, TikTok or YouTube profile. Sending false or null has no effect (equivalent to omitting the field). - `has_phone` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_pinterest` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_podcast` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_redbubble` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_shopltk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_snapchat` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spotify` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_spring` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_streamlabs` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_substack` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_telegram` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tiktok` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_tumblr` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitch` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_twitter` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_udemy` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_viber` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vimeo` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_vk` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_weebly` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_whatsApp` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_youtube` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_wix` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_anchor` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_soundcloud` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_community` boolean, nullable — Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `has_brand_deals` boolean — Echoes the has_done_brand_deals filter you sent. - `has_link_in_bio` boolean — Echoes the has_link_in_bio filter you sent. - `has_merch` boolean — Echoes the has_merch filter you sent. - `has_affiliate_links` boolean — Echoes the promotes_affiliate_links filter you sent. - `hashtags` string[] — The hashtags you searched for. - `not_hashtags` string[] — The excluded hashtags you searched for. - `posting_frequency` number, double — The creator's resolved posting frequency (posts per month). - `creator_growth` number, double — The creator's resolved growth percentage for the requested window. - `income` Range - `min` number, double, nullable - `max` number, double, nullable - `ai_search` string — Echoes the ai_search filter you sent. - `average_comments` number, double — The creator's resolved average comments per post. - `average_likes` number, double — The creator's resolved average likes per post. - `average_stream_duration` number, double — The creator's resolved average stream duration. - `average_stream_views` number, double — The creator's resolved average stream views. - `average_video_downloads` number, double — The creator's resolved average downloads per video. - `average_views` number, double — The creator's resolved average views per video. - `average_views_for_reels` number, double — The creator's resolved average views on reels. - `average_views_on_long_videos` number, double — The creator's resolved average views on long-form videos. - `average_views_on_shorts` number, double — The creator's resolved average views on Shorts. - `avg_views_last_30_days` number, double — The creator's resolved average views over the last 30 days. - `brands` string[] — Echoes the brands values you sent. - `does_live_streaming` boolean — Echoes the does_live_streaming filter you sent. - `engagement_percent` number, double — The creator's resolved engagement percentage. - `exclude_keywords_in_bio` string[] — Echoes the exclude_keywords_in_bio values you sent. - `exclude_private_profile` boolean — Echoes the exclude_private_profile filter you sent. - `exclude_role_based_emails` boolean — Echoes the exclude_role_based_emails filter you sent. - `followers` integer — The creator's resolved follower count. - `games_played` string[] — Echoes the games_played values you sent. - `gender` string — Echoes the gender filter you sent. - `has_community_posts` boolean — Echoes the has_community_posts filter you sent. - `has_courses` boolean — Echoes the has_courses filter you sent. - `has_free_account` boolean — Echoes the has_free_account filter you sent. - `has_live_streams` boolean — Echoes the has_live_streams filter you sent. - `has_membership` boolean — Echoes the has_membership filter you sent. - `has_podcast` boolean — Echoes the has_podcast filter you sent. - `has_shorts` boolean — Echoes the has_shorts filter you sent. - `has_tik_tok_shop` boolean — Echoes the has_tik_tok_shop filter you sent. - `has_videos` boolean — Echoes the has_videos filter you sent. - `is_monetizing` boolean — Echoes the is_monetizing filter you sent. - `is_twitch_partner` boolean — Echoes the is_twitch_partner filter you sent. - `is_verified` boolean — Echoes the is_verified filter you sent. - `keywords_in_bio` string[] — Echoes the keywords_in_bio values you sent. - `keywords_in_captions` string[] — Echoes the keywords_in_captions values you sent. - `keywords_in_description` string[] — Echoes the keywords_in_description values you sent. - `keywords_in_tweets` string[] — Echoes the keywords_in_tweets values you sent. - `keywords_in_video_description` string[] — Echoes the keywords_in_video_description values you sent. - `keywords_in_video_titles` string[] — Echoes the keywords_in_video_titles values you sent. - `keywords_not_in_captions` string[] — Echoes the keywords_not_in_captions values you sent. - `keywords_not_in_description` string[] — Echoes the keywords_not_in_description values you sent. - `keywords_not_in_tweets` string[] — Echoes the keywords_not_in_tweets values you sent. - `keywords_not_in_video_description` string[] — Echoes the keywords_not_in_video_description values you sent. - `keywords_not_in_video_titles` string[] — Echoes the keywords_not_in_video_titles values you sent. - `last_active` string — The creator's resolved last-active date. - `last_post` string — The creator's resolved most recent post date. - `last_stream_upload` string — The creator's resolved last stream upload date. - `last_upload_long_video` string — The creator's resolved last long-form video upload date. - `last_upload_short_video` string — The creator's resolved last short-form video upload date. - `link_in_bio` string[] — Echoes the link_in_bio values you sent. - `links_from_description` string[] — Echoes the links_from_description values you sent. - `links_from_video_description` string[] — Echoes the links_from_video_description values you sent. - `location` string[] — Echoes the location values you sent. - `long_video_duration` Range - `min` number, double, nullable - `max` number, double, nullable - `maximum_views_count` number, double — The creator's resolved maximum views on a stream. - `most_recent_stream_date` string — The creator's resolved most recent stream date. - `not_link_in_bio` string[] — Echoes the not_link_in_bio values you sent. - `not_video_description` string[] — Echoes the not_video_description values you sent. - `number_of_followers` integer — The creator's resolved follower count. - `number_of_likes` integer — The creator's resolved total likes. - `number_of_photos` number, double — The creator's resolved media count (matches what the filter ranges on; includes videos, not photos only). - `number_of_posts` number, double — The creator's resolved number of posts. - `number_of_subscribers` integer — The creator's resolved subscriber count. - `number_of_videos` integer — The creator's resolved video count. - `profile_language` string[] — Echoes the profile_language values you sent. - `reels_percent` number, double — The creator's resolved percentage of posts that are reels. - `shorts_percentage` number, double — The creator's resolved percentage of uploads that are Shorts. - `streamed_hours_last_30_days` number, double — The creator's resolved hours streamed over the last 30 days. - `streams_count_last_30_days` number, double — The creator's resolved stream count over the last 30 days. - `streams_live` boolean — Echoes the streams_live filter you sent. - `subscription_price` number, double — The creator's resolved subscription price. - `topics` string[] — Echoes the topics values you sent. - `tweets_count` number, double — The creator's resolved tweet count. - `type` string — Echoes the type filter you sent. - `video_count` integer — The creator's resolved video count. - `video_description` string[] — Echoes the video_description values you sent. - `applied_filters` object — The effective filter set the search ran with — your explicit `filters` layered over anything the AI inferred. - `nlp_search` NlpSearchEcho - `from_nlp` object — The filters the AI inferred from the brief. - `overridden_by_user` string[] — Fields where your explicit value beat the AI's inference. - `notes` string[] — Human-readable reasons a filter wasn't applied, e.g. unavailable on this platform. ## Other responses - `400` — Bad Request — invalid or missing parameters. Also returned when an `nlp_search` brief cannot be interpreted into filters ("Your search couldn't be interpreted into filters"), in which case nothing is charged. - `401` — Unauthorized — missing or invalid API key. - `403` — Forbidden — caller is not permitted to perform this action. - `422` — Unprocessable entity — validation failed. - `429` — Too Many Requests — rate or capacity limit exceeded. Inspect the `Retry-After` header and the `retry_after` body field for the wait time in seconds. - `503` — Service Error — a downstream dependency failed. Safe to retry. Returned when the AI mapping service behind `nlp_search` is temporarily unavailable. --- [API](https://skmtc.net/influencers/apis/core-api-concepts.md) · [All operations](https://skmtc.net/influencers/apis/core-api-concepts/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/influencers/core-api-concepts/revisions/87e654ac822e/schema)