API Docs

v1.0.0Latest
POST

Get Audience Overlap

Retrieve audience overlap between different creators of instagram and tiktok.

Endpoint
POST /ask/audience/overlap
Request Body
JSON payload for checking audience overlap
Field
Type
Required
Description
platform
string
Yes
Social media platform (instagram, tikTok)
handles
array<string>
Yes
List of creator handles to check overlap
Example Request
curl -X POST "https://api.gateway.walee.ai/api/ask/audience/overlap" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform": "instagram", "handles": ["creator1", "creator2"]}'
Success Response
Successful audience overlap retrieval
200OK
{
  "success": true,
  "message": "Audience overlap fetched successfully",
  "payload": {
    "status": true,
    "report_info": {
      "total_followers": 0,
      "total_unique_followers": 0
    },
    "data": [
      {
        "user_id": "string",
        "username": "string",
        "followers": 0,
        "unique_percentage": 0,
        "overlapping_percentage": 0
      }
    ],
    "cost": 0
  }
}
Error Response
Error retrieving audience overlap
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": {}
}