Skip to main content
GET
/
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": "jsmith@example.com"
  }
]

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

Minimum engagement rate (percentage)

​
engagementRateMax
number

Maximum engagement rate (percentage)

​
age
string

Age group (comma-separated for multiple)

​
gender
enum<string>

Gender

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

Main content category

Available options:
animals,
beauty,
business,
comedy,
cooking,
dance,
education,
entertainment,
fashion,
fitness,
food,
gaming,
health,
lifestyle,
music,
news,
pets,
sports,
tech,
travel,
other
​
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

​
source
enum<string>

Data Source

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
​
age
string
​
gender
string
​
mainCategory
string
​
subCategory
string
​
bio
string
​
promotedProducts
string[]
​
nichesToPromote
string[]
​
country
string
​
source
string
​
email
string<email>