Ylytic Documentation
  • Introduction
  • Platform Brief
  • Quick Start Guide
  • FAQs
    • About Ylytic
    • About Ylytic Data and Insights
    • About Ylytic Features and Pricing
  • REST APIs
    • API Overview
      • Third Party API
      • Campaign Tracking API
      • First Party API
      • Realtime Tracking API
      • Data Refresh API
      • Link Tracking API
      • Discovery Search API
      • Shopify Sales Tracking API
  • FEATURES
    • Creator Discovery
      • Discover
      • Select
      • Reachout
    • Creator Insights
      • Profile Overview
      • Audience
      • Engagement
      • Posting Activity
      • Mentions
    • Campaign Insights
      • Stats
      • Audience
      • Posts
    • Collections
    • Ylytic's Collection
    • Link Tracking
    • Shopify Sales Tracking
    • Whitelabel Platform
Powered by GitBook
On this page
  • GET - Discovery Search API
  • OUTPUT (JSON)
  1. REST APIs
  2. API Overview

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 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
        }
    ]
}
PreviousLink Tracking APINextShopify Sales Tracking API

Last updated 8 months ago