Escolha um plano para a API de que precisa

Cada chamada autenticada que passa nas verificações de chave e origem conta como um pedido: uma chamada de geolocalização de visitante, cada IP consultado, cada endereço de e-mail analisado, cada análise de registo e cada análise de viagem impossível. Uma chamada que depois falha a validação de entrada também conta. As chamadas rejeitadas por chave ausente ou inválida, origem não permitida ou limite de taxa por minuto não contam, nem eliminar uma referência de risco ou consultar o estado de uma tarefa de lista de e-mails.

É uma janela fixa de um minuto, alinhada ao minuto do relógio — não uma média móvel. No plano Free, pode fazer até 30 pedidos entre, por exemplo, as 10:32:00 e as 10:32:59; o contador é reposto a zero às 10:33:00. Ultrapassar o limite devolve um HTTP 429 com um cabeçalho Retry-After a indicar quantos segundos faltam até a janela ser reposta. É independente do seu volume mensal de pedidos abaixo — limita a taxa de rajada, não a utilização total. O limite conta chamadas à API, não itens: um lote de até 100 IP ou endereços de e-mail, ou a criação de uma tarefa de lista de e-mails, conta como um único pedido — embora cada IP ou endereço nele continue a contar separadamente para o seu volume mensal de pedidos.

Não desativamos a sua chave automaticamente. Se estiver constantemente perto do limite do seu plano, atualize a qualquer momento a partir do seu painel — sem necessidade de alterar código nem chaves de API.

A geolocalização do visitante lê dados do pedido na edge e deriva o enriquecimento regional localmente, o que mantém o seu custo — e preço — bem abaixo dos níveis equivalentes da maioria dos fornecedores. A pesquisa de IP do lado do servidor está incluída no mesmo plano e preço, em vez de ser vendida separadamente: cada plano inclui tanto um limite de pedidos como uma dotação de pesquisas de IP, ambos retirados do mesmo conjunto mensal partilhado desse plano.

As respostas de geolocalização de visitantes e de consulta de IP incluem enriquecimento regional quando há dados de origem disponíveis. Os planos elegíveis incluem também indicadores de segurança baseados em listas. As análises de e-mail devolvem um resultado separado, ao nível do domínio. A latência varia conforme o pedido e as funcionalidades ativas.

Sim. O GET /v1/geo continua a ser apenas a autopesquisa do visitante, do lado do cliente, resolvendo o IP que está realmente a ligar-se. Para a pesquisa de um IP arbitrário, o GET /v1/lookup/{ip} (individual) e o POST /v1/lookup (em lote, até 100 IP por chamada) são endpoints servidor a servidor, autenticados com uma chave secreta em vez da sua chave publicável — a chave permanece no seu backend e nunca é enviada a um navegador. Ambos baseiam-se numa base de dados de geolocalização de IP de terceiros em vez dos nossos próprios dados de rede em tempo real, com uma estrutura de resposta diferente e sem classificação de precisão relativa verificada — consulte as fontes de dados para o fornecedor específico e a atribuição exigida — e o uso é cobrado por IP pesquisado, retirado do conjunto mensal partilhado do seu plano um-para-um com um pedido de geolocalização (consulte a dotação de pesquisas de IP do seu plano acima para o limite separado do total de pesquisas). Como este endpoint pesquisa IP fornecidos pelo seu cliente em vez do visitante a chamar por iniciativa própria, isto torna a Watch-IP um subcontratante desses dados de terceiros em seu nome — consulte o DPA para saber o que isso significa para as suas próprias obrigações de conformidade.

POST /v1/risk/check compara a localização resolvida por terceiros de um IP fornecido com uma base de referência armazenada do utilizador e devolve um risco baixo/médio/alto e um sinalizador impossibleTravel. Utiliza uma chave secreta Bearer de back-end. Contacte-nos para confirmar disponibilidade, provisionamento e preços; a aplicação independente de um plano de risco e a preparação do checkout ainda não foram verificadas. Alterações de VPN e encaminhamento móvel podem causar falsos positivos.

