Skip to main content
POST
/
api
/
v2
/
creators
/
get
Get creators by IDs
curl --request POST \
  --url https://api.topyappers.com/api/v2/creators/get \
  --header 'Content-Type: application/json' \
  --header 'x-ty-api-key: <api-key>' \
  --data '
{
  "userIds": [
    "<string>"
  ],
  "user_ids": [
    "<string>"
  ]
}
'
{
  "message": "OK",
  "requestedIds": [
    "<string>"
  ],
  "response": {
    "data": [
      {
        "user_id": "UCECuDLnD9j3y901oNxJFerw",
        "handle": "April Apple Tech",
        "nickname": "April Apple Tech",
        "bio": "Tech review and business content.",
        "source": "youtube",
        "email": null,
        "categories": [
          "Tech Reviews",
          "Gadget Reviews",
          "Smartphone Comparisons",
          "Business Technology"
        ],
        "followers": 2500,
        "following": 0,
        "total_videos": 296,
        "total_likes": 0,
        "avg_views": 35,
        "avg_likes": 3,
        "avg_comments": 1,
        "engagement_rate": 0.11,
        "main_website": null,
        "websites": [],
        "description": null,
        "promoted_products": [
          "DIHRAMS",
          "iphone"
        ],
        "best_promotion_niches": [
          "Consumer Electronics",
          "Mobile Devices",
          "Tech Accessories",
          "Online Retailers",
          "Business Software"
        ],
        "main_category": "Technology",
        "country": "United Arab Emirates",
        "date_created_timestamp": 1775636932.147,
        "avatar_url": "https://images.0xw.app/avatars/creators/bd6493d02eaf43ad9740efa20ec08cd1.png",
        "age": "10-19",
        "gender": "male",
        "account_type": "ugc",
        "race": "black",
        "hair_color": "white",
        "body_complexion": "hulk",
        "language": "english",
        "hashtags": [
          "iphone17",
          "cinimaticvideo",
          "iphoneair",
          "shotoniphone"
        ],
        "uploads_per_week": 0.39,
        "uploads_per_month": 1.66,
        "avg_video_duration_seconds": null,
        "promotions_count": 2,
        "affiliate_posts_count": 0,
        "sponsorship_posts_count": 0
      }
    ],
    "page": 1,
    "next_page": 0,
    "total_pages": 1,
    "total": 123,
    "is_trial": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.topyappers.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-ty-api-key
string
header
required

API key for TopYappers API authentication

Body

application/json

POST body for /api/v2/creators/get. The live gateway accepts userIds (camelCase) or user_ids (snake_case).

​
userIds
string[]
required

Creator ids from search (e.g. youtube_..., instagram_...)

​
user_ids
string[]

Snake_case alias for userIds (same values).

Response

Successful response from the public API (message, echoed requestedIds, and response containing paginated creator objects in snake_case).

Envelope returned by POST /api/v2/creators/get on api.topyappers.com.

​
message
string
required
Example:

"OK"

​
requestedIds
string[]
required

Echo of ids from the request body.

​
response
object
required

Paginated list payload inside response (from the upstream PageResultItem).