Aceder à API

API gratuita com um conjunto fixo de 2.000 cidades e acesso alargado por assinatura.

Gratuito: 60 pedidos/minuto e 1.000/dia/IP. Assinaturas: 3 €, 8 € ou 12 €/mês com vantagens CAPIT. Filtros e paginação não ampliam o conjunto gratuito mundial.

Escolher a minha assinatura APIDocumentação OpenAPI

API · https://api.capit.net

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

Acesso público sem chave. Acesso alargado com chave Bearer da área de membro, apenas no servidor. No navegador: token temporário associado à origem, emitido pelo servidor via POST /v1/widget-token (5 minutos).

q pesquisa nomes; country usa ISO; bbox filtra a área. Operadores por tipo em /v1/cities/schema.

fields seleciona propriedades separadas por vírgulas; sort aceita quatro campos, com - para ordem decrescente.

page começa em 1; pageSize predefinido 10, máximo 100. Exportações de assinantes até 1.000; nextCursor substitui page com ordenação -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: autenticação inválida; 403: direitos insuficientes; 429: quota atingida; 503: serviço indisponível ou consulta dispendiosa.

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