Skip to main content
HTTPS
Fonte Link
Victor Stafusa
  • 64,9mil
  • 9
  • 120
  • 189
httphttps://viacep.com.br/ws/[cep-a-pesquisar]/[formato]
httphttps://viacep.com.br/ws/[estado]/[cidade]/[string-de-busca]
httphttps://viacep.com.br/ws/76821348/json
httphttps://viacep.com.br/ws/76821348/xml
httphttps://viacep.com.br/ws/01001000/piped
httphttps://viacep.com.br/ws/SP/S%C3%A3o%20Paulo/Vila%20Mariana/json
http://viacep.com.br/ws/[cep-a-pesquisar]/[formato]
http://viacep.com.br/ws/[estado]/[cidade]/[string-de-busca]
http://viacep.com.br/ws/76821348/json
http://viacep.com.br/ws/76821348/xml
http://viacep.com.br/ws/01001000/piped
http://viacep.com.br/ws/SP/S%C3%A3o%20Paulo/Vila%20Mariana/json
https://viacep.com.br/ws/[cep-a-pesquisar]/[formato]
https://viacep.com.br/ws/[estado]/[cidade]/[string-de-busca]
https://viacep.com.br/ws/76821348/json
https://viacep.com.br/ws/76821348/xml
https://viacep.com.br/ws/01001000/piped
https://viacep.com.br/ws/SP/S%C3%A3o%20Paulo/Vila%20Mariana/json
Atualizando a resposta.
Fonte Link
Victor Stafusa
  • 64,9mil
  • 9
  • 120
  • 189

Os formatos aceitos são o json, xml, jsonp, querty e piped (não-documentado).

Nota: Quando esta resposta foi originalmente escrita em 2016, havia também o formato querty, mas a API não os aceita mais. Se tiver interesse, consulte o histórico desta resposta.

httphttps://viacep.com.br/ws/01001000/json?callback=foo

O formato querty é o formato usado em query-strings do tipo GET ou como corpo de requisição de formulários POST. Eis um exemplo:

http://viacep.com.br/ws/01001000/querty

cep=01001-000&logradouro=Pra%C3%A7a+da+S%C3%A9&complemento=lado+%C3%ADmpar&bairro=S%C3%A9&localidade=S%C3%A3o+Paulo&uf=SP&unidade=&ibge=3550308&gia=1004

Os formatos aceitos são o json, xml, jsonp, querty e piped.

http://viacep.com.br/ws/01001000/json?callback=foo

O formato querty é o formato usado em query-strings do tipo GET ou como corpo de requisição de formulários POST. Eis um exemplo:

http://viacep.com.br/ws/01001000/querty

cep=01001-000&logradouro=Pra%C3%A7a+da+S%C3%A9&complemento=lado+%C3%ADmpar&bairro=S%C3%A9&localidade=S%C3%A3o+Paulo&uf=SP&unidade=&ibge=3550308&gia=1004

Os formatos aceitos são o json, xml, jsonp e piped (não-documentado).

Nota: Quando esta resposta foi originalmente escrita em 2016, havia também o formato querty, mas a API não os aceita mais. Se tiver interesse, consulte o histórico desta resposta.

https://viacep.com.br/ws/01001000/json?callback=foo
Busca por endereço, mais informações sobre o formato
Fonte Link
Victor Stafusa
  • 64,9mil
  • 9
  • 120
  • 189
http://viacep.com.br/ws/[cep-a-pesquisar]/json[formato]
http://viacep.com.br/ws/[cep[estado]/[cidade]/[string-ade-pesquisar]/xmlbusca]

Os formatos aceitos são o json, xml, jsonp, querty e piped.

Busca por CEP

Eis aqui um exemplo, para o CEP 76.821-348, em JSON:

http://viacep.com.br/ws/76821348/json
http://viacep.com.br/ws/76821348/xml

O mesmo exemplo para XML:

http://viacep.com.br/ws/76821348/xml

Outros formatos suportados sãoPara o formato JSONP, Pipedbasta adicionar ?callback=nome_da_funcao na URL terminada em JSON. Por exemplo:

http://viacep.com.br/ws/01001000/json?callback=foo

Dá como saída:

foo({
  "cep": "01001-000",
  "logradouro": "Praça da Sé",
  "complemento": "lado ímpar",
  "bairro": "Sé",
  "localidade": "São Paulo",
  "uf": "SP",
  "unidade": "",
  "ibge": "3550308",
  "gia": "1004"
});

O formato piped (campos separados por | e Quertychave separada de valor por :), é assim:

http://viacep.com.br/ws/01001000/piped
cep:01001-000|logradouro:Praça da Sé|complemento:lado ímpar|bairro:Sé|localidade:São Paulo|uf:SP|unidade:|ibge:3550308|gia:1004

