PyCEPCorreios

API para consulta de CEP do webservice ViaCep

Recursos

Consulta de dados de um endereço a partir do CEP
Consulta de intervalo de CEP a partir de um endereço
Formatação de CEP
Validação de CEP

Documentação

Para mais detalhes sobre a PyCEPCorreios, por gentileza, consulte a documentação oficial:

Documentação online: docs
Documentação PDF: download

Instalação

O PyCEP Correios pode ser facilmente instalado com o comando a seguir:

pip install pycep-correios

Atualmente, a PyCEPCorreios possui suporte para Python 3.5+.

Como usar

Consultar o endereço de um CEP é muito simples com o PyCEPCorreios. Veja os exemplos a seguir:

>>> import pycep_correios

>>> endereco = pycep_correios.get_address_from_cep('37503130')
>>> print(endereco)
{
    'bairro': 'Santo Antônio',
    'cep': '37503130',
    'cidade': 'Itajubá',
    'logradouro': 'Rua Geraldino Campista',
    'uf': 'MG',
    'complemento': '- até 214/215',
}

Como contribuir

Deseja participar do desenvolvimento da PyCepCorreios? Torne-se um contribuidor do PyCEPCorreios! Visite a documentação para verificar a guideline de contribuição:

Veja aqui.

Aviso de bugs, dúvidas e sugestões

Para dúvidas, sugestões e relatórios de bugs, por gentileza, crie uma issue:

Issue Tracker: https://github.com/mstuttgart/pycep-correios/issues

Contribuidores

Agradecimentos aos seguintes contribuidores pelo esforço de fazer a PyCEPCorreios melhor:

Lista de contribuidores: https://github.com/mstuttgart/pycep-correios/graphs/contributors

jonatasoli/pycep-correios