Discovery Search API

Streamline your Influencer Search process effortlessly with our discovery database by implementing various filters tailored to your brand's specifications.

GET - Discovery Search API

This API can be utilized to conduct searches employing a variety of parameters.

https://app.ylytic.com/ylytic/admin/api/v1/search?type=discovery&skip=0&limit=12&handle=&connector=&location=&country=&followers=&er=&posts&category=&contact=

curl --location 'https://app.ylytic.com/ylytic/admin/api/v1/search?type=discovery&skip=0&limit=20&handle=&connector=&location=&country=&followers=&er=&posts=null&category=&contact=null' \
--header 'Authorization: Bearer <request-token-from-ylytic-team>'

ATTRIBUTES	DESCRIPTION	Expected Values (marked in bold)
handle	To search for a particular creator using their social handle.	For IG: username ; For YT/TikTok: @username
connector	To search for creators on a particular social platform.	instagram, youtube or tiktok
location	To search for creators from a particular city.	creator city
country	To search for creators from a particular country.	creator country
tier	To search for creators from a particular influencer tier.	0 - 1k: early ; 1k - 10k: nano ; 10k - 100k: micro ; 100k - 250k: lower-mid ; 250k - 500k: upper-mid ; 500k - 1M: macro ; 1M - 5M : mega ; 5M+ : celebrity
er	To search for creators with a particular engagement rate.	0 - 1%: vlow ; 1 - 3%: low ; 3 - 5%: micro ; 5 - 7%: mid ; 7 - 10%: macro ; 10 - 15%: high ; 15%+: vhigh
posts	To search for creators with a particular post count.	1 - 50: low ; 50 - 200: micro ; 200 - 500: mid ; 500+: macro
category	To search for creators from a particular category.	Art & Design, Automobiles, Beauty & Hygiene, Books & Writing, Business & Entrepreneurship, Cinema & Entertainment, Family & Relationships, Fashion, Finance, Food & Beverages, Gaming, Health & Fitness, Home & Lifestyle, Learning & Education, Infotainment, Vloggers & Bloggers, Politics, Non Profits, Fan Pages, Motivational, Music & Dance, News & Journalism, Parenting, Photography, Religion & Spirituality, Sports, Technology, Travel & Adventure, Work & Career
bio	To search for creators basis keywords mentioned in their bio.	keyword; for eg: crypto
contact	Search for creators based on the availability of their contact details.	email, phone, either, both
average_views_range	Search for creators based on the average views on their latest videos.	0-10000, 10000-50000, 50000-100000, 100000-500000, 500000-1000000
pqs_range	Search for creators based on the profile quality score.	0-25, 25-50, 50-75, 75-100
efr_range	Search for creators based on the effective follower rate.	0-1, 1-3, 3-5, 5-7, 7-10, 10-15
hashtags	Search for creators based on the hashtags used in their latest videos.	#hashtagname
brand_mentions	Search for creators based on the brand mentioned in their latest videos.	@brandname
gender	Search for creators based on their gender.	male, female, n/a
agegroup	Search for creators based on their age-group.	13-17, 18-24, 25-34, 35-44, 45-54, 55-64, 65-

OUTPUT (JSON)

