Skip to main content

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:
ParameterTypeDescriptionExample
followersMinNumberMinimum number of followersfollowersMin=10000
followersMaxNumberMaximum number of followersfollowersMax=1000000
averageViewsMinNumberMinimum average views per postaverageViewsMin=5000
averageViewsMaxNumberMaximum average views per postaverageViewsMax=500000
engagementRateMinNumberMinimum engagement rate (percentage)engagementRateMin=2.5
engagementRateMaxNumberMaximum engagement rate (percentage)engagementRateMax=10
ageStringAge groupage=20-29,30-39
genderStringGendergender=male
mainCategoryStringMain content category. See categoriesmainCategory=fashion
subCategoryStringSub-category of contentsubCategory=streetwear
bioStringKeywords in creator’s biobio=tiktok shop
promotedProductsStringProducts/Services promoted by the creatorpromotedProducts=beef tallow,feastables
nichesToPromoteStringSuggested niches to promotenichesToPromote=fashion,streetwear
countryStringCreator’s country. See countriescountry=France
sourceStringData Source. See sourcessource=tiktok
usernameStringFilter creators by their handleusername=mrbeast
emailExistsBooleanFilter creators with available emailemailExists=true
emailStringFind creator by email[email protected]
pageNumberPage number for paginationpage=2
perPageNumberNumber of results per pageperPage=50

Categories & Countries

For the full list of available values, see the Enums Reference: 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 products
  • nichesToPromote=skincare,beauty - Find creators in the skincare/beauty space
  • nichesToPromote=fitness supplements - Find creators who promote fitness-related products

Tips

  • Use comma-separated values for multiple items: promotedProducts=beef tallow,feastables
  • nichesToPromote works best as a discovery tool - be creative with your search terms