Cidades-promise NPM

Features

Interface Assíncrona.
Atualizado em tempo-real por se conectar diretamente aos serviços do INEP.
Sempre retorna a resposta rápida.
Possui alta disponibilidade.
Sem limites de uso (rate limits) conhecidos.
Suporte ao Node.js

Como utilizar

Realizando uma consulta

Basta utilizar a sigla do estado como parâmetro, por exemplo o estado da Paraíba:

const cidades = require('cidades-promise');

cidades.getCitiesByState("pb").then((res) => {
    console.log(res);
})
    
// [
//   'AGUA BRANCA',
//   'AGUIAR',
//   'ALAGOA GRANDE',
//   'ALAGOA NOVA',
//    ... more items
// ]

Usando async:

const cidades = require('cidades-promise');

async function getCidades(){
    const response = await cidades.getCitiesByState("pb");
    console.log(response);
}
    
// [
//   'AGUA BRANCA',
//   'AGUIAR',
//   'ALAGOA GRANDE',
//   'ALAGOA NOVA',
//    ... more items
// ]

Quando a Sigla do Estado possui um formato inválido

const cidades = require('cidades-promise');

cidades.getCitiesByState("pbkj").then((res) => {
    console.log(res);
})
    
// {"erro":"Sigla do estado estar incorreta"}

Quando a Sigla do Estado não é encontrada

const cidades = require('cidades-promise');

cidades.getCitiesByState("gg").then((res) => {
    console.log(res);
})
    
// {"erro": "Erro ao buscar cidades"}

Busca Cidades por DDD

const cidades = require('cidades-promise');

cidades.getCitiesByDdd(83).then((res) => {
    console.log(res);
})
    
// {
//   estado: 'PB',
//   cidades: [
//     'Água Branca',
//     'Aguiar',
//     'Alagoa Grande',
//    ... more items
//    ]
// }