Find creators in a market, a niche and a size
Narrow creator search by country, by niche and by followers
Creator search narrows its list three ways: by market (country), by subject (niches or your own keywords) and by size (min_followers and max_followers). This search asks for coffee creators in the United Kingdom with at least 10,000 followers, priced as a free dry run.
curl "https://www.socialcrawl.dev/v1/prism/creators?keywords=home+espresso&country=GB&min_followers=10000&dry_run=true" \
-H "x-api-key: sc_your_key_here"data.market in the answer says which platforms plan a localized search for the market and which only filter by it.
How do I find creators or influencers in one country?
country takes up to 5 ISO 3166-1 alpha-2 codes. A planned market adds its own search term in its languages and keeps a creator whose declared country or post region is the market; a market is planned on a platform only after a dated measurement shows at least 80% of the delivered creators in the market and at least 10 of them. Any other code, and a planned market on the platforms it is not planned on, filters only, and data.market (its platforms) and _warnings say so; it is never refused. Spain, for example, is planned on YouTube only, so country=ES on TikTok and Instagram keeps the Spanish creators of the searches as sent, and platforms=youtube keeps a run to the localized search.
depth=quick applies country exactly as standard does. A creator's country is the one its profile declares, or on TikTok the region its posts carry in the search that found it; depth=quick still looks up the profile of every delivered creator, and a posts walk is not a country source. So quick keeps and drops by country the same way, with the same unknown_country=drop default; what it skips is the walk, so metrics is null.
| Code | Market | Search term | TikTok | YouTube | |
|---|---|---|---|---|---|
CL | Chile | chile | planned (93% in market, 29 creators, measured 2026-11-01) | planned (95% in market, 20 creators, measured 2026-11-01) | filter only (measured 2026-11-01) |
AR | Argentina | argentina | filter only (measured 2026-11-01) | planned (87% in market, 23 creators, measured 2026-11-01) | filter only (measured 2026-11-01) |
MX | Mexico | méxico | planned (96% in market, 23 creators, measured 2026-11-01) | planned (86% in market, 29 creators, measured 2026-11-01) | filter only (measured 2026-11-01) |
CO | Colombia | colombia | filter only (measured 2026-11-01) | filter only (measured 2026-11-01) | planned (86% in market, 21 creators, measured 2026-11-01) |
PE | Peru | perú | planned (87% in market, 30 creators, measured 2026-11-01) | planned (87% in market, 30 creators, measured 2026-11-01) | planned (82% in market, 22 creators, measured 2026-11-01) |
EC | Ecuador | ecuador | planned (86% in market, 29 creators, measured 2026-11-01) | planned (93% in market, 30 creators, measured 2026-11-01) | planned (81% in market, 26 creators, measured 2026-11-01) |
UY | Uruguay | uruguay | planned (82% in market, 27 creators, measured 2026-11-01) | planned (87% in market, 30 creators, measured 2026-11-01) | filter only (measured 2026-11-01) |
ES | Spain | españa | filter only (measured 2026-11-01) | filter only (measured 2026-11-01) | planned (89% in market, 18 creators, measured 2026-11-01) |
BR | Brazil | brasil | filter only (measured 2026-11-01) | filter only (measured 2026-11-01) | filter only (measured 2026-11-01) |
CA | Canada | canada | filter only (measured 2026-10-31) | filter only (measured 2026-10-31) | planned (91% in market, 11 creators, measured 2026-10-31) |
SG | Singapore | singapore | planned (86% in market, 22 creators, measured 2026-10-31) | planned (100% in market, 20 creators, measured 2026-10-31) | planned (85% in market, 13 creators, measured 2026-10-31) |
MY | Malaysia | malaysia | planned (96% in market, 25 creators, measured 2026-10-31) | planned (90% in market, 30 creators, measured 2026-10-31) | planned (86% in market, 28 creators, measured 2026-10-31) |
PH | Philippines | philippines | filter only (measured 2026-10-31) | planned (86% in market, 21 creators, measured 2026-10-31) | filter only (measured 2026-10-31) |
ID | Indonesia | indonesia | filter only (measured 2026-10-31) | planned (93% in market, 29 creators, measured 2026-10-31) | planned (88% in market, 25 creators, measured 2026-10-31) |
IN | India | india | filter only (measured 2026-10-31) | filter only (measured 2026-10-31) | planned (80% in market, 20 creators, measured 2026-10-31) |
SA | Saudi Arabia | السعودية | filter only (measured 2026-10-31) | filter only (measured 2026-10-31) | filter only (measured 2026-10-31) |
JP | Japan | 日本 | planned (90% in market, 29 creators, measured 2026-10-31) | planned (95% in market, 21 creators, measured 2026-10-31) | planned (93% in market, 28 creators, measured 2026-10-31) |
DE | Germany | deutschland | filter only (measured 2026-10-31) | filter only (measured 2026-10-31) | filter only (measured 2026-10-31) |
FR | France | france | filter only (measured 2026-10-31) | planned (81% in market, 21 creators, measured 2026-10-31) | filter only (measured 2026-10-31) |
IT | Italy | italia | filter only (measured 2026-10-31) | filter only (measured 2026-10-31) | planned (84% in market, 19 creators, measured 2026-10-31) |
NL | Netherlands | nederland | filter only (measured 2026-10-31) | filter only (measured 2026-10-31) | planned (95% in market, 19 creators, measured 2026-10-31) |
TR | Türkiye | türkiye | filter only (measured 2026-10-31) | filter only (measured 2026-10-31) | planned (85% in market, 20 creators, measured 2026-10-31) |
US | United States | united states | filter only (measured 2026-11-01) | filter only (measured 2026-11-01) | filter only (measured 2026-11-01) |
GB | United Kingdom | united kingdom | planned (80% in market, 30 creators, measured 2026-11-01) | filter only (measured 2026-11-01) | filter only (measured 2026-11-01) |
AU | Australia | australia | planned (80% in market, 30 creators, measured 2026-11-01) | planned (82% in market, 11 creators, measured 2026-11-01) | filter only (measured 2026-11-01) |
NZ | New Zealand | new zealand | filter only (measured 2026-11-01) | planned (100% in market, 13 creators, measured 2026-11-01) | filter only (measured 2026-11-01) |
IE | Ireland | ireland | planned (89% in market, 28 creators, measured 2026-11-01) | planned (81% in market, 21 creators, measured 2026-11-01) | filter only (measured 2026-11-01) |
ZA | South Africa | south africa | planned (90% in market, 30 creators, measured 2026-11-01) | planned (94% in market, 16 creators, measured 2026-11-01) | filter only (measured 2026-11-01) |
NG | Nigeria | nigeria | filter only (measured 2026-11-01) | planned (96% in market, 22 creators, measured 2026-11-01) | filter only (measured 2026-11-01) |
KE | Kenya | kenya | planned (80% in market, 30 creators, measured 2026-11-01) | planned (96% in market, 26 creators, measured 2026-11-01) | filter only (measured 2026-11-01) |
AE | United Arab Emirates | united arab emirates | planned (85% in market, 27 creators, measured 2026-11-01) | planned (93% in market, 14 creators, measured 2026-11-01) | filter only (measured 2026-11-01) |
KR | South Korea | 대한민국 | planned (80% in market, 30 creators, measured 2026-11-01) | planned (100% in market, 30 creators, measured 2026-11-01) | planned (84% in market, 25 creators, measured 2026-11-01) |
Niches
niches takes the ids below. A niche is about what a creator posts, never about who the creator is: spirituality_religion finds creators whose posts are about religion. An unknown id is a free 400 with did_you_mean.
| Id | Covers | Not for |
|---|---|---|
beauty_skincare | Makeup, skincare, hair care, nails, fragrance and cosmetic treatments | Clothing and outfits, or general health advice |
fashion_style | Clothing, outfits, shoes, bags, jewellery and personal style | Makeup and skincare, or a shopping haul of mixed household goods |
fitness_workout | Exercise, gym training, running, yoga, pilates and body transformation | Professional sport and matches, or medical and diet advice |
health_wellness | Physical and mental health, nutrition and diet advice, sleep, medicine and medical conditions | Workout routines, or skincare products |
food_cooking | Recipes, cooking, baking, meal prep and drinks made at home | Visiting or reviewing a restaurant or cafe |
food_dining | Restaurants, cafes, bars, street food, food reviews and eating shows | A recipe or cooking at home |
travel | Destinations, trips, hotels, flights, sightseeing and travel tips | A single local restaurant or cafe, or hiking and camping as an activity |
outdoors_adventure | Hiking, camping, fishing, climbing, surfing and other outdoor activities | City trips and hotels, or professional sport |
parenting_family | Pregnancy, babies, raising children, family life and products for children | School study advice for students, or couples without children |
relationships_dating | Dating, couples, marriage, weddings, breakups and relationship advice | Raising children, or celebrity couples |
pets_animals | Pets, pet care, wildlife and animal videos | Farming as a business, or fishing and hunting |
home_interior | Home decor, interior design, furniture, organising, cleaning and home renovation | Plants and gardens, or buying property as an investment |
gardening_plants | Gardening, houseplants, growing vegetables and flowers | Interior decor without plants, or cooking |
diy_crafts | Handmade crafts, knitting, sewing, woodworking, resin and other maker projects | Planners, pens and journaling, or drawing and painting as art |
stationery_journaling | Stationery, pens, notebooks, planners, stickers, journaling and desk setups for writing | Drawing and painting as art, or study advice without stationery |
art_design | Drawing, painting, illustration, graphic design, photography, tattoos and architecture as art | Handmade craft projects, or stationery products |
music | Songs, albums, music releases, concerts, covers, instruments and music production | A dance performed to a song, or news about a musician's private life |
dance | Dance performances, choreography, dance challenges and dance classes | A song release or concert without dancing |
film_tv | Movies, series, dramas, anime, streaming shows, trailers and reviews of them | News about an actor's private life, or video games |
celebrities_fandom | Celebrities, idols, influencers and their fans: fan posts, appearances, gossip and private lives | A review of a song, film or show itself, or professional athletes in a match |
gaming | Video games, consoles, game streaming, esports and tabletop games | Gambling and betting, or phone and computer hardware reviews without games |
comedy_memes | Jokes, sketches, pranks and memes where the humour itself is the subject | A joke that is clearly about another listed subject, such as a gym joke or a cooking fail |
sports | Professional and competitive sport: teams, athletes, matches, leagues, scores and betting on them | Personal workouts and gym training, or esports |
automotive | Cars, motorcycles, trucks, electric vehicles, car care and motorsport | Bicycles for exercise, or travel road trips |
technology | Phones, computers, gadgets, software, apps, artificial intelligence and programming | Video games, or cryptocurrency prices and investing |
business_career | Entrepreneurship, startups, marketing, sales, jobs, workplace and career advice | Personal investing and saving, or school study advice |
finance_investing | Personal finance, saving, stocks, cryptocurrency, property investing, loans and insurance | Running or marketing a business, or discount codes for products |
education_science | Study tips, school and university, exams, language learning, science and history explained | Career advice for working adults, or book reviews |
books_writing | Books, reading recommendations, book reviews, authors, poetry and creative writing | Textbooks and exam study, or journaling with stationery |
news_politics | Current events, politics, elections, government, war, crime and social issues | Celebrity gossip, sport results, or company product news |
spirituality_religion | Religion, faith, prayer, scripture, astrology, tarot and meditation as spiritual practice | Mental health advice, or general motivational quotes |
self_improvement | Motivation, mindset, productivity, habits and inspirational quotes | Religious messages, business tactics, or fitness routines |
shopping_deals | Shopping hauls, product finds, deals, discounts and group buys that mix several kinds of product | A post about one kind of product, which belongs to that product's own subject |
personal_no_niche | A personal moment with no subject a stranger would follow: a selfie, a greeting, a birthday, a mood, a day out with friends | A post that is about any listed subject, even in a personal voice |
other | A clear subject that none of the listed options covers, or text too unclear to tell the subject | A post that fits a listed subject loosely: choose that subject instead |
Choose a size
min_followers is the fewest followers (subscribers on YouTube) a creator may have, and max_followers the most; both are inclusive. Each takes one number or a per-platform map such as youtube:10000,tiktok:50000,default:5000. min_subscribers and max_subscribers are the same fields under YouTube's word. To ask for views rather than followers, add min_median_views, the views of a typical recent post. When you send a size band, reach scores 1 for every creator, so the ranking rests on fit, engagement and activity.
Markets and languages
languages keeps creators who post in those languages, and the searches are written in each market's language. exclude_country names countries never delivered. What country does on each platform, and where a row's country comes from, is under country and region.
How many to ask for
limit is the number of creators to deliver. A run keeps searching toward it within max_credits and says why when it stops short; what comes back explains how. To ask for a thousand creators, follow the quickstart's last step.
