Skip to main content
GET
/
api
/
v1
/
creators
cURL
curl --request GET \
  --url https://www.topyappers.com/api/v1/creators \
  --header 'x-ty-api-key: <api-key>'
[
  {
    "id": "<string>",
    "username": "<string>",
    "followers": 123,
    "averageViews": 123,
    "engagementRate": 123,
    "age": "<string>",
    "gender": "<string>",
    "mainCategory": "<string>",
    "subCategory": "<string>",
    "bio": "<string>",
    "promotedProducts": [
      "<string>"
    ],
    "nichesToPromote": [
      "<string>"
    ],
    "country": "<string>",
    "source": "<string>",
    "email": "[email protected]"
  }
]

Authorizations

​
x-ty-api-key
string
header
required

API key for TopYappers API authentication

Query Parameters

​
followersMin
integer

Minimum number of followers

​
followersMax
integer

Maximum number of followers

​
averageViewsMin
integer

Minimum average views per post

​
averageViewsMax
integer

Maximum average views per post

​
engagementRateMin
number<float>

Minimum engagement rate (percentage)

​
engagementRateMax
number<float>

Maximum engagement rate (percentage)

​
age
string

Age group (comma-separated for multiple)

​
gender
enum<string>

Gender. See /reference/enums#gender for values

Available options:
male,
female
​
mainCategory
enum<string>

Main content category. See /reference/enums#categories for all values

Available options:
Arts,
Automotive,
Beauty & Personal Care,
Books & Literature,
Business,
Finance,
Career & Jobs,
Collectibles & Hobbies,
Community,
Ecommerce,
Crafts & DIY,
Culture,
Education,
Technology,
Entertainment,
Environment,
Family,
Parenting,
Fashion,
Film,
Fitness,
Health,
Food,
Gaming,
Gardening & Agriculture,
History,
Home,
Humor,
Law,
Government,
Lifestyle,
Marketing,
Mental Health,
Music,
News & Media,
Outdoors,
Nature,
Pets,
Animals,
Philosophy,
Spirituality,
Photography,
Videography,
Politics,
Relationships,
Religion,
Science,
Self-Improvement,
Shopping,
Social Media,
Social Issues & Activism,
Sports,
Travel,
Vehicles & Transportation,
Virtual Reality,
Weapons & Defense,
Writing,
Kids
​
subCategory
string

Sub-category of content

​
bio
string

Keywords in creator's bio

​
promotedProducts
string

Products/Services promoted by the creator (comma-separated for multiple)

​
nichesToPromote
string

Suggested niches to promote (comma-separated for multiple)

​
country
string

Creator's country. See /reference/enums#countries for all 143 available values

​
source
enum<string>

Data Source. See /reference/enums#sources for values

Available options:
tiktok,
instagram,
youtube
​
username
string

Filter creators by their handle

​
emailExists
boolean

Filter creators with available email

​
email
string<email>

Find creator by email

​
page
integer

Page number for pagination

Required range: x >= 1
​
perPage
integer

Number of results per page

Required range: 1 <= x <= 100

Response

Creators response

​
id
string
required
​
username
string
required
​
followers
integer
​
averageViews
integer
​
engagementRate
number<float>
​
age
string
​
gender
string
​
mainCategory
string
​
subCategory
string
​
bio
string
​
promotedProducts
string[]
​
nichesToPromote
string[]
​
country
string
​
source
string
​
email
string<email>