Accedi alle API

API gratuite con un insieme fisso di 2.000 città e accesso esteso tramite abbonamento.

Gratis: 60 richieste/minuto e 1.000/giorno/IP. Abbonamenti: 3 €, 8 € o 12 €/mese, vantaggi CAPIT inclusi. Filtri e paginazione non ampliano l’insieme gratuito mondiale.

Scegli il mio abbonamento APIDocumentazione OpenAPI

API · https://api.capit.net

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

Accesso pubblico senza chiave. Accesso esteso con chiave Bearer dell’area membri, conservata solo sul server. Nel browser: token temporaneo legato all’origine emesso dal server con POST /v1/widget-token (5 minuti).

q cerca nomi; country usa il codice ISO; bbox filtra l’area. Operatori per tipo in /v1/cities/schema.

fields seleziona proprietà separate da virgole; sort accetta quattro campi, con - per ordine decrescente.

page parte da 1; pageSize predefinito 10, massimo 100. Export abbonati fino a 1.000; nextCursor sostituisce page con ordinamento -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: parametri non validi; 401: autenticazione non valida; 403: diritti insufficienti; 429: quota esaurita; 503: servizio non disponibile o query costosa.

OpenAPI · Widget · Copia codice 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:'it',pageSize:10,map:true});</script>