Returns the geographic distribution of a X creator's followers, ranked by country and by city. Premium audience insight endpoint with a higher quota cost.
GET
/api/v1/audience/x/geographyQuota usage: Each successful request to this endpoint deducts 300 quota units from your plan.
Request Parameters
Required Parameters
| Name | In | Type | Description |
|---|---|---|---|
username | query | string | X handle(username) example: nasa |
Response Fields
| Name | Type | Description |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | Data |
Try It
https://openapi.scdata.cc/api/v1/audience/x/geography
Select an API key from Dashboard
Add an API key before sending a request.Go to Dashboard
Query Params
username*cURL Example
bash
curl -X GET "https://openapi.scdata.cc/api/v1/audience/x/geography?username=nasa" \-H "Authorization: YOUR_API_KEY"
Response Example (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"US": "43.99%","IN": "15.07%","GB": "9.76%","CA": "8.63%","AU": "5.18%","DE": "4.41%","FR": "3.79%","MX": "3.66%","BR": "3.16%","JP": "2.35%"}}
Use Cases
- Market entry campaigns — Pick creators whose audience is actually located in the country you are launching in.
- Local-store promotion — Use city-level data to find creators for regional or store-opening campaigns.