Search UGC Database
search_ugc_databaseInstantly browse the UGC Database: tens of thousands of already-sourced, email-verified Instagram and TikTok creators, with filters for niche, followers, country, state/region, city, language, gender, estimated age, email type, signals (ugc, portfolio, collabs, proven, for_hire), brands worked with, hit rate, median views, creator type, services, portfolio type, content style (on camera, setting, production), brand saturation and stated rate (max_rate_usd). Proven UGC: each creator's proven lists brands they verifiably made UGC for (videos, median and best views) and performance gives their hit rate (share of posts past 10K / 100K views); to hire creators whose UGC already hit, use signals=['proven'] or brands, plus min_hit_rate, and sort='proven' or 'hit_rate'. Stated rates: rate_min_usd (from $X per UGC video, in USD) and rates (item, price, currency, usd, unit) are the creator's own prices from their rate card or portfolio page (self-published, not verified; say so when you quote them), with turnaround_days and portfolio_brands (past clients the page lists, also in claimed_brands and brands_worked); for a budget use max_rate_usd and sort='rate_asc'. Proof post URLs, sample_videos and portfolio_pages stay hidden until unlocked. No search run and no charge; emails stay masked until unlocked. Try this before run_ugc_agent when the user wants creators fast. Pass creator_id to get one creator's full profile. Use unlock_ugc_database_creators to reveal emails, proof posts and sample videos.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uid | No | Optional Firebase uid. Must match the URL uid unless local fallback is enabled. | |
| sort | No | fit (default); proven = verified UGC brand work first; hit_rate = share of posts past 10K views; median_views = median views per post; rate_asc = lowest stated UGC video rate first (creators without one last). | |
| view | No | all (default), net_new = not yet delivered to the user, unlocked = already unlocked. | |
| limit | No | Page size, 1-100 (default 25). | |
| query | No | Word-prefix search over handle, name, niche, labels and bio ('ugc' matches kit.ugc). | |
| tiers | No | starter 0-999, nano 1k-9,999, micro 10k-99,999, mid 100k-499,999, macro 500k+ followers. | |
| brands | No | Worked with any of these brands ('Poppi', 'Cal AI'), verified (proven) or named in their bio; case-insensitive. get_ugc_database_facets lists brand names. | |
| cities | No | Cities the creator says they are based in, English names ('Austin', 'London', 'Mexico City'); case-insensitive. Combine with countries to disambiguate. | |
| cursor | No | The next_cursor from the previous page. Keep the other filters identical. | |
| niches | No | Niche labels or keys; use get_ugc_database_facets for valid values. | |
| genders | No | ||
| regions | No | States or regions the creator says they are based in, English names ('Texas', 'England', 'Ontario'); case-insensitive. Combine with countries to disambiguate. get_ugc_database_facets lists valid values. | |
| signals | No | All must match: ugc wording, portfolio link, brand collabs, engagement stats, untapped (no other brand got this creator), proven (verified UGC made for at least one brand, with proof posts), for_hire (says they take paid UGC work), has_rates (publishes their own rates on a rate card or portfolio page). | |
| services | No | Offers any of these services. | |
| settings | No | Where their recent posts are usually filmed. | |
| age_bands | No | Estimated age band from profile photos and bio (an estimate, not a verified age); unknown = not estimated. | |
| countries | No | ISO alpha-2 codes (GB is read as UK), or 'unknown'. | |
| languages | No | ||
| on_camera | No | Appears on camera in recent posts (no = faceless). | |
| platforms | No | ||
| creator_id | No | A database creator id to fetch one creator. Filters are ignored. | |
| email_kinds | No | ||
| productions | No | Production style of recent posts. | |
| saturations | No | How many brands they already work with: fresh 0, low 1-2, medium 3-5, high 6+. | |
| bearer_token | No | Optional Firebase ID token. Hosted clients normally authenticate with an API key header or ?uid= in the URL instead. | |
| max_rate_usd | No | Budget cap in USD: only creators whose lowest stated UGC video rate (rate_min_usd) is at or below this. Creators who state no rate are excluded. Rates are self-published by the creator, not verified. | |
| min_hit_rate | No | Minimum hit rate: share of the creator's posts with 10,000+ views, as a 0-1 fraction (0.25 = 25%). Creators without post metrics are excluded. | |
| creator_types | No | Account type; ugc_creator and both are creators who make UGC for brands. | |
| max_followers | No | ||
| min_followers | No | ||
| exclude_niches | No | ||
| portfolio_types | No | Where the creator keeps their portfolio, from their links. | |
| min_median_views | No | Minimum median views per post. | |
| added_within_days | No |