Dostęp do API

Bezpłatne API ze stałym zbiorem 2 000 miast i rozszerzonym dostępem w abonamencie.

Bezpłatnie: 60 żądań/minutę i 1 000/dzień/IP. Abonamenty: 3 €, 8 € lub 12 €/miesiąc z korzyściami CAPIT. Filtry i paginacja nie powiększają bezpłatnego zbioru światowego.

Wybierz abonament APIDokumentacja OpenAPI

API · https://api.capit.net

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

Publicznie bez klucza. Rozszerzony dostęp: klucz Bearer z konta, przechowywany wyłącznie na serwerze. W przeglądarce token związany z pochodzeniem, wydawany przez serwer via POST /v1/widget-token (5 minut).

q wyszukuje nazwy; country używa ISO; bbox filtruje obszar. Operatory według typu w /v1/cities/schema.

fields: właściwości oddzielone przecinkami; sort: cztery pola, - dla kolejności malejącej.

page od 1; pageSize domyślnie 10, maksymalnie 100. Eksport abonentów do 1 000; nextCursor zastępuje page przy sortowaniu -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: błędne parametry; 401: błędne uwierzytelnienie; 403: brak uprawnień; 429: limit; 503: usługa niedostępna lub kosztowne zapytanie.

OpenAPI · Widget · Kopiuj kod 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:'pl',pageSize:10,map:true});</script>