Correios CEP allows to find Brazilian addresses by zip code, directly from Correios API. No HTML parsers.

Now you can find address using a proxy.

# Not using a proxy
iex> Correios.CEP.find_address("54250610")
{:ok,
 %Correios.CEP.Address{
   city: "Jaboatão dos Guararapes",
   complement: "",
   neighborhood: "Cavaleiro",
   state: "PE",
   street: "Rua Fernando Amorim",
   zipcode: "54250610"
 }}

# Using a proxy
iex> Correios.CEP.find_address("54250610", proxy: {"myproxyhost", 8888})
{:ok,
 %Correios.CEP.Address{
   city: "Jaboatão dos Guararapes",
   complement: "",
   neighborhood: "Cavaleiro",
   state: "PE",
   street: "Rua Fernando Amorim",
   zipcode: "54250610"
 }}

# Using a proxy with authentication
iex> Correios.CEP.find_address("54250610", proxy: {"myproxyhost", 8888}, proxy_auth: {"myuser", "mypass"})
{:ok,
 %Correios.CEP.Address{
   city: "Jaboatão dos Guararapes",
   complement: "",
   neighborhood: "Cavaleiro",
   state: "PE",
   street: "Rua Fernando Amorim",
   zipcode: "54250610"
 }}

Changelog for version 0.5.0:

Added

• Support for proxy configuration. Issue #7

Changed

• Update dependencies.

Check it out at:

• Hex
• Documentation
• GitHub