Skip to main content
  • Search is free and uses the same filters as the existing Creators API.
  • Use the userIds returned by search to fetch full creator profiles.

​
Base URL

https://www.topyappers.com

​
Authentication

All requests require an API key in the header: 
x-ty-api-key: your-api-key

​
Rate limits

  • 60 requests per minute per API key (returns 429 with Retry-After when exceeded).

​
Workflow

  1. Search creators with filters (free) → returns userIds
  2. Get creators by passing those userIds → returns full creator objects
  3. Paginate with page and perPage

​
1) Search creators (free)

GET /api/v2/creators/search
Headers:
  • x-ty-api-key: your-api-key
Query parameters:
  • Same as the Creators API filters. See the full list in Available Parameters.
  • Defaults: page=1, perPage=10.
curl -X GET "https://www.topyappers.com/api/v2/creators/search?source=instagram&country=France&page=1&perPage=10" \
  -H "x-ty-api-key: $TY_API_KEY"
Example response: 
{
  "message": "OK",
  "params": {
    "page": 1,
    "perPage": 10
  },
  "response": {
    "data": [
      "instagram_57971538386",
      "instagram_58848167468",
      "instagram_52172673568",
      "instagram_74310952606",
      "instagram_47313147334",
      "instagram_1101500353",
      "instagram_67481263644",
      "instagram_67147724287",
      "instagram_54567535596",
      "instagram_9053965104"
    ],
    "page": 1,
    "next_page": 0,
    "total_pages": 10000
  }
}

​
2) Get creators by ID

POST /api/v2/creators/get
Headers:
  • x-ty-api-key: your-api-key
  • Content-Type: application/json
Body: 
{
  "userIds": [
    "instagram_57971538386",
    "instagram_58848167468",
    "instagram_52172673568"
  ]
}

curl -X POST "https://www.topyappers.com/api/v2/creators/get" \
  -H "Content-Type: application/json" \
  -H "x-ty-api-key: $TY_API_KEY" \
  -d '{
    "userIds": [
      "instagram_57971538386",
      "instagram_58848167468",
      "instagram_52172673568"
    ]
  }'
Example creator payload (fields mirror the existing Creators API response): 
{
  "data": [
    {
      "id": "instagram_57971538386",
      "username": "creator_handle",
      "followers": 120000,
      "averageViews": 45000,
      "engagementRate": 3.2,
      "age": "20-29",
      "gender": "female",
      "mainCategory": "fashion",
      "subCategory": "streetwear",
      "bio": "Fashion creator sharing streetwear fits",
      "promotedProducts": ["beef tallow"],
      "nichesToPromote": ["fashion", "streetwear"],
      "country": "France",
      "source": "instagram",
      "email": "[email protected]"
    }
  ]
}
Use next_page from the search response to continue fetching IDs, then call POST /api/v2/creators/get with those IDs to page through profiles.