Skip to main content
POST
Get creators by IDs

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).