{
"countryCode": "US",
"postalCode": "90210",
"found": true,
"partialMatch": false,
"count": 1,
"places": [
{
"countryCode": "US",
"postalCode": "90210",
"place": "Beverly Hills",
"region": "California",
"province": "Los Angeles",
"community": null,
"latitude": 34.0901,
"longitude": -118.4065,
"accuracy": "place"
}
],
"attribution": "Postal code data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35344/look+up+a+postal+code&country=Required&/=Required&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"from": {
"countryCode": "ES",
"postalCode": "37007",
"place": "Salamanca",
"region": "Castilla - Leon",
"province": "Salamanca",
"community": "Salamanca",
"latitude": 40.9688,
"longitude": -5.6716,
"accuracy": "place"
},
"to": {
"countryCode": "ES",
"postalCode": "28013",
"place": "Madrid",
"region": "Madrid",
"province": "Madrid",
"community": "Madrid",
"latitude": 40.4187,
"longitude": -3.7076,
"accuracy": "place"
},
"distanceKm": 176.5,
"distanceMiles": 109.7,
"note": "Straight-line (great-circle) distance between postal code centroids.",
"attribution": "Postal code data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35345/distance+between+postal+codes?from=ES:37007&to=ES:28013' --header 'Authorization: Bearer YOUR_API_KEY'
{
"countryCode": "DE",
"postalCode": "10115",
"valid": true,
"places": 1
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35346/validate+a+postal+code?country=DE&code=10115' --header 'Authorization: Bearer YOUR_API_KEY'
{
"count": 121,
"countries": [
{
"countryCode": "AD",
"postalCodes": 7
},
{
"countryCode": "AE",
"postalCodes": 178171
},
{
"countryCode": "AI",
"postalCodes": 1
},
{
"countryCode": "AL",
"postalCodes": 494
},
{
"countryCode": "AR",
"postalCodes": 20260
},
{
"countryCode": "AS",
"postalCodes": 1
},
{
"countryCode": "AT",
"postalCodes": 19225
},
{
"countryCode": "AU",
"postalCodes": 18521
},
{
"countryCode": "AX",
"postalCodes": 37
},
{
"countryCode": "AZ",
"postalCodes": 1186
},
{
"countryCode": "BD",
"postalCodes": 1349
},
{
"countryCode": "BE",
"postalCodes": 2781
},
{
"countryCode": "BG",
"postalCodes": 5304
},
{
"countryCode": "BM",
"postalCodes": 112
},
{
"countryCode": "BR",
"postalCodes": 5525
},
{
"countryCode": "BY",
"postalCodes": 3133
},
{
"countryCode": "CA",
"postalCodes": 1657
},
{
"countryCode": "CC",
"postalCodes": 1
},
{
"countryCode": "CH",
"postalCodes": 4520
},
{
"countryCode": "CL",
"postalCodes": 346
},
{
"countryCode": "CN",
"postalCodes": 2352
},
{
"countryCode": "CO",
"postalCodes": 3681
},
{
"countryCode": "CR",
"postalCodes": 473
},
{
"countryCode": "CX",
"postalCodes": 1
},
{
"countryCode": "CY",
"postalCodes": 1127
},
{
"countryCode": "CZ",
"postalCodes": 15507
},
{
"countryCode": "DE",
"postalCodes": 23300
},
{
"countryCode": "DK",
"postalCodes": 1159
},
{
"countryCode": "DO",
"postalCodes": 544
},
{
"countryCode": "DZ",
"postalCodes": 15951
},
{
"countryCode": "EC",
"postalCodes": 1225
},
{
"countryCode": "EE",
"postalCodes": 5398
},
{
"countryCode": "ES",
"postalCodes": 37867
},
{
"countryCode": "FI",
"postalCodes": 3576
},
{
"countryCode": "FK",
"postalCodes": 1
},
{
"countryCode": "FM",
"postalCodes": 4
},
{
"countryCode": "FO",
"postalCodes": 130
},
{
"countryCode": "FR",
"postalCodes": 51611
},
{
"countryCode": "GB",
"postalCodes": 27450
},
{
"countryCode": "GF",
"postalCodes": 77
},
{
"countryCode": "GG",
"postalCodes": 14
},
{
"countryCode": "GI",
"postalCodes": 1
},
{
"countryCode": "GL",
"postalCodes": 33
},
{
"countryCode": "GP",
"postalCodes": 105
},
{
"countryCode": "GS",
"postalCodes": 1
},
{
"countryCode": "GT",
"postalCodes": 548
},
{
"countryCode": "GU",
"postalCodes": 21
},
{
"countryCode": "HK",
"postalCodes": 1
},
{
"countryCode": "HM",
"postalCodes": 1
},
{
"countryCode": "HN",
"postalCodes": 38
},
{
"countryCode": "HR",
"postalCodes": 6774
},
{
"countryCode": "HT",
"postalCodes": 236
},
{
"countryCode": "HU",
"postalCodes": 3571
},
{
"countryCode": "ID",
"postalCodes": 81058
},
{
"countryCode": "IE",
"postalCodes": 139
},
{
"countryCode": "IM",
"postalCodes": 87
},
{
"countryCode": "IN",
"postalCodes": 155570
},
{
"countryCode": "IO",
"postalCodes": 1
},
{
"countryCode": "IS",
"postalCodes": 195
},
{
"countryCode": "IT",
"postalCodes": 18415
},
{
"countryCode": "JE",
"postalCodes": 5
},
{
"countryCode": "JP",
"postalCodes": 146883
},
{
"countryCode": "KE",
"postalCodes": 890
},
{
"countryCode": "KR",
"postalCodes": 35583
},
{
"countryCode": "LI",
"postalCodes": 13
},
{
"countryCode": "LK",
"postalCodes": 1837
},
{
"countryCode": "LT",
"postalCodes": 21870
},
{
"countryCode": "LU",
"postalCodes": 4519
},
{
"countryCode": "LV",
"postalCodes": 6101
},
{
"countryCode": "MA",
"postalCodes": 1325
},
{
"countryCode": "MC",
"postalCodes": 29
},
{
"countryCode": "MD",
"postalCodes": 1753
},
{
"countryCode": "MH",
"postalCodes": 2
},
{
"countryCode": "MK",
"postalCodes": 220
},
{
"countryCode": "MO",
"postalCodes": 1
},
{
"countryCode": "MP",
"postalCodes": 3
},
{
"countryCode": "MQ",
"postalCodes": 100
},
{
"countryCode": "MT",
"postalCodes": 73
},
{
"countryCode": "MW",
"postalCodes": 491
},
{
"countryCode": "MX",
"postalCodes": 144655
},
{
"countryCode": "MY",
"postalCodes": 2818
},
{
"countryCode": "NC",
"postalCodes": 52
},
{
"countryCode": "NF",
"postalCodes": 1
},
{
"countryCode": "NL",
"postalCodes": 4334
},
{
"countryCode": "NO",
"postalCodes": 5132
},
{
"countryCode": "NR",
"postalCodes": 1
},
{
"countryCode": "NU",
"postalCodes": 1
},
{
"countryCode": "NZ",
"postalCodes": 1738
},
{
"countryCode": "PA",
"postalCodes": 729
},
{
"countryCode": "PE",
"postalCodes": 96943
},
{
"countryCode": "PF",
"postalCodes": 207
},
{
"countryCode": "PH",
"postalCodes": 2317
},
{
"countryCode": "PK",
"postalCodes": 2563
},
{
"countryCode": "PL",
"postalCodes": 72899
},
{
"countryCode": "PM",
"postalCodes": 2
},
{
"countryCode": "PN",
"postalCodes": 1
},
{
"countryCode": "PR",
"postalCodes": 177
},
{
"countryCode": "PT",
"postalCodes": 206942
},
{
"countryCode": "PW",
"postalCodes": 1
},
{
"countryCode": "RE",
"postalCodes": 152
},
{
"countryCode": "RO",
"postalCodes": 37915
},
{
"countryCode": "RS",
"postalCodes": 1155
},
{
"countryCode": "RU",
"postalCodes": 43538
},
{
"countryCode": "SE",
"postalCodes": 18887
},
{
"countryCode": "SG",
"postalCodes": 121154
},
{
"countryCode": "SI",
"postalCodes": 556
},
{
"countryCode": "SJ",
"postalCodes": 8
},
{
"countryCode": "SK",
"postalCodes": 5233
},
{
"countryCode": "SM",
"postalCodes": 26
},
{
"countryCode": "TC",
"postalCodes": 1
},
{
"countryCode": "TH",
"postalCodes": 903
}
],
"_note": "Response truncated for documentation purposes"
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35347/supported+countries' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a API de Código Postal - Pesquisa de CEP em 121 Países API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
Cada ponto de extremidade retorna informações detalhadas sobre códigos postais, incluindo nomes de lugares, regiões, províncias, coordenadas e distâncias entre códigos. O ponto de extremidade de validação confirma se um código postal é válido, enquanto o ponto de extremidade de países suportados lista todos os países e o número de códigos postais disponíveis para cada um
Os campos-chave incluem `countryCode`, `postalCode`, `place`, `region`, `province`, `latitude`, `longitude` e `distanceKm` ou `distanceMiles` Esses campos fornecem detalhes geográficos e administrativos essenciais sobre os códigos postais
Os dados da resposta estão estruturados no formato JSON, com objetos aninhados para lugares e distâncias. Cada ponto de extremidade retorna uma estrutura consistente, facilitando a análise e a utilização dos dados programaticamente
O ponto de extremidade de pesquisa fornece detalhes do local e status de validação o ponto de extremidade de distância calcula distâncias entre códigos postais e o ponto de extremidade de países suportados lista todos os países com suas respectivas contagens de códigos postais
Os usuários podem inserir códigos postais com ou sem espaços e hífens. O endpoint de distância requer dois códigos postais, enquanto o endpoint de validação requer um. O endpoint de consulta aceita um único código postal para informações detalhadas
A precisão dos dados é mantida através da obtenção de informações do GeoNames, que fornece informações geográficas confiáveis. Atualizações regulares e verificações de validação garantem que os dados permaneçam atuais e precisos
Casos de uso típicos incluem serviços baseados em localização planejamento logístico análise demográfica e validação de endereços em aplicativos As empresas podem usar esses dados para melhorar a experiência do cliente e aprimorar a entrega de serviços
Os usuários podem extrair campos específicos como `latitude` e `longitude` para mapeamento usar `distanceKm` para cálculos de viagem ou validar endereços em formulários O formato JSON estruturado permite fácil integração em aplicativos e serviços