Renvoie la répartition géographique des abonnés d'un créateur X, classée par pays et par ville. Endpoint d'audience premium à coût de quota plus élevé.
GET
/api/v1/audience/x/geographyConsommation de quota: Chaque requête réussie vers ce point de terminaison déduit 300 unités de quota de votre forfait.
Paramètres de requête
Paramètres obligatoires
| Nom | Emplacement | Type | Description |
|---|---|---|---|
username | query | string | X handle(username) example: nasa |
Champs de réponse
| Nom | Type | Description |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | Data |
Tester
https://openapi.scdata.cc/api/v1/audience/x/geography
Sélectionnez une clé API du tableau de bord
Ajoutez une clé API avant d'envoyer une requête.Ouvrir le tableau de bord
Paramètres de requête
username*Exemple cURL
bash
curl -X GET "https://openapi.scdata.cc/api/v1/audience/x/geography?username=nasa" \-H "Authorization: YOUR_API_KEY"
Exemple de réponse (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%"}}
Cas d'usage
- Campagnes d'entrée sur un marché — Choisissez des créateurs dont l'audience se trouve réellement dans le pays de lancement.
- Promotion de points de vente locaux — Exploitez les données par ville pour trouver des créateurs adaptés aux campagnes régionales ou aux ouvertures de magasins.