De API gebruiken

Gratis API met een vaste dataset van 2.000 steden en uitgebreide toegang via abonnement.

Gratis: 60 verzoeken/minuut en 1.000/dag/IP. Abonnementen: € 3, € 8 of € 12/maand met CAPIT-voordelen. Filters en paginering vergroten de vaste gratis wereldselectie niet.

Mijn API-abonnement kiezenOpenAPI-documentatie

API · https://api.capit.net

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

Openbaar zonder sleutel. Uitgebreide toegang met Bearer-sleutel uit uw account, uitsluitend op uw server. Browser: tijdelijk, aan de oorsprong gebonden token via uw server en POST /v1/widget-token (5 minuten).

q zoekt namen; country gebruikt ISO; bbox filtert het gebied. Operatoren per type in /v1/cities/schema.

fields kiest kommagescheiden eigenschappen; sort accepteert vier velden, met - voor aflopend.

page begint bij 1; pageSize standaard 10, maximaal 100. Abonnee-export tot 1.000; nextCursor vervangt page bij sortering -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: ongeldige parameters; 401: ongeldige authenticatie; 403: onvoldoende rechten; 429: quotum bereikt; 503: dienst niet beschikbaar of zware query.

OpenAPI · Widget · HTML-code kopiëren

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