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>