Youtube API · Discovery Attribute reference

Youtube Profile Location API

Find Youtube profiles by profile location from 13.9M searchable profiles

Is there an API to get Youtube profiles from a specific location?

Yes. The Influencers.club Discovery API filters Youtube creator profiles by where the creator is based. Pass one or more values from a 1,000-entry location dictionary — 180 countries down to city level, like “Austin, Texas, United States” — and get back full profiles with follower counts, engagement rates and verified contact data.

Verified against the live API in Endpoint reference →

How many Youtube profiles this filter returns

Counted on the live search index, not modelled or rounded.

Measured
13,890,173
Searchable Youtube profiles
10,252
Match “Austin, Texas, United States”, the example below
0.07%
Share of the searchable index
1,324
Of those, with 10k+ subscribers
Request

Make the call

Both samples below are complete. Paste one in, swap the key, get a 200.

POST https://api-dashboard.influencers.club/public/v1/discovery/
Auth Authorization: Bearer <API_KEY> Content type application/json Rate 0.01 credits per creator returned Full reference →
curl -X POST https://api-dashboard.influencers.club/public/v1/discovery/ \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "platform": "youtube",
  "filters": { "location": ["Austin, Texas, United States"] },
  "paging": { "limit": 10, "page": 0 },
  "sort": { "sort_by": "relevancy" } }'
import requests

res = requests.post(
    "https://api-dashboard.influencers.club/public/v1/discovery/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
  "platform": "youtube",
  "filters": { "location": ["Austin, Texas, United States"] },
  "paging": { "limit": 10, "page": 0 },
  "sort": { "sort_by": "relevancy" } }, ) print(res.json())
const res = await fetch("https://api-dashboard.influencers.club/public/v1/discovery/", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "platform": "youtube",
  "filters": { "location": ["Austin, Texas, United States"] },
  "paging": { "limit": 10, "page": 0 },
  "sort": { "sort_by": "relevancy" } }), }); const data = await res.json();
$ch = curl_init("https://api-dashboard.influencers.club/public/v1/discovery/");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer YOUR_API_KEY",
  "Content-Type: application/json", ]);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{ "platform": "youtube", "filters": { "location": ["Austin, Texas, United States"] }, "paging": { "limit": 10, "page": 0 }, "sort": { "sort_by": "relevancy" }}');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
body := strings.NewReader(`{
  "platform": "youtube",
  "filters": { "location": ["Austin, Texas, United States"] },
  "paging": { "limit": 10, "page": 0 },
  "sort": { "sort_by": "relevancy" } }`)
