# Markets, niches and size (/docs/prism/creators-markets) 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. ```bash title="cURL" 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 | Instagram | 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](/docs/data-availability.md#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](/docs/prism/creators-platforms.md#what-comes-back) explains how. To ask for a thousand creators, follow [the quickstart's last step](/docs/prism/creators-quickstart.md#5-ask-for-a-thousand-creators). ## Next steps - [Request fields](/docs/prism/creators.md): Every field, price and error of creator search. - [How each platform is measured](/docs/prism/creators-platforms.md): What each number in a creator row means. - [Follow creators](/docs/prism/creators-follow.md): Save the creators you found and hear when they post.