Accéder à l’API

Une API gratuite donnant accès à un jeu de données limité à 2 000 villes, avec une extension possible par abonnement.

Gratuit : 60 requêtes/minute et 1 000/jour/IP. Abonnements : 3 €, 8 € ou 12 €/mois, avec les avantages CAPIT. La sélection mondiale gratuite reste fixe, quels que soient les filtres et la pagination.

Choisir mon abonnement APIDocumentation OpenAPI

API · https://api.capit.net

• GET /v1/cities
• GET /v1/cities/schema
• GET /v1/geography
• GET /v1/cities/export
• POST /v1/widget-token

Sans clé pour l’accès public. Pour l’accès étendu : clé Bearer créée dans votre espace membre, conservée uniquement sur votre serveur. Pour un navigateur, votre serveur émet un jeton temporaire lié à son origine via POST /v1/widget-token (5 minutes).

q recherche les noms ; country filtre par code ISO ; bbox filtre la zone. Les opérateurs disponibles sont publiés dans /v1/cities/schema : eq, ne, in, isnull, contains, startswith, gt, gte, lt, lte, between selon le type.

fields choisit les propriétés séparées par des virgules ; sort définit jusqu’à quatre champs, préfixés par - pour l’ordre décroissant.

page commence à 1, pageSize vaut 10 par défaut (100 maximum). Pour les lots abonnés : 1 000 maximum ; nextCursor s’utilise avec le tri -population et remplace page.

curl 'https://api.capit.net/v1/cities?fields=id,name,country,population&pageSize=1&lang=fr'

{
  "data": [
    {
      "id": "778910398",
      "name": "Shanghai",
      "country": "CN",
      "population": 24870895
    }
  ],
  "meta": {
    "total": 2000,
    "page": 1,
    "pageSize": 1,
    "totalPages": 2000,
    "hasMore": true,
    "version": "f1b40a9e97ac9c9af7d2ef6dea6b7b7bce529a4f42236ac881641768a76737d1",
    "tier": "public",
    "publicLimit": 2000
  }
}

400 : paramètres invalides ; 401 : authentification invalide ; 403 : droits insuffisants ; 429 : quota atteint ; 503 : service indisponible ou requête trop coûteuse.

OpenAPI · Widget · Copier le code HTML

<div id="capit-villes"></div>
<script src="https://api.capit.net/assets/cities/affection-cities.js?v=mobile-filters-20261107"></script>
<script>AffectionCities.create({container:'#capit-villes',lang:'fr',pageSize:10,map:true});</script>