API Docs

v1.0.0Latest
GET

Get Creator Report

Retrieve creator report for tiktok.

Endpoint
GET /ask/tt/creator/report?handle={handle}
Request Query Parameters
Query parameters for fetching creator report
Field
Type
Required
Description
handle
string
Yes
Handle to fetch report for
Example Request
curl -X GET "https://api.gateway.walee.ai/api/ask/tt/creator/report?handle={handle}" \
  -H "x-api-key: YOUR_API_KEY"
Success Response
Successful creator report retrieval
200OK
{
"success": true,
"message": "Tiktok creator report fetched successfully",
"payload": {
"success": true,
"version": "2",
"report_info": {
"report_id": "string",
"created": "string",
"profile_updated": "string"
},
"user_profile": {
"type": "string",
"user_id": "string",
"sec_uid": "string",
"username": "string",
"url": "string",
"picture": "string",
"fullname": "string",
"description": "string",
"is_verified": true,
"is_hidden": true,
"gender": "string",
"age_group": "string",
"language": {
"code": "string",
"name": "string"
},
"followers": 0,
"posts_count": 0,
"engagements": 0,
"engagement_rate": 0,
"avg_likes": 0,
"avg_comments": 0,
"avg_views": 0,
"avg_shares": 0,
"avg_saves": 0,
"avg_posts4w": 0,
"total_likes": 0,
"stat_history": [
{
"month": "string",
"followers": 0,
"following": 0,
"avg_likes": 0,
"avg_comments": 0,
"avg_views": 0,
"avg_shares": 0,
"avg_saves": 0,
"avg_engagements": 0,
"total_likes": 0
}
],
"stats": [
{
"post_type": "string",
"engagements": 0,
"engagement_rate": 0,
"avg_likes": 0,
"avg_comments": 0,
"avg_views": 0,
"avg_shares": 0,
"avg_saves": 0,
"avg_posts4w": 0,
"stat_history": [
{
"month": "string",
"avg_likes": 0,
"avg_comments": 0,
"avg_views": 0,
"avg_shares": 0,
"avg_saves": 0,
"avg_engagements": 0
}
]
}
],
"geo": {
"country": {
"id": 0,
"name": "string",
"code": "string",
"coords": {
"lat": 0,
"lon": 0
}
}
},
"top_hashtags": [
{
"tag": "string",
"weight": 0
}
],
"relevant_tags": [
{
"tag": "string",
"distance": 0,
"freq": 0
}
],
"similar_users": [
{
"user_id": "string",
"username": "string",
"picture": "string",
"followers": 0,
"fullname": "string",
"url": "string",
"geo": {
"country": {
"id": 0,
"name": "string",
"code": "string",
"coords": {
"lat": 0,
"lon": 0
}
}
},
"is_verified": true,
"engagements": 0,
"stats": [
{
"post_type": "string",
"engagements": 0
}
],
"score": 0
}
],
"top_posts": [
{
"user_id": "string",
"username": "string",
"user_picture": "string",
"user_url": "string",
"type": "string",
"post_id": "string",
"created": "string",
"text": "string",
"duration": 0,
"thumbnail": "string",
"link": "string",
"hashtags": [
"string",
"string",
"string"
],
"stat": {
"likes": 0,
"comments": 0,
"views": 0,
"shares": 0,
"saves": 0
}
}
],
"recent_posts": [
{
"user_id": "string",
"username": "string",
"user_picture": "string",
"user_url": "string",
"type": "string",
"post_id": "string",
"created": "string",
"text": "string",
"duration": 0,
"link": "string",
"hashtags": [
"string",
"string",
"string"
],
"stat": {
"likes": 0,
"comments": 0,
"views": 0,
"shares": 0,
"saves": 0
}
}
]
},
"audience_likers": {
"success": false,
"error": "string"
},
"audience_followers": {
"success": true,
"data": {
"notable_users_ratio": 0,
"audience_reachability": [
{
"code": "string",
"weight": 0
}
],
"audience_genders": [
{
"code": "string",
"weight": 0
}
],
"audience_ages": [
{
"code": "string",
"weight": 0
}
],
"audience_genders_per_age": [
{
"code": "string",
"male": 0,
"female": 0
}
],
"audience_languages": [
{
"code": "string",
"name": "string",
"weight": 0
}
],
"audience_geo": {
"countries": [
{
"id": 0,
"name": "string",
"code": "string",
"weight": 0
}
]
},
"audience_lookalikes": [
{
"user_id": "string",
"username": "string",
"picture": "string",
"followers": 0,
"fullname": "string",
"url": "string",
"geo": {
"country": {
"id": 0,
"name": "string",
"code": "string",
"coords": {
"lat": 0,
"lon": 0
}
}
},
"is_verified": true,
"engagements": 0,
"stats": [
{
"post_type": "string",
"engagements": 0
}
],
"score": 0
}
],
"notable_users": [
{
"user_id": "string",
"username": "string",
"picture": "string",
"followers": 0,
"fullname": "string",
"url": "string",
"geo": {
"country": {
"id": 0,
"name": "string",
"code": "string",
"coords": {
"lat": 0,
"lon": 0
}
}
},
"is_verified": true,
"engagements": 0,
"stats": [
{
"post_type": "string",
"engagements": 0
}
]
}
]
}
},
"audience_commenters": {
"success": false,
"error": "empty_audience"
},
"extra": {
"followers_range": {
"left_number": 0,
"right_number": 0
},
"engagement_rate_histogram": [
{
"max": 0,
"total": 0
}
]
},
"cqs": {
"cqs_value": 0,
"mark": "string",
"value_description": {
"engagement_rate_score": {
"value": 0,
"mark": "string",
"description": "string"
},
"followers_growth_score": {
"value": 0,
"mark": "string",
"description": "string"
},
"likes_growth_score": {
"value": 0,
"mark": "string",
"description": "string"
},
"audience_location_score": {
"value": 0,
"mark": "string",
"description": "string"
},
"audience_reachability_score": {
"value": 0,
"mark": "string",
"description": "string"
},
"followers_credibility_score": {
"value": 0,
"mark": "string",
"description": "string"
}
}
},
"location": "string"
}
}
Error Response
Error retrieving creator report
400Bad Request
{
  "success": false,
  "message": "Failed to fetch creator report"
  "payload": {}
}
Error Response
Unexpected error occurred
500Internal Server Error
{
  "success": false,
  "message": "Something went wrong. Please try again later."
  "payload": {}
}