Documentação

Todos os dados de um estado

mdx--- title: "Todos os dados de um estado" titleHTML: "Acesse Informações Completas de Qualquer Estado com CountryDataAPI" description: "Explore como obter detalhes abrangentes de qualquer estado utilizando CountryDataAPI, desde dados demográficos até econômicos. Nossa documentação te guia passo a passo no uso efetivo desta poderosa ferramenta para pesquisas ou desenvolvimentos globais." pubDate: 2024-05-01 author: "Roberto Hernando" date: 2024-05-01


Country Data API fornece informações detalhadas sobre +200 países diferentes

HTTP GET

https://api.countrydataapi.com/v1/states

Retorna todos os dados desse estado.

Dependendo dos campos solicitados, haverá 3 tipos de requisições:

  • BÁSICO: São retornados os campos id, state_name, lang Cada estado gastará 1 token

  • NORMAL: É retornado o campo state_cities [Todos os ids e nomes das cidades do estado] Cada cidade gastará 1 token

  • AVANÇADO: É retornado o campo state_zip_codes [Todos os códigos postais da cidade] Cada código postal 1 token

Parâmetros de Consulta


Parâmetro Tipo Descrição
apikey obrigatório, token Chave de autenticação da conta
state obrigatório, id ou string ID do estado ou nome do estado
limitToken opcional, number 1000 (padrão). Número máximo de tokens que você quer gastar nesta requisição
fields opcional, string id,lang,state_name (padrão). Campos esperados na resposta
lang opcional, lang en (padrão). Idioma esperado da resposta

Exemplo de resposta

[
    {
      "id": "8dd25479-067a-43b0-ac4a-8e7faf2bcafb",
      "state_name":"Takhar",
      "lang":"en",
      "state_cities":[
          {
            id: "8dd25476-067a-43b0-ac4b-8e7faf2bcbfb",
            "city_name":"City",
            ...
          }
      ],
      "state_zip_codes": [
          00000,
          000001,
          ...
      ]
    }
]