Pricing (v1)
The v1 Creators API (GET /api/v1/creators) costs 1 credit per influencer returned.
Available Parameters
Query parameters you can use to filter creator data:| Parameter | Type | Description | Example |
|---|---|---|---|
followersMin | Number | Minimum number of followers | followersMin=10000 |
followersMax | Number | Maximum number of followers | followersMax=1000000 |
averageViewsMin | Number | Minimum average views per post | averageViewsMin=5000 |
averageViewsMax | Number | Maximum average views per post | averageViewsMax=500000 |
engagementRateMin | Number | Minimum engagement rate (percentage) | engagementRateMin=2.5 |
engagementRateMax | Number | Maximum engagement rate (percentage) | engagementRateMax=10 |
age | String | Age group | age=20-29,30-39 |
gender | String | Gender | gender=male |
mainCategory | String | Main content category. See categories | mainCategory=fashion |
subCategory | String | Sub-category of content | subCategory=streetwear |
bio | String | Keywords in creator’s bio | bio=tiktok shop |
promotedProducts | String | Products/Services promoted by the creator | promotedProducts=beef tallow,feastables |
nichesToPromote | String | Suggested niches to promote | nichesToPromote=fashion,streetwear |
country | String | Creator’s country. See countries | country=France |
source | String | Data Source. See sources | source=tiktok |
username | String | Filter creators by their handle | username=mrbeast |
emailExists | Boolean | Filter creators with available email | emailExists=true |
email | String | Find creator by email | [email protected] |
page | Number | Page number for pagination | page=2 |
perPage | Number | Number of results per page | perPage=50 |
Categories & Countries
For the full list of available values, see the Enums Reference:- Categories - 57 available categories
- Countries - 143 available countries
- Sources - tiktok, instagram, youtube
Promoted Products & Niches to Promote
These fields allow you to search for creators based on specific products or niches they’ve mentioned or promoted.promotedProducts
Search for creators who have promoted specific products. For example, if you search for “Beef Tallow”, you’ll get all creators who have mentioned this product in their content. This makes it easy to find creators who have experience promoting products similar to yours.nichesToPromote
This is one of the most powerful filters for finding relevant creators. It’s a free text search that matches against our AI-analyzed niches for each creator. Use this to find creators who would be a good fit for promoting specific types of products or services. For example:nichesToPromote=SaaS- Find creators suitable for promoting software productsnichesToPromote=skincare,beauty- Find creators in the skincare/beauty spacenichesToPromote=fitness supplements- Find creators who promote fitness-related products
Tips
- Use comma-separated values for multiple items:
promotedProducts=beef tallow,feastables nichesToPromoteworks best as a discovery tool - be creative with your search terms