Sim. POST /v1/email/validate usa uma chave publicável, restrita por origem, para analisar 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 devolve um veredicto de aceitar, rever ou rejeitar com os motivos. A partir do seu backend, POST /v1/email/batch analisa até 100 endereços por chamada, as tarefas de lista tratam até 100 000, e POST /v1/signup/check acrescenta os sinais de rede do IP que se regista. Cada endereço analisado conta como um pedido na quota mensal do seu plano (uma tarefa de lista cobra cada endereço distinto uma só vez). Nenhuma destas análises contacta a caixa de correio, pelo que não verificam a existência, a titularidade nem a entregabilidade de uma caixa.

Depende do tipo de chave. As chaves publicáveis — usadas em GET /v1/geo e POST /v1/email/validate — destinam-se a ficar no código-fonte da página, como uma chave publicável da Stripe ou do Google Maps; o controlo de acesso é a restrição por origem: cada chave só funciona a partir dos domínios que regista, e o CORS só é concedido a uma origem correspondente. As chaves secretas — usadas na consulta de IP, análise de e-mails em massa e análises de registo e viagem impossível — devem ficar no seu backend e nunca aparecer em código do navegador.

Existem pacotes de SDK de origem para JavaScript/TypeScript, Python, PHP, Go e Flutter/Dart. Confirme a disponibilidade no registo e o suporte de endpoints antes de utilizar. GET /v1/geo localiza sempre quem está a chamar em ligação; uma chamada de back-end não localiza o visitante do seu website. Utilize a pesquisa com chave secreta para um IP fornecido.

Sim, mas é opcional (opt-in): adicione ?include=hostname ao pedido (ou include: ["hostname"] no SDK) e a resposta ganha um campo hostname, resolvido através de uma pesquisa PTR por DNS-over-HTTPS. É nulo quando não existe registo PTR. Ao contrário dos campos de enriquecimento sempre ativos acima, isto realiza uma pesquisa de rede real dentro do pedido, pelo que é desativado por predefinição em vez de acrescentar latência a todas as chamadas.

Os planos elegíveis incluem os indicadores baseados em listas isVpn, isTor, isDatacenter, isThreat e isSanctionedNetwork nas respostas de geolocalização de visitantes e de consulta de IP; o Free omite a segurança. O IPv4 suporta correspondência por listas e por ASN. O IPv6 suporta intervalos de VPN, centros de dados e ameaças, além de correspondência por ASN, mas não tem cobertura de Tor. A cobertura em produção depende dos feeds disponíveis. False significa que não houve correspondência nos dados disponíveis, não uma garantia de segurança; estes sinais não são uma triagem de sanções definitiva.

Sim — cada resposta inclui um objeto compliance: isGDPR (UE/EEE + Reino Unido), usPrivacyLaw (a lei estatal dos EUA aplicável, por exemplo CCPA/CPRA ou VCDPA, consoante o estado do visitante), isLGPD (Brasil), um sinalizador derivado requiresCookieConsent, uma dataResidencyZone genérica, e isEmbargoedCountry (embargos de país abrangentes da OFAC). Está incluído sem custo adicional em todos os planos, tal como a moeda e o indicativo telefónico. É um sinal preliminar de jurisdição calculado a partir da localização do visitante, não aconselhamento jurídico — confirme sempre os requisitos de conformidade com o seu próprio advogado.

Sim — cada resposta inclui um objeto locale: suggestedLocale é uma configuração regional BCP47 que combina o país do visitante com o próprio cabeçalho Accept-Language do seu navegador, privilegiando uma língua efetivamente falada nesse local (por exemplo, um Accept-Language de "fr" de um visitante canadiano resulta em "fr-CA", não "fr-FR"), recorrendo à configuração regional predefinida do país quando nada no cabeçalho corresponde. O mesmo objeto também inclui measurementSystem (métrico/imperial), firstDayOfWeek e dateFormat, para que não tenha de derivar novamente as convenções de formatação regional por conta própria. Está incluído sem custo adicional em todos os planos.

Sim — cada resposta inclui um objeto holiday: isPublicHolidayToday, todayHolidayName e nextHoliday (data e nome) para o país do visitante, calculado a partir de uma tabela estática selecionada (atualmente cerca de 40 países — G20 + UE/EEE + Reino Unido), obtida da Nager.Date e atualizada manualmente numa cadência de uma ou duas vezes por ano, e não calculada no momento do pedido. É nulo para países fora dessa lista, e conta apenas feriados públicos nacionais, não observâncias apenas estaduais/provinciais. Incluído sem custo adicional em todos os planos; mais países podem ser adicionados a pedido.

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.