Menu

Documentação

API de Geolocalização de IP

Converta endereços IP em cidade, país, fuso horário, moeda e provedor, com rótulos em alemão por padrão.

Geolocalização
https://api.flowdata.one/v1/geolocation
IP único
https://api.flowdata.one/v1/geolocation/{ip}
Lote
https://api.flowdata.one/v1/geolocation/batch

Arquivo OpenAPI desta área

Início rápido

Chave FlowData
Esta API faz parte da FlowData e usa chaves próprias (fd_...), que você cria no dashboard em Chaves de API. Chaves FlowSuite (pk_..., at_...) continuam funcionando, mas recomendamos uma chave FlowData.
Localização em alemão
Todos os rótulos geográficos vêm em alemão por padrão. Use o parâmetro ?lang=en para rótulos em inglês.
Fonte de dados
This product includes GeoLite Data created by MaxMind, available from https://www.maxmind.com. Os dados incluem dados geográficos da GeoNames, licenciados sob CC BY 4.0.

Visão geral

A API de Geolocalização de IP retorna informações geográficas e de rede para endereços IPv4 e IPv6 e domínios:

  • Continente, país, região, cidade, código postal, coordenadas GPS
  • Fuso horário (por exemplo Europe/Berlin) e deslocamento UTC
  • Moeda nacional (código ISO, derivado do país)
  • Provedor, organização, número AS

Os campos district, reverse, mobile, proxy e hosting permanecem na resposta, mas não são mais fornecidos e são sempre null.

Consulta de IP único

GET
/v1/geolocation

Consultar o próprio IP

Identifica o endereço IP do cliente que faz a requisição e responde com seus dados de geolocalização. Somente uma resposta com status: success é cobrada.

Bearer fd_… 0,40 EUR por 1.000 requisições bem-sucedidas

Parâmetros de consulta

Nome Tipo Descrição
lang string Idioma dos rótulos geográficos (padrão de, alternativa en)
curl -X GET "https://api.flowdata.one/v1/geolocation" \
  -H "Authorization: Bearer fd_SUA_CHAVE" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_SUA_CHAVE')
    ->get('https://api.flowdata.one/v1/geolocation');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/geolocation', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/geolocation',
    headers=headers,
)

data = response.json()
{
    "status": "success",
    "continent": "Nordamerika",
    "continentCode": "NA",
    "country": "Vereinigte Staaten",
    "countryCode": "US",
    "region": "CA",
    "regionName": "Kalifornien",
    "city": "Mountain View",
    "district": null,
    "zip": "94043",
    "lat": 37.4192,
    "lon": -122.0574,
    "timezone": "America/Los_Angeles",
    "offset": -25200,
    "currency": "USD",
    "isp": "Google LLC",
    "org": "Google LLC",
    "as": "AS15169 Google LLC",
    "asname": "Google LLC",
    "reverse": null,
    "mobile": null,
    "proxy": null,
    "hosting": null,
    "query": "8.8.8.8"
}
GET
/v1/geolocation/{ip}

Consultar um IP ou domínio específico

Consulta dados de geolocalização de um endereço IPv4, IPv6 ou domínio. Somente uma resposta com status: success é cobrada.

Bearer fd_… 0,40 EUR por 1.000 requisições bem-sucedidas

Parâmetros de caminho

Nome Tipo Descrição
ip string
Obrigatório
IPv4, IPv6 ou domínio, por exemplo 8.8.8.8 ou google.com

Parâmetros de consulta

Nome Tipo Descrição
lang string Idioma (padrão de)
curl -X GET "https://api.flowdata.one/v1/geolocation/8.8.8.8" \
  -H "Authorization: Bearer fd_SUA_CHAVE" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_SUA_CHAVE')
    ->get('https://api.flowdata.one/v1/geolocation/8.8.8.8');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/geolocation/8.8.8.8', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/geolocation/8.8.8.8',
    headers=headers,
)

data = response.json()

Consulta em lote

Até 100 endereços por requisição
Uma requisição leva até 100 endereços IP ou domínios. Cada item com status: success é cobrado; itens com falha são grátis.
POST
/v1/geolocation/batch

Geolocalização em lote

Consulta até 100 endereços IP ou domínios em uma requisição. O corpo da requisição é o próprio array JSON: strings de IP ou objetos no formato {"query":"8.8.8.8","lang":"de"}.

Bearer fd_… 0,40 EUR por 1.000 requisições bem-sucedidas

curl -X POST "https://api.flowdata.one/v1/geolocation/batch" \
  -H "Authorization: Bearer fd_SUA_CHAVE" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '["8.8.8.8", "1.1.1.1"]'
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_SUA_CHAVE')
    ->post('https://api.flowdata.one/v1/geolocation/batch', ['8.8.8.8', '1.1.1.1']);

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/geolocation/batch', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(['8.8.8.8', '1.1.1.1']),
});

const data = await response.json();
import requests

response = requests.post(
    'https://api.flowdata.one/v1/geolocation/batch',
    headers={'Authorization': 'Bearer fd_SUA_CHAVE', 'Accept': 'application/json'},
    json=['8.8.8.8', '1.1.1.1'],
)

data = response.json()
[
    {
        "status": "success",
        "query": "8.8.8.8",
        "country": "Vereinigte Staaten",
        "city": "Mountain View"
    },
    {
        "status": "success",
        "query": "1.1.1.1",
        "country": "Australien",
        "city": "Sydney"
    }
]

Recursos e campos

Dados geográficos

  • Continente e código do continente
  • País e código do país (ISO)
  • Região/estado
  • Cidade
  • Código postal
  • Coordenadas GPS (lat/lon)

Informações de rede

  • Nome do provedor
  • Organização
  • Número AS e nome AS

Não mais fornecidos

Distrito (district), DNS reverso (reverse) e detecção de celular, proxy e hospedagem (mobile, proxy, hosting) continuam na resposta, mas são sempre null.

Uma chave basta para começar.

Crie uma chave e chame a API. As informações do cliente são gratuitas; o restante é cobrado por solicitação bem-sucedida.

Criar chave de API Documentação

O FlowData é destinado exclusivamente a empresas e profissionais autônomos.