req, _ := http.NewRequest("POST", "https://api-dashboard.influencers.club/public/v1/discovery/", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
Response

What comes back

A 200 with the page of creators and your remaining credit balance. Creator values below are elided — field names and types are exactly as published in the API schema.

200 OKJSON
{
  "total": 10252,
  "limit": 10,
  "accounts": [ … ],
  "credits_left": 361.22 }
Response fields 10 always returned · 3 on request
FieldTypeMeaning
Envelope · 4 fields
totalintegerCreators matching the filter set, before paging.
limitintegerPage size, echoed back from the request.
credits_leftstringDecimal balance after this call.
accounts[]arrayThe requested page of creators.
accounts[] · one entry per creator · 6 fields
user_idstringThe creator’s unique platform identifier.
profile.full_namestringDisplay name.
profile.usernamestringHandle on the platform.
profile.picturestringProfile picture URL.
profile.followersintegerFollower count.
profile.engagement_percentfloatEngagement rate relative to followers.

Three more appear conditionally: matched_filters with return_filter_values=true, and applied_filters plus nlp_search when you send a natural-language brief.

Parameters

The spec

Parameter Type Accepted values Behaviour
filters.location array Exact values from the profile location dictionary Several values widen the search — a creator matching any one of them is returned.
platform string instagram · youtube · tiktok · twitch · twitter · onlyfans Required. Selects the platform-specific filter set.
paging.limit / paging.page integer Any positive integer Required. Page numbering starts at 0.
sort.sort_by / sort.sort_order string relevancy · asc / desc Optional. Defaults to descending.
return_filter_values boolean true · false Adds the matched filter values to each creator. Bills 0.03 credits instead of 0.01.

Billing. 0.01 credits per creator returned. If no creators are returned, no credits are deducted. The profile location dictionary endpoint is free.

Recipes

Profile Location is rarely the only filter

Three combinations that people actually send. Every filter below exists today.

Local creators who actually get engagement

City-level reach without the dormant accounts.

filters: {
  "location": ["Austin, Texas, United States"],
  "engagement_percent": { "min": 2 } }

Creators in a market you can contact

A link in bio usually means a route off-platform.

filters: {
  "location": ["United States"],
  "has_link_in_bio": true }

Mid-tier creators in one country

The 10k–100k band, where reply rates hold up.

filters: {
  "location": ["United States"],
  "number_of_followers": { "min": 10000, "max": 100000 } }

Other Youtube data you can access

Youtube API endpoints

Affiliate LinksAI natural-language searchBrand CollabsExclude handlesExclude HashtagsExclude Keywords in Channel DescriptionExclude Keywords in Video DescriptionExclude role-based emailsExcluding keywords in video titlesExclusion lists filterFollower GrowthHas Amazon AffiliatesHas AnchorHas Apple MusicHas BandcampHas BehanceHas Buy Me a CoffeeHas CameoHas CanvaHas ClubhouseHas CommunityHas Community PostsHas DiscordHas DribbbleHas EtsyHas FacebookHas FiverrHas GitHubHas GoFundMeHas GoodreadsHas InstagramHas KakaoHas KickstarterHas Ko-fiHas LinkedInHas LinktreeHas MediumHas OnlyFansHas PatreonHas phone numberHas PinterestHas podcastHas RedbubbleHas ShopifyHas ShopLTKHas ShortsHas SnapchatHas SoundCloudHas SpotifyHas SpringHas StreamlabsHas SubstackHas TelegramHas TikTokHas TumblrHas TwitchHas TwitterHas UdemyHas ViberHas VimeoHas VKHas WeeblyHas WhatsAppHas WixHas YouTubeHashtagsHasYoutube CoursesHasYoutube PodcastHasYoutube StoreIs MonetizingKeywords in Channel DescriptionKeywords in Video DescriptionKeywords in Video TitlesLast Short UploadLast Video UploadLink in bioLink in Channel DescriptionLink in Video DescriptionLive StreamsLookalike / Username SearchMaximum Avg. Views on Long VideosMaximum Avg. Views ShortsMaximum Engagement RateMaximum Estimated IncomeMaximum Number of videosMaximum SubscribersMerch ShopMinimum Avg. Views on Long VideosMinimum Avg. Views ShortsMinimum Engagement RateMinimum Estimated IncomeMinimum Number of videosMinimum Posting FrequencyMinimum SubscribersPersonal websiteProfile GenderProfile LanguageProfile LocationProfile TypeSearch with AI/KeywordsShorts %Streams LiveSubscriber GrowthTagged ProfilesTiktokYoutube MembershipTopicsVerified Profile
Platform coverage

Six platforms with full data, 40+ more in the social graph

Plus Facebook, Pinterest, Reddit, LinkedIn, Discord, Snapchat,
Linktree and 40+ more via connected socials.

FAQ

Frequently asked questions

Which profile Location values are accepted?+

Only exact values from the profile location dictionary. Pull the accepted list from the free classifier endpoint and validate before you search — anything outside it returns zero results rather than a near match.

Where can I find my API key?+

Create a free account. You will find your API key through the API side menu.

How do I find Youtube creator by profile location using your API?+

Simply sign up for free, copy your API key, then POST to the Discovery endpoint with filters.location set. You’ll get Youtube profiles ready to be ingested for your use case.

What are your pricing plans and what do they include?+

Paid plans start at $249/month and use a flexible credit-based model.

Each API call consumes a specific number of credits depending on the endpoint and data depth. You can compare all tiers, credit amounts, and per-endpoint costs in the Pricing section of our API docs.

How can I get in touch with your team?+

Book a time on our calendar to talk to someone from our team and learn about the full capabilities of our API.