O formato querty é o formato usado em query-strings do tipo GET ou como corpo de requisição de formulários POST. Eis um exemplo:

http://viacep.com.br/ws/01001000/querty

cep=01001-000&logradouro=Pra%C3%A7a+da+S%C3%A9&complemento=lado+%C3%ADmpar&bairro=S%C3%A9&localidade=S%C3%A3o+Paulo&uf=SP&unidade=&ibge=3550308&gia=1004

Busca por endereço

Para a busca por endereços, o formato é quase o mesmo que a busca por CEPs (a diferença é que é trazida uma lista de logradouros ao invés de um único logradouro).

Eis aqui um exemplo:

http://viacep.com.br/ws/SP/S%C3%A3o%20Paulo/Vila%20Mariana/json

Eis a saída:

[
  {
    "cep": "04114-050",
    "logradouro": "Praça Lions Clube-Vila Mariana",
    "complemento": "",
    "bairro": "Jardim da Glória",
    "localidade": "São Paulo",
    "uf": "SP",
    "unidade": "",
    "ibge": "3550308",
    "gia": "1004"
  },
  {
    "cep": "04112-015",
    "logradouro": "Praça Comunitária da Vila Mariana",
    "complemento": "",
    "bairro": "Vila Mariana",
    "localidade": "São Paulo",
    "uf": "SP",
    "unidade": "",
    "ibge": "3550308",
    "gia": "1004"
  }
]
http://viacep.com.br/ws/[cep-a-pesquisar]/json
http://viacep.com.br/ws/[cep-a-pesquisar]/xml

Eis aqui um exemplo, para o CEP 76.821-348:

http://viacep.com.br/ws/76821348/json
http://viacep.com.br/ws/76821348/xml

Outros formatos suportados são JSONP, Piped e Querty.

http://viacep.com.br/ws/[cep-a-pesquisar]/[formato]
http://viacep.com.br/ws/[estado]/[cidade]/[string-de-busca]

Os formatos aceitos são o json, xml, jsonp, querty e piped.

Busca por CEP

Eis aqui um exemplo, para o CEP 76.821-348, em JSON:

http://viacep.com.br/ws/76821348/json

O mesmo exemplo para XML:

http://viacep.com.br/ws/76821348/xml

Para o formato JSONP, basta adicionar ?callback=nome_da_funcao na URL terminada em JSON. Por exemplo:

http://viacep.com.br/ws/01001000/json?callback=foo

Dá como saída:

foo({
  "cep": "01001-000",
  "logradouro": "Praça da Sé",
  "complemento": "lado ímpar",
  "bairro": "Sé",
  "localidade": "São Paulo",
  "uf": "SP",
  "unidade": "",
  "ibge": "3550308",
  "gia": "1004"
});

O formato piped (campos separados por | e chave separada de valor por :), é assim:

http://viacep.com.br/ws/01001000/piped
cep:01001-000|logradouro:Praça da Sé|complemento:lado ímpar|bairro:Sé|localidade:São Paulo|uf:SP|unidade:|ibge:3550308|gia:1004

O formato querty é o formato usado em query-strings do tipo GET ou como corpo de requisição de formulários POST. Eis um exemplo:

http://viacep.com.br/ws/01001000/querty

cep=01001-000&logradouro=Pra%C3%A7a+da+S%C3%A9&complemento=lado+%C3%ADmpar&bairro=S%C3%A9&localidade=S%C3%A3o+Paulo&uf=SP&unidade=&ibge=3550308&gia=1004

Busca por endereço

Para a busca por endereços, o formato é quase o mesmo que a busca por CEPs (a diferença é que é trazida uma lista de logradouros ao invés de um único logradouro).

Eis aqui um exemplo:

http://viacep.com.br/ws/SP/S%C3%A3o%20Paulo/Vila%20Mariana/json

Eis a saída:

[
  {
    "cep": "04114-050",
    "logradouro": "Praça Lions Clube-Vila Mariana",
    "complemento": "",
    "bairro": "Jardim da Glória",
    "localidade": "São Paulo",
    "uf": "SP",
    "unidade": "",
    "ibge": "3550308",
    "gia": "1004"
  },
  {
    "cep": "04112-015",
    "logradouro": "Praça Comunitária da Vila Mariana",
    "complemento": "",
    "bairro": "Vila Mariana",
    "localidade": "São Paulo",
    "uf": "SP",
    "unidade": "",
    "ibge": "3550308",
    "gia": "1004"
  }
]
Fonte Link
Victor Stafusa
  • 64,9mil
  • 9
  • 120
  • 189
Carregando