{
    "objects": [
        {
            "_id": "643fb9a428d6d9d3861fe829",
            "connector": "instagram",
            "handle": "the.rebel.kid",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/d26b8a57-192a-45bc-a5fd-874862005931.jpg",
            "handle_link": "https://instagram.com/the.rebel.kid",
            "insights_link": "-",
            "followers": 1331337,
            "engagement": 13.76,
            "posts": 846,
            "category": "Fashion",
            "audience": null,
            "full_name": "Apoorva",
            "average_views": 3135747,
            "gender": "female",
            "age_group": "35-44",
            "effective_follower_rate": 180.5,
            "quality": {
                "profile_quality_score": 100,
                "profile_quality_rating": 4
            },
            "interests": [],
            "location": "Mumbai",
            "country": "India",
            "hasEmail": true,
            "hasPhone": false,
            "createdDate": "Wed, 19 Apr 2023 09:51:32 GMT",
            "refreshedDate": "Wed, 17 Apr 2024 22:46:50 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": true
        },
        {
            "_id": "63f0b9858b8f0e0e8925d657",
            "connector": "instagram",
            "handle": "aashnashroff",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/890fbf1c-dbaf-4f79-86c6-1b108da34cc2.jpg",
            "handle_link": "https://instagram.com/aashnashroff",
            "insights_link": "-",
            "followers": 1014045,
            "engagement": 9.24,
            "posts": 6128,
            "category": "Fashion",
            "audience": null,
            "full_name": "Aashna Shroff",
            "average_views": 21030716,
            "gender": "unknown",
            "age_group": "unknown",
            "effective_follower_rate": 87.1,
            "quality": {
                "profile_quality_score": 92,
                "profile_quality_rating": 4
            },
            "interests": [],
            "location": "Jaipur",
            "country": "India",
            "hasEmail": true,
            "hasPhone": false,
            "createdDate": "Sat, 18 Feb 2023 11:41:57 GMT",
            "refreshedDate": "Wed, 17 Apr 2024 16:42:05 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": true
        },
        {
            "_id": "63f0b93c8b8f0e0e8925cb49",
            "connector": "instagram",
            "handle": "nitibhakaul",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/05756ecf-8365-4fde-a0ee-942b82fa3ac9.jpg",
            "handle_link": "https://instagram.com/nitibhakaul",
            "insights_link": "-",
            "followers": 1015115,
            "engagement": 0.41,
            "posts": 4422,
            "category": "Fashion",
            "audience": null,
            "full_name": "Nitibha Kaul",
            "average_views": 232522,
            "gender": "male",
            "age_group": "35-44",
            "effective_follower_rate": 13.8,
            "quality": {
                "profile_quality_score": 50,
                "profile_quality_rating": 2
            },
            "interests": [],
            "location": "Delhi",
            "country": "India",
            "hasEmail": true,
            "hasPhone": false,
            "createdDate": "Sat, 18 Feb 2023 11:40:44 GMT",
            "refreshedDate": "Tue, 16 Apr 2024 08:22:50 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": true
        },
        {
            "_id": "63f0b9708b8f0e0e8925d3a6",
            "connector": "instagram",
            "handle": "masoomminawala",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/4f5d96d6-2ba7-4582-8e98-8af6c32aff3d.jpg",
            "handle_link": "https://instagram.com/masoomminawala",
            "insights_link": "-",
            "followers": 1396634,
            "engagement": 1.86,
            "posts": 5510,
            "category": "Fashion",
            "audience": null,
            "full_name": "Masoom Minawala Mehta",
            "average_views": 1256530,
            "gender": "female",
            "age_group": "25-34",
            "effective_follower_rate": 41.1,
            "quality": {
                "profile_quality_score": 67,
                "profile_quality_rating": 3
            },
            "interests": [],
            "location": "Mumbai",
            "country": "India",
            "hasEmail": false,
            "hasPhone": false,
            "createdDate": "Sat, 18 Feb 2023 11:41:36 GMT",
            "refreshedDate": "Mon, 15 Apr 2024 18:53:06 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": true
        },
        {
            "_id": "643fb99e28d6d9d3861fe780",
            "connector": "instagram",
            "handle": "anusmritisarkarofficial",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/74cfa2e6-7ffd-4e42-bb6e-cbae34b081dd.jpg",
            "handle_link": "https://instagram.com/anusmritisarkarofficial",
            "insights_link": "-",
            "followers": 4309494,
            "engagement": 0.82,
            "posts": 1119,
            "category": "Fashion",
            "audience": null,
            "full_name": "Anusmriti Sarkar ✨🧿",
            "average_views": 135033,
            "gender": "female",
            "age_group": "25-34",
            "effective_follower_rate": 2.9,
            "quality": {
                "profile_quality_score": 42,
                "profile_quality_rating": 2
            },
            "interests": [],
            "location": "Mumbai",
            "country": "India",
            "hasEmail": true,
            "hasPhone": false,
            "createdDate": "Wed, 19 Apr 2023 09:51:26 GMT",
            "refreshedDate": "Tue, 09 Apr 2024 17:42:07 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": false
        },
        {
            "_id": "63f078168b8f0e0e8925c0b3",
            "connector": "instagram",
            "handle": "jinal.j.j",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/22434cd9-91be-43b1-8fd2-8f16b0d02c5e.jpg",
            "handle_link": "https://instagram.com/jinal.j.j",
            "insights_link": "-",
            "followers": 1172488,
            "engagement": 2.27,
            "posts": 869,
            "category": "Fashion",
            "audience": null,
            "full_name": "Jinal Joshi",
            "average_views": 680413,
            "gender": "female",
            "age_group": "18-24",
            "effective_follower_rate": 34.3,
            "quality": {
                "profile_quality_score": 67,
                "profile_quality_rating": 3
            },
            "interests": [],
            "location": "Mumbai",
            "country": "India",
            "hasEmail": true,
            "hasPhone": false,
            "createdDate": "Sat, 18 Feb 2023 07:02:46 GMT",
            "refreshedDate": "Tue, 09 Apr 2024 17:42:07 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": false
        },
        {
            "_id": "644256fe9896aa8d8246aabc",
            "connector": "instagram",
            "handle": "xeniaadonts",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/657fbf99-f07d-4308-aeb3-1a48351d359e.jpg",
            "handle_link": "https://instagram.com/xeniaadonts/",
            "insights_link": "https://app.ylytic.com/ig-3p-insights?id=xeniaadonts",
            "followers": 2124720,
            "engagement": 0.56,
            "posts": 5176,
            "category": "Fashion",
            "audience": {
                "location": "Mumbai",
                "gender": "female",
                "ageGroup": "25-34"
            },
            "full_name": "",
            "average_views": null,
            "gender": null,
            "age_group": null,
            "effective_follower_rate": null,
            "quality": {
                "profile_quality_score": null,
                "profile_quality_rating": null
            },
            "interests": [],
            "location": "Mumbai",
            "country": "India",
            "hasEmail": false,
            "hasPhone": false,
            "createdDate": "Fri, 21 Apr 2023 09:27:26 GMT",
            "refreshedDate": "Fri, 21 Apr 2023 09:27:42 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": false
        },
        {
            "_id": "63ef6cf75af965c958a2ef1d",
            "connector": "instagram",
            "handle": "thatbohogirl",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/f416b855-7fc0-448e-91b8-0a64d49f18e8.jpg",
            "handle_link": "https://instagram.com/thatbohogirl",
            "insights_link": "-",
            "followers": 1887477,
            "engagement": 2.04,
            "posts": 6630,
            "category": "Fashion",
            "audience": null,
            "full_name": "Kritika Khurana",
            "average_views": 657195,
            "gender": "female",
            "age_group": "25-34",
            "effective_follower_rate": 40.3,
            "quality": {
                "profile_quality_score": 67,
                "profile_quality_rating": 3
            },
            "interests": [],
            "location": "Delhi",
            "country": "India",
            "hasEmail": true,
            "hasPhone": false,
            "createdDate": "Fri, 17 Feb 2023 12:03:03 GMT",
            "refreshedDate": "Wed, 17 Apr 2024 16:44:40 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": true
        },
        {
            "_id": "64869596b9a9dcdafbce865d",
            "connector": "instagram",
            "handle": "shams_reza335",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/3687bff0-d8d1-41fc-b073-ebcca15fffd5.jpg",
            "handle_link": "https://instagram.com/shams_reza335/",
            "insights_link": "https://app.ylytic.com/ig-3p-insights?id=shams_reza335",
            "followers": 3884205,
            "engagement": 0.19,
            "posts": 70,
            "category": "Fashion",
            "audience": null,
            "full_name": "",
            "average_views": null,
            "gender": null,
            "age_group": null,
            "effective_follower_rate": null,
            "quality": {
                "profile_quality_score": null,
                "profile_quality_rating": null
            },
            "interests": [],
            "location": "Delhi",
            "country": "India",
            "hasEmail": false,
            "hasPhone": false,
            "createdDate": "Mon, 12 Jun 2023 03:48:39 GMT",
            "refreshedDate": "Mon, 12 Jun 2023 06:50:18 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": false
        },
        {
            "_id": "642b86101f26535b84884625",
            "connector": "instagram",
            "handle": "styleonair_",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/f3d44c96-ec42-451c-ac6d-c5c66cc8f48d.jpg",
            "handle_link": "https://instagram.com/styleonair_",
            "insights_link": "-",
            "followers": 1412368,
            "engagement": 2.38,
            "posts": 1466,
            "category": "Fashion",
            "audience": null,
            "full_name": "Harsh Ronak Singh",
            "average_views": 221180,
            "gender": "male",
            "age_group": "35-44",
            "effective_follower_rate": 9.8,
            "quality": {
                "profile_quality_score": 50,
                "profile_quality_rating": 2
            },
            "interests": [],
            "location": "Delhi",
            "country": "India",
            "hasEmail": false,
            "hasPhone": false,
            "createdDate": "Tue, 04 Apr 2023 02:06:08 GMT",
            "refreshedDate": "Mon, 15 Apr 2024 18:21:56 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": true
        },
        {
            "_id": "64921c10ead6c4b885d9d92a",
            "connector": "instagram",
            "handle": "yashikaaannand",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/912025b0-d8e2-42d4-909d-c278924e4eaa.jpg",
            "handle_link": "https://instagram.com/yashikaaannand",
            "insights_link": "-",
            "followers": 4156412,
            "engagement": 0.22,
            "posts": 946,
            "category": "Fashion",
            "audience": null,
            "full_name": "Yash 🔱⭐️🌙",
            "average_views": 1325483,
            "gender": "female",
            "age_group": "25-34",
            "effective_follower_rate": 23.3,
            "quality": {
                "profile_quality_score": 58,
                "profile_quality_rating": 2
            },
            "interests": [],
            "location": "Chennai",
            "country": "India",
            "hasEmail": false,
            "hasPhone": false,
            "createdDate": "Tue, 20 Jun 2023 21:37:20 GMT",
            "refreshedDate": "Mon, 15 Apr 2024 19:26:36 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": false
        },
        {
            "_id": "64931244ead6c4b885dad0f8",
            "connector": "instagram",
            "handle": "vishhu_xx",
            "image_link": "https://s3.ap-south-1.amazonaws.com/nudges//tmp/2746abd7-a9fc-4ae1-bf4b-983a93c24f68.jpg",
            "handle_link": "https://instagram.com/vishhu_xx",
            "insights_link": "-",
            "followers": 1781805,
            "engagement": 2.5,
            "posts": 461,
            "category": "Fashion",
            "audience": null,
            "full_name": "Vishal kumar 💫",
            "average_views": 493779,
            "gender": "male",
            "age_group": "25-34",
            "effective_follower_rate": 24.5,
            "quality": {
                "profile_quality_score": 58,
                "profile_quality_rating": 2
            },
            "interests": [],
            "location": "Delhi",
            "country": "India",
            "hasEmail": false,
            "hasPhone": false,
            "createdDate": "Wed, 21 Jun 2023 15:07:48 GMT",
            "refreshedDate": "Mon, 15 Apr 2024 18:19:23 GMT",
            "status": "success",
            "source": "Third",
            "inMyCreators": false
        }
    ]
}