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	`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	`country=France`
`source`	String	Data Source (tiktok/instagram/youtube)	`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=john@example.com`
`page`	Number	Page number for pagination	`page=2`
`perPage`	Number	Number of results per page	`perPage=50`

Main Categories

Available main categories to query: animals • beauty • business • comedy • cooking • dance • education • entertainment • fashion • fitness • food • gaming • health • lifestyle • music • news • pets • sports • tech • travel • other

Subcategories

You can query any subcategory, for example SaaS or AI. Full list of subcategories coming soon…

Promoted Products & Promotion Niches

These fields allow you to search for creators based on specific products or niches they’ve mentioned or promoted. 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. Same works for niches.

How to Use

promotedProducts: Search for creators who have promoted specific products
nichesToPromote: Find creators suitable for promoting in specific niches
Use comma-separated values for multiple items: promotedProducts=beef tallow,feastables

API Documentation

Endpoint Examples

Available Parameters