API Documentation
Learn how to integrate with our API to access creator data programmatically.
Getting Started
Our API allows you to programmatically access creator data. To use the API, you'll need an API key which you can find in your profile settings.
Base URL: https://www.topyappers.com/api/v1/creators
Example Usage
Learn how to make API requests with code examples
cURL
curl -X GET "https://www.topyappers.com/api/v1/creators?mainCategory=fashion&followersMin=10000" \ -H "x-ty-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json"
JavaScript
const fetchCreators = async () => {
const response = await fetch(
'https://www.topyappers.com/api/v1/creators?mainCategory=fashion&followersMin=10000',
{
headers: {
'x-ty-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
const data = await response.json();
console.log(data);
};
fetchCreators();Python
import requests
url = "https://www.topyappers.com/api/v1/creators"
params = {
"mainCategory": "fashion",
"followersMin": 10000
}
headers = {
"x-ty-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
}
response = requests.get(url, params=params, headers=headers)
data = response.json()
print(data)Example Response
{
"success": true,
"data": {
"creators": [
{
"id": "12345",
"username": "fashionista",
"platform": "tiktok",
"followers": 1250000,
"engagementRate": 3.2,
"averageViews": 450000,
"mainCategory": "fashion",
"country": "US"
},
// More creators...
],
"pagination": {
"total": 1250,
"page": 1,
"perPage": 20,
"totalPages": 63
}
}
}Need Help?
If you have any questions or need assistance with our API, please don't hesitate to contact me on X.
