Skip to main content
GET
/
api
/
v2
/
creators
/
search
Search creators (free)
curl --request GET \
  --url https://www.topyappers.com/api/v2/creators/search \
  --header 'x-ty-api-key: <api-key>'
{
  "message": "OK",
  "response": {
    "data": [
      "instagram_57971538386",
      "instagram_58848167468"
    ],
    "page": 1,
    "next_page": 0,
    "total_pages": 10000
  },
  "params": {
    "page": 1,
    "perPage": 10
  }
}

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. Free text search

​
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

Search response with userIds

​
message
string
required
Example:

"OK"

​
response
object
required
​
params
object