Geolocalização por IP
Transforme um endereço IP em uma localização
País, região, cidade, coordenadas, fuso horário, moeda e operadora para IPv4, IPv6 e domínios, em oito idiomas. A resposta vem de bancos de dados GeoLite locais, sem chamada a terceiros.
Somente para empresas e profissionais autônomos
- Consulta de localização 0,40 EUR por 1.000 solicitações bem-sucedidas
/v1/geolocation/213.133.104.1?lang=pt-BR
curl "https://api.flowdata.one/v1/geolocation/213.133.104.1?lang=pt-BR" \
-H "Authorization: Bearer fd_SUA_CHAVE"
{
"status": "success",
"continent": "Europa",
"continentCode": "EU",
"country": "Alemanha",
"countryCode": "DE",
"region": "BY",
"regionName": "Baviera",
"city": "Nuremberga",
"district": null,
"zip": "90403",
"lat": 49.4527,
"lon": 11.0783,
"timezone": "Europe/Berlin",
"offset": 3600,
"currency": "EUR",
"isp": "Hetzner Online GmbH",
"org": "Hetzner Online GmbH",
"as": "AS24940 Hetzner Online GmbH",
"asname": "Hetzner Online GmbH",
"reverse": null,
"mobile": null,
"proxy": null,
"hosting": null,
"query": "213.133.104.1"
}
Resposta real da API.
Endpoints
Os três caminhos retornam o mesmo formato de resposta. O parâmetro lang escolhe o idioma dos nomes de lugares: de, en, es, pt-BR, fr, ja, zh-CN ou ru.
| GET | /v1/geolocation |
Localização do endereço IP que faz a chamada. |
|---|---|---|
| GET | /v1/geolocation/{query} |
Localização de um endereço IPv4 ou IPv6 ou de um domínio. |
| POST | /v1/geolocation/batch |
Até 100 entradas em uma solicitação, cada uma como texto ou objeto com lang e fields próprios. |
O que vem na resposta
-
Local
continent,country,regionName,city,zip,latelonno idioma pedido, com os códigos ISO. -
Hora e moeda
timezone,offsetem segundos ecurrencycomo código ISO. A moeda vem do país. -
Rede
isp,org,aseasnamedo banco GeoLite ASN. -
Vazio significa vazio
O banco não conhece cidade e CEP para todos os endereços, então esses campos podem ficar vazios.
district,reverse,mobile,proxyehostingsão semprenull.
Consultas em lote
Para logs e listas: POST /v1/geolocation/batch recebe um array JSON.
-
Até 100 entradas
Uma entrada é um texto ou um objeto com
langefieldspróprios. A resposta é uma lista na mesma ordem. -
Você paga apenas pelos acertos
Cada entrada com
status: successé cobrada. Entradas inválidas e intervalos privados ou reservados são gratuitos. -
Orçamento de tempo fixo
Os domínios são resolvidos enquanto o orçamento de tempo da solicitação permitir. O que sobrar retorna
status: fail, em vez de travar a solicitação.
Capturas de tela mostram a interface do FlowData em alemão, com os dados de exemplo de uma empresa fictícia.
O que esperar
As consultas são feitas em arquivos GeoLite locais nos nossos servidores, sem chamada a terceiros. Armazenamos os acertos, e o endereço consultado aparece no contador de uso da sua conta.
A geolocalização por IP é uma estimativa. O país costuma estar certo, a cidade nem sempre, e algumas conexões aparecem longe de onde realmente estão.
A API não detecta proxies, VPNs ou redes móveis:
proxy,mobileehostingcontinuamnull.Intervalos privados e reservados não são consultados e respondem com
status: fail.Para endereços e coordenadas, a área certa é Mapas.
This product includes GeoLite Data created by MaxMind, available from https://www.maxmind.com.
Perguntas frequentes
status: success. Um endereço sem resultado, um formato inválido ou um erro não custam nada.