# Similar Creators 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). Endpoint: POST /public/v1/discovery/creators/similar/ Version: 1.0.0 Security: Bearer ## Security: - `Bearer` (unknown) http bearer API_KEY ## Request fields (application/json): - `platform` (string) Enum: "instagram" - `filter_key` (string, required) Enum: "url", "username", "id" - `filter_value` (string, required) Email, platform url or profile handle - `paging` (object, required) - `paging.limit` (integer, required) - `paging.page` (integer, required) Page number (0-indexed). The first page is 0, not 1. - `filters` (object) - `filters.location` (array) - `filters.type` (string) - `filters.gender` (string) - `filters.profile_language` (array) - `filters.ai_search` (string) 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. - `filters.keywords_in_bio` (array) - `filters.exclude_keywords_in_bio` (array) - `filters.hashtags` (array) - `filters.not_hashtags` (array) - `filters.keywords_in_captions` (array) - `filters.keywords_not_in_captions` (array) - `filters.link_in_bio` (array) - `filters.not_link_in_bio` (array) - `filters.number_of_followers` (object) - `filters.number_of_followers.min` (number) - `filters.number_of_followers.max` (number) - `filters.engagement_percent` (object) - `filters.average_likes` (object) - `filters.average_comments` (object) - `filters.number_of_posts` (object) - `filters.reels_percent` (object) - `filters.average_views_for_reels` (object) - `filters.posting_frequency` (number) - `filters.follower_growth` (object) - `filters.follower_growth.growth_percentage` (number) - `filters.follower_growth.time_range_months` (integer) - `filters.income` (object) - `filters.last_post` (string) Allowed values: any, 90, 365 - `filters.has_videos` (boolean) Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `filters.exclude_private_profile` (boolean) - `filters.is_verified` (boolean) - `filters.niche` (array) 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. - `filters.sub_niche` (array) 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. - `filters.age_bracket` (array) 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. - `filters.brands` (array) - `filters.audience` (object) - `filters.audience.location` (array) - `filters.audience.location.name` (string) - `filters.audience.location.type` (string) Enum: "country", "state", "city" - `filters.audience.location.min_pct` (number) - `filters.audience.gender` (object) - `filters.audience.gender.type` (string) - `filters.audience.gender.min_pct` (number) - `filters.audience.language` (array) - `filters.audience.language.language_abbr` (string) - `filters.audience.language.min_pct` (number) - `filters.audience.age` (array) - `filters.audience.age.range` (string) Enum: "13-17", "18-24", "25-34", "35-44", "45-64", "65-", "65+" - `filters.audience.age.min_pct` (number) - `filters.audience.interests` (array) - `filters.audience.interests.name` (string) - `filters.audience.interests.min_pct` (number) - `filters.audience.brands` (array) - `filters.audience.brand_categories` (array) - `filters.audience.credibility` (string) Enum: "bad", "low", "normal", "good", "high", "best" - `filters.creator_has` (object) - `filters.creator_has.has_amazonaffiliates` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_applemusic` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_bandcamp` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_behance` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_buymeacoffee` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_cameo` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_canva` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_clubhouse` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_discord` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_dribbble` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_etsy` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_facebook` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_fiverr` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_github` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_gofundme` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_goodreads` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_instagram` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_kakao` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_kickstarter` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_kofi` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_linkedin` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_linktree` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_medium` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_onlyfans` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_patreon` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_personal_website` (boolean) 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). - `filters.creator_has.has_phone` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_pinterest` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_podcast` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_redbubble` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_shopify` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_shopltk` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_snapchat` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_spotify` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_spring` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_streamlabs` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_substack` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_telegram` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_tiktok` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_tumblr` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_twitch` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_twitter` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_udemy` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_viber` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_vimeo` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_vk` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_weebly` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_whatsApp` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_youtube` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_wix` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_anchor` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_soundcloud` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.creator_has.has_community` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `filters.promotes_affiliate_links` (boolean) - `filters.has_done_brand_deals` (boolean) Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `filters.has_link_in_bio` (boolean) Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `filters.does_live_streaming` (boolean) - `filters.has_merch` (boolean) Only true is meaningful. Sending false or null has no effect (equivalent to omitting the field). - `filters.exclude_role_based_emails` (boolean) - `filters.exclude_handles` (array) - `filters.exclude_list` (array) 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. - `filters.exclude_default_list` (boolean) When true, applies the team's default exclusion list for this platform. - `filters.exclude_all_lists` (boolean) When true, applies every exclusion list for this platform (the default list and all specific lists). ## Response 200 fields (application/json): - `total` (integer, required) - `limit` (integer, required) - `credits_left` (string, required) - `accounts` (array) - `accounts.user_id` (string, required) The creator's unique platform identifier. - `accounts.profile` (object, required) - `accounts.profile.full_name` (string, required) - `accounts.profile.username` (string, required) The creator's username on the platform. - `accounts.profile.picture` (string, 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. - `accounts.profile.followers` (integer, required) - `accounts.profile.engagement_percent` (number, required) - `accounts.similarity_score` (number) How closely this creator matches your reference. Higher values indicate a stronger match. - `accounts.matched_filters` (object) - `accounts.matched_filters.audience_location` (array) Echoed location conditions, e.g. ["US>30%"]. - `accounts.matched_filters.audience_gender` (string) Echoed gender condition, e.g. "female>60%". - `accounts.matched_filters.audience_age` (array) Echoed age conditions, e.g. ["18-24>40%"]. - `accounts.matched_filters.audience_interests` (array) Echoed interest conditions. - `accounts.matched_filters.audience_language` (array) Echoed language conditions. - `accounts.matched_filters.audience_credibility` (string) Echoed audience credibility class. - `accounts.matched_filters.creator_has` (object) - `accounts.matched_filters.creator_has.has_amazonaffiliates` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_applemusic` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_bandcamp` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_behance` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_buymeacoffee` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_cameo` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_canva` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_clubhouse` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_discord` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_dribbble` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_etsy` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_facebook` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_fiverr` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_github` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_gofundme` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_goodreads` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_instagram` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_kakao` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_kickstarter` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_kofi` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_linkedin` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_linktree` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_medium` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_onlyfans` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_patreon` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_personal_website` (boolean) 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). - `accounts.matched_filters.creator_has.has_phone` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_pinterest` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_podcast` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_redbubble` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_shopify` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_shopltk` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_snapchat` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_spotify` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_spring` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_streamlabs` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_substack` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_telegram` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_tiktok` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_tumblr` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_twitch` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_twitter` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_udemy` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_viber` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_vimeo` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_vk` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_weebly` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_whatsApp` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_youtube` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_wix` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_anchor` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_soundcloud` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.creator_has.has_community` (boolean) Only true is meaningful. Filters for creators who have this platform/link. Sending false or null has no effect (equivalent to omitting the field). - `accounts.matched_filters.has_brand_deals` (boolean) Echoes the has_done_brand_deals filter you sent. - `accounts.matched_filters.has_link_in_bio` (boolean) Echoes the has_link_in_bio filter you sent. - `accounts.matched_filters.has_merch` (boolean) Echoes the has_merch filter you sent. - `accounts.matched_filters.has_affiliate_links` (boolean) Echoes the promotes_affiliate_links filter you sent. - `accounts.matched_filters.hashtags` (array) The hashtags you searched for. - `accounts.matched_filters.not_hashtags` (array) The excluded hashtags you searched for. - `accounts.matched_filters.posting_frequency` (number) The creator's resolved posting frequency (posts per month). - `accounts.matched_filters.creator_growth` (number) The creator's resolved growth percentage for the requested window. - `accounts.matched_filters.income` (object) - `accounts.matched_filters.income.min` (number) - `accounts.matched_filters.income.max` (number) - `accounts.matched_filters.ai_search` (string) Echoes the ai_search filter you sent. - `accounts.matched_filters.average_comments` (number) The creator's resolved average comments per post. - `accounts.matched_filters.average_likes` (number) The creator's resolved average likes per post. - `accounts.matched_filters.average_stream_duration` (number) The creator's resolved average stream duration. - `accounts.matched_filters.average_stream_views` (number) The creator's resolved average stream views. - `accounts.matched_filters.average_video_downloads` (number) The creator's resolved average downloads per video. - `accounts.matched_filters.average_views` (number) The creator's resolved average views per video. - `accounts.matched_filters.average_views_for_reels` (number) The creator's resolved average views on reels. - `accounts.matched_filters.average_views_on_long_videos` (number) The creator's resolved average views on long-form videos. - `accounts.matched_filters.average_views_on_shorts` (number) The creator's resolved average views on Shorts. - `accounts.matched_filters.avg_views_last_30_days` (number) The creator's resolved average views over the last 30 days. - `accounts.matched_filters.brands` (array) Echoes the brands values you sent. - `accounts.matched_filters.does_live_streaming` (boolean) Echoes the does_live_streaming filter you sent. - `accounts.matched_filters.engagement_percent` (number) The creator's resolved engagement percentage. - `accounts.matched_filters.exclude_keywords_in_bio` (array) Echoes the exclude_keywords_in_bio values you sent. - `accounts.matched_filters.exclude_private_profile` (boolean) Echoes the exclude_private_profile filter you sent. - `accounts.matched_filters.exclude_role_based_emails` (boolean) Echoes the exclude_role_based_emails filter you sent. - `accounts.matched_filters.followers` (integer) The creator's resolved follower count. - `accounts.matched_filters.games_played` (array) Echoes the games_played values you sent. - `accounts.matched_filters.gender` (string) Echoes the gender filter you sent. - `accounts.matched_filters.has_community_posts` (boolean) Echoes the has_community_posts filter you sent. - `accounts.matched_filters.has_courses` (boolean) Echoes the has_courses filter you sent. - `accounts.matched_filters.has_free_account` (boolean) Echoes the has_free_account filter you sent. - `accounts.matched_filters.has_live_streams` (boolean) Echoes the has_live_streams filter you sent. - `accounts.matched_filters.has_membership` (boolean) Echoes the has_membership filter you sent. - `accounts.matched_filters.has_podcast` (boolean) Echoes the has_podcast filter you sent. - `accounts.matched_filters.has_shorts` (boolean) Echoes the has_shorts filter you sent. - `accounts.matched_filters.has_tik_tok_shop` (boolean) Echoes the has_tik_tok_shop filter you sent. - `accounts.matched_filters.has_videos` (boolean) Echoes the has_videos filter you sent. - `accounts.matched_filters.is_monetizing` (boolean) Echoes the is_monetizing filter you sent. - `accounts.matched_filters.is_twitch_partner` (boolean) Echoes the is_twitch_partner filter you sent. - `accounts.matched_filters.is_verified` (boolean) Echoes the is_verified filter you sent. - `accounts.matched_filters.keywords_in_bio` (array) Echoes the keywords_in_bio values you sent. - `accounts.matched_filters.keywords_in_captions` (array) Echoes the keywords_in_captions values you sent. - `accounts.matched_filters.keywords_in_description` (array) Echoes the keywords_in_description values you sent. - `accounts.matched_filters.keywords_in_tweets` (array) Echoes the keywords_in_tweets values you sent. - `accounts.matched_filters.keywords_in_video_description` (array) Echoes the keywords_in_video_description values you sent. - `accounts.matched_filters.keywords_in_video_titles` (array) Echoes the keywords_in_video_titles values you sent. - `accounts.matched_filters.keywords_not_in_captions` (array) Echoes the keywords_not_in_captions values you sent. - `accounts.matched_filters.keywords_not_in_description` (array) Echoes the keywords_not_in_description values you sent. - `accounts.matched_filters.keywords_not_in_tweets` (array) Echoes the keywords_not_in_tweets values you sent. - `accounts.matched_filters.keywords_not_in_video_description` (array) Echoes the keywords_not_in_video_description values you sent. - `accounts.matched_filters.keywords_not_in_video_titles` (array) Echoes the keywords_not_in_video_titles values you sent. - `accounts.matched_filters.last_active` (string) The creator's resolved last-active date. - `accounts.matched_filters.last_post` (string) The creator's resolved most recent post date. - `accounts.matched_filters.last_stream_upload` (string) The creator's resolved last stream upload date. - `accounts.matched_filters.last_upload_long_video` (string) The creator's resolved last long-form video upload date. - `accounts.matched_filters.last_upload_short_video` (string) The creator's resolved last short-form video upload date. - `accounts.matched_filters.link_in_bio` (array) Echoes the link_in_bio values you sent. - `accounts.matched_filters.links_from_description` (array) Echoes the links_from_description values you sent. - `accounts.matched_filters.links_from_video_description` (array) Echoes the links_from_video_description values you sent. - `accounts.matched_filters.location` (array) Echoes the location values you sent. - `accounts.matched_filters.maximum_views_count` (number) The creator's resolved maximum views on a stream. - `accounts.matched_filters.most_recent_stream_date` (string) The creator's resolved most recent stream date. - `accounts.matched_filters.not_link_in_bio` (array) Echoes the not_link_in_bio values you sent. - `accounts.matched_filters.not_video_description` (array) Echoes the not_video_description values you sent. - `accounts.matched_filters.number_of_followers` (integer) The creator's resolved follower count. - `accounts.matched_filters.number_of_likes` (integer) The creator's resolved total likes. - `accounts.matched_filters.number_of_photos` (number) The creator's resolved media count (matches what the filter ranges on; includes videos, not photos only). - `accounts.matched_filters.number_of_posts` (number) The creator's resolved number of posts. - `accounts.matched_filters.number_of_subscribers` (integer) The creator's resolved subscriber count. - `accounts.matched_filters.number_of_videos` (integer) The creator's resolved video count. - `accounts.matched_filters.profile_language` (array) Echoes the profile_language values you sent. - `accounts.matched_filters.reels_percent` (number) The creator's resolved percentage of posts that are reels. - `accounts.matched_filters.shorts_percentage` (number) The creator's resolved percentage of uploads that are Shorts. - `accounts.matched_filters.streamed_hours_last_30_days` (number) The creator's resolved hours streamed over the last 30 days. - `accounts.matched_filters.streams_count_last_30_days` (number) The creator's resolved stream count over the last 30 days. - `accounts.matched_filters.streams_live` (boolean) Echoes the streams_live filter you sent. - `accounts.matched_filters.subscription_price` (number) The creator's resolved subscription price. - `accounts.matched_filters.topics` (array) Echoes the topics values you sent. - `accounts.matched_filters.tweets_count` (number) The creator's resolved tweet count. - `accounts.matched_filters.type` (string) Echoes the type filter you sent. - `accounts.matched_filters.video_count` (integer) The creator's resolved video count. - `accounts.matched_filters.video_description` (array) Echoes the video_description values you sent. ## Response 400: - `400` (unknown) Bad request — invalid input or unsupported state. ## Response 400 fields (application/json): - `error` (any) Human-readable description of what went wrong. Shape varies per endpoint: string on most paths, DRF field-error object on validation paths of creators_api enrich/* and enrichment_batch_api create, list of strings on discovery filter validation. See the per-endpoint example response. Example: Insufficient credits. - `error_code` (string, required) Machine-readable snake_case slug identifying the error class. Stable across API versions; **the only field guaranteed present on every public-API error**. Use for programmatic branching instead of parsing `error`. Example: insufficient_credits - `message` (string) Optional long-form detail sibling to `error`. Present on endpoints that historically returned both a short label and a long explanation (rate limits, polling, batch state, insufficient_credits on resume). Example: Poll every 30-60 seconds. Excessive polling results in rate limiting. - `retry_after` (integer) Seconds the caller should wait before retrying. Present on 429s where the OLD endpoint set it; mirrored in the `Retry-After` HTTP header. Example: 60 - `response_meta` (object) Echo of request metadata on a few unwrapped endpoints (notably download_batch_enrichment_csv: batch_id, batch_status). Internal-only on wrapped endpoints; stripped before reaching the client. - `available_credits` (number) Credits currently available. Present on the 403 insufficient_credits response of `POST /public/v1/enrichment/batch/{id}/resume/`. - `required_minimum` (number) Minimum credits needed. Pairs with `available_credits`. - `current_status` (string) Current resource state. Present on 400 responses where the operation requires a different state (e.g. `batch_not_ready`, `batch_not_resumable`). - `active_batches` (integer) Active batch count when `error_code: batch_limit_reached`. - `max_allowed` (integer) Per-client batch ceiling. Pairs with `active_batches`. ## Response 401: - `401` (unknown) Unauthorized — missing or invalid API key. ## Response 403: - `403` (unknown) Forbidden — caller is not permitted to perform this action. ## Response 403 fields (application/json): - `error` (any) Human-readable description of what went wrong. Shape varies per endpoint: string on most paths, DRF field-error object on validation paths of creators_api enrich/* and enrichment_batch_api create, list of strings on discovery filter validation. See the per-endpoint example response. Example: Insufficient credits. - `error_code` (string, required) Machine-readable snake_case slug identifying the error class. Stable across API versions; **the only field guaranteed present on every public-API error**. Use for programmatic branching instead of parsing `error`. Example: insufficient_credits - `message` (string) Optional long-form detail sibling to `error`. Present on endpoints that historically returned both a short label and a long explanation (rate limits, polling, batch state, insufficient_credits on resume). Example: Poll every 30-60 seconds. Excessive polling results in rate limiting. - `retry_after` (integer) Seconds the caller should wait before retrying. Present on 429s where the OLD endpoint set it; mirrored in the `Retry-After` HTTP header. Example: 60 - `response_meta` (object) Echo of request metadata on a few unwrapped endpoints (notably download_batch_enrichment_csv: batch_id, batch_status). Internal-only on wrapped endpoints; stripped before reaching the client. - `available_credits` (number) Credits currently available. Present on the 403 insufficient_credits response of `POST /public/v1/enrichment/batch/{id}/resume/`. - `required_minimum` (number) Minimum credits needed. Pairs with `available_credits`. - `current_status` (string) Current resource state. Present on 400 responses where the operation requires a different state (e.g. `batch_not_ready`, `batch_not_resumable`). - `active_batches` (integer) Active batch count when `error_code: batch_limit_reached`. - `max_allowed` (integer) Per-client batch ceiling. Pairs with `active_batches`. ## Response 422: - `422` (unknown) Unprocessable entity — validation failed. ## Response 429: - `429` (unknown) 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. ## Response 429 fields (application/json): - `error` (any) Human-readable description of what went wrong. Shape varies per endpoint: string on most paths, DRF field-error object on validation paths of creators_api enrich/* and enrichment_batch_api create, list of strings on discovery filter validation. See the per-endpoint example response. Example: Insufficient credits. - `error_code` (string, required) Machine-readable snake_case slug identifying the error class. Stable across API versions; **the only field guaranteed present on every public-API error**. Use for programmatic branching instead of parsing `error`. Example: insufficient_credits - `message` (string) Optional long-form detail sibling to `error`. Present on endpoints that historically returned both a short label and a long explanation (rate limits, polling, batch state, insufficient_credits on resume). Example: Poll every 30-60 seconds. Excessive polling results in rate limiting. - `retry_after` (integer) Seconds the caller should wait before retrying. Present on 429s where the OLD endpoint set it; mirrored in the `Retry-After` HTTP header. Example: 60 - `response_meta` (object) Echo of request metadata on a few unwrapped endpoints (notably download_batch_enrichment_csv: batch_id, batch_status). Internal-only on wrapped endpoints; stripped before reaching the client. - `available_credits` (number) Credits currently available. Present on the 403 insufficient_credits response of `POST /public/v1/enrichment/batch/{id}/resume/`. - `required_minimum` (number) Minimum credits needed. Pairs with `available_credits`. - `current_status` (string) Current resource state. Present on 400 responses where the operation requires a different state (e.g. `batch_not_ready`, `batch_not_resumable`). - `active_batches` (integer) Active batch count when `error_code: batch_limit_reached`. - `max_allowed` (integer) Per-client batch ceiling. Pairs with `active_batches`.