API nutzen

Kostenlose API mit einem festen Datensatz von 2.000 Städten; erweiterter Zugriff per Abonnement.

Kostenlos: 60 Anfragen/Minute und 1.000/Tag/IP. Abonnements: 3 €, 8 € oder 12 €/Monat einschließlich CAPIT-Vorteilen. Filter und Seiten erweitern den kostenlosen weltweiten Datensatz nicht.

API-Abonnement wählenOpenAPI-Dokumentation

API · https://api.capit.net

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

Öffentlich ohne Schlüssel. Erweiterter Zugriff mit Bearer-Schlüssel aus dem Mitgliederbereich, ausschließlich serverseitig gespeichert. Im Browser: serverseitig erzeugtes, an die Herkunft gebundenes Token über POST /v1/widget-token (5 Minuten).

q durchsucht Namen; country verwendet ISO-Codes; bbox begrenzt die Fläche. Operatoren nach Datentyp unter /v1/cities/schema.

fields: kommagetrennte Eigenschaften; sort: bis zu vier Felder, - für absteigend.

page beginnt bei 1; pageSize standardmäßig 10, höchstens 100. Abonnentenexporte bis 1.000; nextCursor ersetzt page bei Sortierung -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: ungültige Parameter; 401: ungültige Anmeldung; 403: fehlende Rechte; 429: Kontingent erreicht; 503: Dienst nicht verfügbar oder Abfrage zu aufwendig.

OpenAPI · Widget · HTML-Code kopieren

<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:'de',pageSize:10,map:true});</script>