Geolocalização de IP, verificação de e-mails e sinais de risco de login numa única API.
Localize os visitantes do seu site a partir do navegador, consulte endereços IP a partir do seu backend, detete domínios descartáveis e erros de digitação em e-mails de registo e sinalize viagens impossíveis no login — tudo com um único plano e uma única quota mensal de pedidos. O cartão pré-visualiza os dados edge e o enriquecimento local deste pedido de página; não é uma resposta da API.
request.cf216.73.216.231
- Coordenadas
- 39.9612, -82.9988
- Fuso horário
- America/New_York
- Código postal
- 43215
- Continente
- NA
- Rede
- Anthropic, PBC
- ASN
- AS16509
- Moeda
- $ USD
- Indicativo telefónico
- +1
- Nascer / pôr do sol
- 7:49 / 18:42
- Dispositivo
- —
- Segurança
- Indisponível — não verificado
Escolha a API para a sua tarefa
Localize o visitante no seu website
Chame a API de geolocalização do visitante diretamente a partir do navegador com uma chave publicável restrita às suas origens permitidas. Utilize dados aproximados de país e cidade, fuso horário e contexto regional disponível para sugerir uma experiência mais relevante.
Explorar a geolocalização do visitante →Pesquise um IP a partir do seu back-end
Já tem um endereço IP na sua aplicação? Envie-o para o endpoint de pesquisa de IP a partir do seu servidor. Uma chave secreta autentica o pedido, e a resposta contém campos de localização de uma base de dados de geolocalização de IP de terceiros.
Explorar a API de pesquisa de IP →Processe uma lista de endereços IP
Envie até 100 endereços IP num único pedido em lote e receba uma lista ordenada de resultados de pesquisa para relatórios, enriquecimento e outros fluxos de trabalho de back-end. A utilização de pesquisa é medida por IP, não por pedido em lote.
Explorar a pesquisa de IP em lote →Analisar endereços de e-mail no registo
Analise a sintaxe, domínios descartáveis conhecidos, se o domínio tem servidor de correio, prováveis erros de digitação e endereços genéricos, e obtenha um veredicto de aceitar, rever ou rejeitar com os motivos. Chame-a a partir do seu formulário com uma chave publicável, ou analise até 100 endereços por pedido — ou listas de até 100 000 — a partir do seu backend ou do painel.
Explorar a análise de e-mails →Pontuar um novo registo numa só chamada
POST /v1/signup/check combina a análise do e-mail com o país e a rede do IP que se regista, indicadores de VPN, Tor e centro de dados conforme o plano, e a idade do domínio do e-mail, numa pontuação de 0 a 100 e num veredicto com motivos. A pontuação é contexto para a sua decisão, não prova de abuso.
Ver o fluxo contra abuso em registos →Sinalizar viagens impossíveis no login
POST /v1/risk/check compara a localização aproximada do IP de login com a localização anterior guardada do utilizador e devolve a distância, o tempo decorrido, a velocidade implícita e um nível de risco. Pode produzir falsos positivos e não prova a tomada de controlo de uma conta.
Explorar a deteção de viagens impossíveis →Exemplo de integração no navegador e pré-visualização de borda
O exemplo mostra como chamar GET /v1/geo a partir de um navegador. Não foi executado para produzir esta pré-visualização. A localização provém deste pedido de página; o enriquecimento é derivado localmente. Os valores em falta estão indisponíveis, e as verificações de segurança não são executadas.
Pedido de exemplo — não executado
import { WatchIP } from "@digitload/watch-ip-sdk";
const client = new WatchIP("wip_pub_xxxxxxxx");
const { country, city, timezone, currency, callingCode } = await client.getGeo();Pré-visualização do pedido de página — não é uma resposta da API
{
"ip": "216.73.216.231",
"country": "US",
"region": "Ohio",
"regionCode": "OH",
"city": "Columbus",
"postalCode": "43215",
"latitude": 39.96118,
"longitude": -82.99879,
"continent": "NA",
"timezone": "America/New_York",
"isEUCountry": false,
"asn": 16509,
"asOrganization": "Anthropic, PBC",
"currency": {
"code": "USD",
"name": "US Dollar",
"symbol": "$"
},
"callingCode": "+1",
"compliance": {
"isGDPR": false,
"usPrivacyLaw": null,
"isLGPD": false,
"requiresCookieConsent": false,
"dataResidencyZone": "US",
"isEmbargoedCountry": false
},
"locale": {
"suggestedLocale": "en-US",
"measurementSystem": "imperial",
"firstDayOfWeek": 0,
"dateFormat": "MM/DD/YYYY"
},
"sun": {
"sunrise": "2026-10-23T11:49:40.834Z",
"sunset": "2026-10-23T22:42:44.749Z"
},
"holiday": {
"isPublicHolidayToday": false,
"todayHolidayName": null,
"nextHoliday": {
"date": "2026-11-11",
"name": "Veterans Day"
}
},
"age": {
"ageOfMajority": 18,
"drinkingAge": 21,
"adultContentVerificationRequired": true,
"jurisdictionNote": "HB 96 (2025)"
},
"tax": {
"jurisdictionCode": "US-OH",
"taxSystem": "US_SALES_TAX",
"rate": null
},
"userAgent": {
"browser": null,
"browserVersion": null,
"os": null,
"osVersion": null,
"deviceType": "bot"
}
}Geolocalização do visitante e do back-end
Utilize GET /v1/geo no navegador do visitante com uma chave publicável. Utilize GET /v1/lookup/{ip} ou POST /v1/lookup no seu back-end com uma chave secreta para IPs fornecidos.
Um só plano para todas as análises
Geolocalização, consulta de IP e análises de e-mail, registo e viagem impossível consomem a mesma quota mensal de pedidos — um pedido por chamada, por IP ou por endereço analisado. Não há produto separado a comprar, e todos os planos, incluindo o Free, podem emitir ambos os tipos de chave.
Análises de e-mail ao nível do domínio
As análises de e-mail avaliam a sintaxe, se o domínio é descartável e os seus registos de servidor de correio, prováveis erros de digitação e endereços genéricos. Nunca contactam a caixa de correio, pelo que nenhum resultado confirma que um endereço existe ou pode receber e-mails.
Chaves bloqueadas por origem
A sua chave de API é publicável, tal como uma chave da Stripe ou do Google Maps. Os pedidos só são servidos — e o CORS só é concedido — às origens que registar.
Geolocalização de borda (edge)
GET /v1/geo lê dados de localização ao nível da rede para o IP em ligação. A localização por IP é aproximada; o tempo de resposta depende do pedido e das funcionalidades ativadas.
Enriquecimento regional
As respostas de visitante derivam a moeda, o indicativo telefónico, os horários do nascer/pôr do sol e indicações de dispositivo a partir da localização e dos cabeçalhos do pedido. Os campos podem ser nulos quando os dados de origem estão indisponíveis.
Indicações regionais de conformidade
Mapeamentos estáticos de país e região fornecem indicações de conformidade. Não estabelecem obrigações legais nem garantem conformidade.
Negociação de configuração regional, já feita por si
Cada resposta inclui um objeto locale: a configuração regional BCP47 mais adequada (combinando o país do visitante com o cabeçalho Accept-Language do seu navegador, para que um visitante de língua francesa no Canadá receba fr-CA, não fr-FR), mais o sistema de medidas, o primeiro dia da semana e o formato de data — evite reimplementar isto na sua própria camada de i18n.
Calendário de feriados públicos
Cada resposta inclui um objeto holiday: se hoje é feriado público no país do visitante, o seu nome e o próximo feriado — útil para textos de widgets de suporte do tipo "hoje estamos fechados", mensagens de checkout ou lógica de agendamento, cobrindo uma lista selecionada de cerca de 40 países.
Indicações de jurisdição etária
Mapeamentos estáticos fornecem indicações de idade e jurisdição com base na localização aproximada por IP. Não verificam identidade nem idade; confirme os requisitos aplicáveis de forma independente.
Indicações de jurisdição fiscal
Mapeamentos estáticos fornecem contexto fiscal regional. Não são um cálculo de imposto nem substituem um motor fiscal atualizado.
Pacotes de SDK de origem
O repositório inclui clientes de JavaScript/TypeScript, Python, PHP, Go e Flutter/Dart. O suporte de endpoints varia; consulte a documentação e confirme a disponibilidade do pacote antes da instalação.
Sinais de VPN, Tor e rede
Os planos de visitante elegíveis incluem indicadores baseados em listas de VPN, Tor, centro de dados, ameaça e rede sancionada. Um falso alerta significa que não houve correspondência nos dados disponíveis, não que o visitante é seguro. A cobertura de IPv6 é parcial; o Tor em IPv6 não está coberto.
Subdomínios de marca
Os planos Growth e Scale incluem um percurso de configuração de domínio personalizado no painel. A disponibilidade depende da elegibilidade da conta e da configuração bem-sucedida de DNS e SSL; as integrações têm de utilizar o URL base configurado.
Sinal de viagem impossível
POST /v1/risk/check compara a localização aproximada de um IP fornecido com uma base de referência armazenada do utilizador. Pode produzir falsos positivos e não prova a apropriação de conta. Contacte-nos para confirmar disponibilidade e provisionamento.
Compreenda a resposta antes de integrar
As APIs de visitante e de pesquisa servem pedidos diferentes e devolvem dados diferentes. A geolocalização do visitante utiliza a geolocalização de borda (edge) do pedido de ligação e adiciona contexto regional. A pesquisa de IP resolve o endereço que fornecer utilizando uma base de dados de geolocalização de IP de terceiros. As respostas de pesquisa não contêm todo o enriquecimento disponível na geolocalização do visitante — por exemplo, o código postal e o fuso horário não são fornecidos pelo atual conjunto de dados de origem. As análises de e-mail, registo e risco trabalham cada uma com os dados que envia — um endereço, ou um ID de utilizador e um IP — e cada linha abaixo consome a mesma quota mensal de pedidos.
| A sua tarefa | Endpoint | Chave | Foco dos dados |
|---|---|---|---|
| Localizar o visitante do website em ligação | GET /v1/geo | Publicável, restrita por origem | Localização do visitante e contexto regional |
| Pesquisar um único IP fornecido | GET /v1/lookup/{ip} | Chave secreta Bearer | Resultado de localização da base de dados de terceiros |
| Pesquisar vários IPs fornecidos | POST /v1/lookup | Chave secreta Bearer | Até 100 resultados de localização ordenados |
| Analisar um e-mail num formulário de registo | POST /v1/email/validate | Publicável, restrita por origem | Sinais de sintaxe, domínio descartável, servidor de correio e erros de digitação, com um veredicto |
| Analisar e-mails em massa | POST /v1/email/batch, /v1/email/jobs | Chave secreta Bearer | Até 100 por pedido, ou até 100 000 por tarefa de lista assíncrona |
| Pontuar um novo registo | POST /v1/signup/check | Chave secreta Bearer | Pontuação de 0 a 100 a partir de sinais de e-mail, rede IP e idade do domínio |
| Comparar um login com a localização anterior | POST /v1/risk/check | Chave secreta Bearer | Distância, velocidade implícita e indicador de viagem impossível |
Perguntas frequentes
O Watch-IP consegue geolocalizar um endereço IP que eu forneça?
Sim. Utilize a API de pesquisa de IP no lado do servidor com uma chave secreta. O endpoint de visitante no navegador localiza o cliente em ligação e não aceita um IP arbitrário para pesquisar.
Posso utilizar o Watch-IP a partir de JavaScript num navegador?
Utilize a geolocalização do visitante com uma chave publicável configurada para a origem do seu website. As chaves secretas de pesquisa pertencem ao seu back-end e nunca devem aparecer em código do navegador.
A geolocalização de IP é o mesmo que a API de Geolocalização do navegador?
Não. O Watch-IP estima a localização a partir de uma ligação IP. A API de Geolocalização do navegador é um mecanismo separado que pode pedir permissão para a localização fornecida pelo dispositivo.
Posso pesquisar endereços IPv4 e IPv6?
Os endpoints de pesquisa aceitam endereços IPv4 e IPv6 válidos, sujeitos aos registos disponíveis na base de dados. A cobertura de sinais de segurança é uma questão separada e varia consoante o indicador e a versão de IP.
O Watch-IP tem um plano gratuito?
Sim. O plano Free inclui uma quota mensal de pedidos e uma quota menor de consultas de IP; consulte a página de preços para os limites atuais. As análises de e-mail, registo e viagem impossível consomem a mesma quota, sem plano separado.
A análise de e-mail verifica se uma caixa de correio existe?
Não. O Watch-IP analisa a sintaxe, o domínio (listas de descartáveis, registos de servidor de correio, idade) e padrões do endereço como erros de digitação e contas genéricas. Não contacta o servidor de correio, pelo que nenhum resultado confirma que uma caixa de correio existe ou pode receber e-mails.
As análises de e-mail e de risco precisam de um plano separado?
Não. Cada endereço analisado, análise de registo ou de viagem impossível conta como um pedido na mesma quota mensal que as suas chamadas de geolocalização e consulta. Os endpoints de backend usam uma chave secreta emitida no seu painel.
Um falso alerta de segurança significa que o visitante é seguro?
Não. Significa que a verificação não encontrou correspondência nos dados que utiliza. A cobertura em falta, redes não listadas e sinais indisponíveis devem ser considerados separadamente.
Escolha a sua primeira integração
Comece pelo guia de visitantes para um site, pela página do produto de consulta para uma aplicação backend, ou pela análise de e-mail para o seu formulário de registo.