Acceder a la API

API gratuita con un conjunto fijo de 2.000 ciudades y acceso ampliado mediante suscripción.

Gratis: 60 solicitudes/minuto y 1.000/día/IP. Suscripciones: 3 €, 8 € o 12 €/mes con ventajas CAPIT. Los filtros y la paginación no amplían el conjunto gratuito mundial.

Elegir mi suscripción APIDocumentación OpenAPI

API · https://api.capit.net

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

Acceso público sin clave. Acceso ampliado con clave Bearer del área de miembro, guardada solo en el servidor. Para navegador: token temporal asociado al origen, emitido por el servidor mediante POST /v1/widget-token (5 minutos).

q busca nombres; country usa un código ISO; bbox filtra el área. Operadores según tipo en /v1/cities/schema.

fields selecciona propiedades separadas por comas; sort admite cuatro campos, con - para orden descendente.

page empieza en 1; pageSize es 10 por defecto, máximo 100. Exportaciones de suscriptor hasta 1.000; nextCursor sustituye page con orden -population.

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: parámetros inválidos; 401: autenticación inválida; 403: permisos insuficientes; 429: cuota agotada; 503: servicio no disponible o consulta costosa.

OpenAPI · Widget · Copiar código 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:'es',pageSize:10,map:true});</script>