--- title: "Similar Creators" method: POST path: "/public/v1/discovery/creators/similar/" tags: ["Similar Creators"] --- # Similar Creators `POST /public/v1/discovery/creators/similar/` ## Request - Base URL: `https://api-dashboard.influencers.club` - URL: `https://api-dashboard.influencers.club/public/v1/discovery/creators/similar/` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Discover creators similar to a reference creator based on various similarity criteria. **What you get** - Returns a paginated list of creator profiles that match the reference creator's characteristics, content style, audience, or other specified attributes. - Supports filtering by URL, username, or ID, and allows additional filters to refine similarity matching. - Useful for finding lookalike creators, competitors, or creators in the same niche. **Credits** - **0.01 credits per creator returned**. If no creators are returned, no credits are deducted. - Credits are consumed on **every request** that returns creators, even if the filters are identical to a previous request. - It is the client's responsibility to monitor request volume and credit usage. - Similar-creator results count against the same per-billing-period Discovery cap. See [Usage & limits](guides/usage-limits.md#discovery-fair-use-cap).
## Request body - union - SimilarCreatorsInstagramRequest - `platform` 'instagram' - `filter_key` 'url' | 'username' | 'id', required - `filter_value` string, required: Email, platform url or profile handle - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required: Page number (0-indexed). The first page is 0, not 1. - `filters` InstagramDiscoveryFilters - `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 - `niche` string[], nullable: Creator niche labels (e.g. 'Fitness & Exercise', 'Beauty & Grooming'). Matches creators tagged with any of the given niche or sub_niche labels. Instagram, TikTok and YouTube only. Unmatched labels silently return no results — use the `classifier/niche/` endpoint to get valid values. - `sub_niche` string[], nullable: Creator sub-niche labels, one level below niche (e.g. 'Skincare' under 'Beauty & Grooming'). Matches creators tagged with any of the given niche or sub_niche labels. Instagram, TikTok and YouTube only. Unmatched labels silently return no results — use the `classifier/sub-niche/` endpoint to get valid values. - `age_bracket` string[], nullable: Creator's own age bracket, 18+ only. This is the creator's age, not their audience's age (see audience.age for that). Instagram, TikTok and YouTube only. - `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). - SimilarCreatorsYouTubeRequest - `platform` 'youtube' - `filter_key` 'url' | 'username' | 'id', required - `filter_value` string, required: Email, platform url or profile handle - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required: Page number (0-indexed). The first page is 0, not 1. - `filters` YouTubeDiscoveryFilters - `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 - `niche` string[], nullable: Creator niche labels (e.g. 'Fitness & Exercise', 'Beauty & Grooming'). Matches creators tagged with any of the given niche or sub_niche labels. Instagram, TikTok and YouTube only. Unmatched labels silently return no results — use the `classifier/niche/` endpoint to get valid values. - `sub_niche` string[], nullable: Creator sub-niche labels, one level below niche (e.g. 'Skincare' under 'Beauty & Grooming'). Matches creators tagged with any of the given niche or sub_niche labels. Instagram, TikTok and YouTube only. Unmatched labels silently return no results — use the `classifier/sub-niche/` endpoint to get valid values. - `age_bracket` string[], nullable: Creator's own age bracket, 18+ only. This is the creator's age, not their audience's age (see audience.age for that). Instagram, TikTok and YouTube only. - `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). - SimilarCreatorsTikTokRequest - `platform` 'tiktok' - `filter_key` 'url' | 'username' | 'id', required - `filter_value` string, required: Email, platform url or profile handle - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required: Page number (0-indexed). The first page is 0, not 1. - `filters` TikTokDiscoveryFilters - `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 - `niche` string[], nullable: Creator niche labels (e.g. 'Fitness & Exercise', 'Beauty & Grooming'). Matches creators tagged with any of the given niche or sub_niche labels. Instagram, TikTok and YouTube only. Unmatched labels silently return no results — use the `classifier/niche/` endpoint to get valid values. - `sub_niche` string[], nullable: Creator sub-niche labels, one level below niche (e.g. 'Skincare' under 'Beauty & Grooming'). Matches creators tagged with any of the given niche or sub_niche labels. Instagram, TikTok and YouTube only. Unmatched labels silently return no results — use the `classifier/sub-niche/` endpoint to get valid values. - `age_bracket` string[], nullable: Creator's own age bracket, 18+ only. This is the creator's age, not their audience's age (see audience.age for that). Instagram, TikTok and YouTube only. - `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). - SimilarCreatorsTwitterRequest - `platform` 'twitter' - `filter_key` 'url' | 'username' | 'id', required - `filter_value` string, required: Email, platform url or profile handle - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required: Page number (0-indexed). The first page is 0, not 1. - `filters` TwitterDiscoveryFilters - `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). - SimilarCreatorsTwitchRequest - `platform` 'twitch' - `filter_key` 'url' | 'username' | 'id', required - `filter_value` string, required: Email, platform url or profile handle - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required: Page number (0-indexed). The first page is 0, not 1. - `filters` TwitchDiscoveryFilters - `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). - SimilarCreatorsOnlyFansRequest - `platform` 'onlyfans' - `filter_key` 'url' | 'username' | 'id', required - `filter_value` string, required: Email, platform url or profile handle - `paging` PagingRequest, required - `limit` integer, required - `page` integer, required: Page number (0-indexed). The first page is 0, not 1. - `filters` OnlyFansDiscoveryFilters - `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` - DiscoveryAPIResponse - `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. ## Other responses - `400`: Bad request — invalid input or unsupported state. - `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. ## Changes - **2026-10-07** `07fd7d5f3314`: 27 info - added the new optional request property `oneOf[#/components/schemas/SimilarCreatorsInstagramRequest]/filters/age_bracket` (media type: application/json) - added the new optional request property `oneOf[#/components/schemas/SimilarCreatorsInstagramRequest]/filters/age_bracket` (media type: application/x-www-form-urlencoded) - added the new optional request property `oneOf[#/components/schemas/SimilarCreatorsInstagramRequest]/filters/age_bracket` (media type: multipart/form-data) - added the new optional request property `oneOf[#/components/schemas/SimilarCreatorsInstagramRequest]/filters/niche` (media type: application/json) - …23 more - **2026-08-18** `87e654ac822e`: 2 warning, 106 info - removed the optional property `applied_filters` from the response with the `200` status - removed the optional property `nlp_search` from the response with the `200` status - added the new optional request property `oneOf[#/components/schemas/SimilarCreatorsInstagramRequest]/filters/creator_has/has_personal_website` (media type: application/json) - added the new optional request property `oneOf[#/components/schemas/SimilarCreatorsInstagramRequest]/filters/creator_has/has_personal_website` (media type: application/x-www-form-urlencoded) - …104 more - …earlier changes not shown [Operation history](https://skmtc.dev/influencers/apis/core-api-concepts/changes/public/v1/discovery/creators/similar/post.md) --- [API](https://skmtc.dev/influencers/apis/core-api-concepts.md) - [All operations](https://skmtc.dev/influencers/apis/core-api-concepts/llms.txt) - [OpenAPI document](https://skmtc.dev/influencers/apis/core-api-concepts/revisions/11c76bf81bec?raw)