# Get Search Endpoint for the influencer finder. Each request provides 10 influencers, costing 1 search credits for every new influencer seen. Endpoint: POST /v1/search/get_search Version: 1.4.2 Security: ApiKeyAuth ## Request fields (application/json): - `platform` (string, required) Platform to search. Enum: "instagram", "youtube", "tiktok" - `filter` (object, required) Object of optional filters (see properties). Use IDs from /v1/search/locations for geo and audience_geo. - `filter.filter_ids` (array) Search for individual influencers using the user id. (instagram, tiktok, youtube) Fetch user_id via /v1/search/database_influencers using type=search - `filter.text` (string) Keyword in influencer bio/profile description. (instagram, tiktok, youtube) - `filter.keywords` (string) Single keyword in influencer posts. (instagram, tiktok, youtube) - `filter.relevance` (object) Lookalike-based influencer filter. (instagram, tiktok, youtube) Fetch possible handles via /v1/search/database_influencers using type=topic-tags. - `filter.relevance.value` (string) - `filter.audience_relevance` (object) Lookalike-based audience filter. (instagram, tiktok, youtube) Fetch possible handles via /v1/search/database_influencers using type=topic-tags. - `filter.last_posted` (string) Days since last posted. (instagram, tiktok, youtube) Enum: "30", "90", "180" - `filter.audience_age_range` (object) Audience age bracket + minimum share. (instagram, tiktok, youtube) - `filter.audience_age_range.left_number` (string) Enum: "13", "18", "25", "35", "45", "65" - `filter.audience_age_range.right_number` (string) Enum: "13", "18", "25", "35", "45", "65", "" - `filter.audience_age_range.weight` (string) Enum: "0.01", "0.05", "0.1", "0.15", "0.20", "0.30", "0.40", "0.50", "0.60", "0.70", "0.80", "0.90", "0.95" - `filter.age` (object) Influencer’s age bracket. (instagram, tiktok, youtube) - `filter.audience_lang` (object) Audience language. (instagram, tiktok, youtube) - `filter.audience_lang.code` (string) Enum: "en", "es", "pt", "fr", "ar", "ru", "it", "de", "fa", "id", "tr", "ja", "pl", "th", "zh", "hi", "ms", "uk", "ko", "nl", "arz", "ne", "az", "pa", "gu", "sv", "kk", "he", "ro", "ckb", "cs", "vi", "ur", "mr", "ky", "hu", "el", "ml", "bn", "ca", "fi", "no", "da", "bg", "sr", "sw", "hr", "sq", "tl", "sk", "ta", "sh", "sl", "ps", "mk", "km", "hy", "kn", "uz", "gl", "ce", "azb", "af", "lt", "ceb", "si", "et", "tg", "tt", "pnb", "as", "ka", "bs", "lv", "lo", "te", "am", "my", "is", "mn", "sah", "mzn", "ku", "sd", "or", "gd", "fy", "so", "be", "war", "als", "mhr", "ie", "ba", "tk", "ia", "nds", "jv", "dv", "jbo", "ug", "gn", "bo", "nap", "ilo", "mg", "lez", "su", "io", "ga", "min", "ht", "kw", "bh", "yue", "ast", "new", "yi", "cv", "mai", "pms", "hsb", "bar", "sa", "sco", "xmf", "pam", "xh", "krc", "lrc", "zu", "rw", "bpy", "mrj", "wuu", "os", "gv", "cbk", "eml", "lmo", "gom", "myv", "rm", "li", "scn", "kv", "bcl", "bxr", "vep", "av", "sc", "xal", "tyv", "diq", "nah", "mwl", "yo", "dty", "vec", "rue", "vls", "dsb", "pfl", "co", "frr" - `filter.lang` (object) Profile language. (instagram, tiktok, youtube) - `filter.followers` (object) Follower count range. (instagram, tiktok, youtube) - `filter.views` (object) Average view count range. (tiktok, youtube) - `filter.engagements` (object) Total engagements range. (instagram) - `filter.engagement_rate` (object) Minimum engagement rate as decimal. (instagram) - `filter.audience_geo` (array) Geography filters by location ID (from /v1/search/locations) + weight. (instagram, tiktok, youtube) - `filter.audience_geo.id` (integer) - `filter.geo` (array) Geography filters by location ID (from /v1/search/locations). (instagram, tiktok, youtube) - `filter.followers_growth` (object) Minimum follower growth % over X months. (instagram, tiktok, youtube) - `filter.followers_growth.interval` (string) Enum: "i1months", "i2months", "i3months", "i4months", "i5months", "i6months" - `filter.total_views_growth` (object) Minimum views growth % over X months. (tiktok, youtube) - `filter.with_contact` (array) Required/forbidden contact channels. (instagram, tiktok, youtube) - `filter.with_contact.type` (string) Enum: "email", "snapchat", "facebook", "youtube", "tiktok", "twitter", "telegram", "vk", "wechat", "tumblr", "twitch", "pinterest", "linktree", "weibo" - `filter.with_contact.action` (string) Enum: "must", "not" - `filter.audience_race` (object) Ethnicity filter with minimum audience percentage. (instagram) - `filter.gender` (object) Influencer gender. (instagram, tiktok, youtube) - `filter.audience_gender` (object) Audience gender filter. (instagram, tiktok, youtube) - `filter.ih_magic` (string) Influencer Hero magic score. (instagram, tiktok, youtube) Enum: "high", "very_high" - `filter.audience_credibility_class` (array) Audience credibility class. (instagram, tiktok, youtube) Enum: "low", "normal", "high", "best" - `filter.has_audience_data` (boolean) Whether audience data is available. (instagram, tiktok, youtube) - `filter.is_hidden` (boolean) Whether the account is hidden. (instagram, tiktok, youtube) - `filter.is_verified` (boolean) Whether the account is verified. (instagram, tiktok, youtube) - `filter.account_type` (string) Account type (1=Regular,2=Business,3=Creator). (instagram, tiktok, youtube) Enum: "1", "2", "3" - `filter.reels_plays` (object) Reel plays range. (instagram) - `search_timestamp` (integer) Optional Unix timestamp (seconds) for time-based filtering. - `offset` (integer) Optional pagination offset. ## Response 200 fields (application/json): - `results` (object) - `results.accounts` (array) - `results.accounts.match` (object) - `results.accounts.account` (object) - `results.accounts.account.audience_source` (string) - `results.accounts.account.user_profile` (object) - `results.accounts.account.user_profile.account_type` (string) - `results.accounts.account.user_profile.followers` (string) - `results.accounts.account.user_profile.user_id` (string) - `results.accounts.account.user_profile.engagement_rate` (string) - `results.accounts.account.user_profile.engagements` (string) - `results.accounts.account.user_profile.fullname` (string) - `results.accounts.account.user_profile.is_verified` (boolean) - `results.accounts.account.user_profile.picture` (string) - `results.accounts.account.user_profile.url` (string) - `results.accounts.account.user_profile.username` (string) - `results.cost` (string) - `results.shown_accounts` (array) - `search_credits_left` (number) Search Credits Left divided by 50. Multiply by 50 to get number of new influencers to be seen. - `search_timestamp` (integer) - `success` (boolean)