Fazer solicitações | Documentação | Registrant Alert API | WhoisXML API

Fazer solicitações

API endpoint

POST https://registrant-alert.whoisxmlapi.com/api/v2
Leva até um minuto para ativar sua conta após o registro.

Observe que os resultados da pesquisa são limitados a 10.000 registros. Se você quiser obter resultados mais relevantes, tente otimizar sua consulta de pesquisa ou usar a pesquisa avançada.

Coleção Postman

O Postman é um aplicativo de desktop e da Web que permite fazer solicitações a uma API a partir de uma interface gráfica de usuário. Recomendamos usar o Postman com os WhoisXML APIs endpoints ao explorar a funcionalidade das APIs, bem como quando estiver solucionando problemas com seu aplicativo.

A coleção WhoisXML API Postman está disponível nos seguintes links:

A coleção inclui um ambiente pré-configurado. Você precisará configurar a api_key para disparar cada solicitação. Obtenha sua chave de API pessoal na página Meus produtos. Se você tiver dúvidas relacionadas à API, fale conosco.

Exemplo de corpo de solicitação POST

{
    "apiKey": "API_KEY",
    "sinceDate": "2019-04-20",
    "mode": "purchase",
    "punycode": true,
    "basicSearchTerms":
    {
        "include": [
            "Airbnb",
            "US"
        ],
        "exclude": [
            "Europe",
            "EU"
        ]
    }
}

Você pode fornecer até quatro termos de pesquisa de inclusão e exclusão em uma solicitação. Com vários termos de pesquisa de inclusão/exclusão, o resultado inclui domínios com todos os termos de inclusão e nenhum dos termos de exclusão.

A saída inclui domínios adicionados ou descartados por registrantes que tenham os termos em qualquer um dos seguintes campos:

Campos de contato do registrador

RegistrantContact.City, RegistrantContact.Country, RegistrantContact.Email, RegistrantContact.Fax, RegistrantContact.FaxExtension, RegistrantContact.Name, RegistrantContact.Organization, RegistrantContact.PostalCode, RegistrantContact.State, RegistrantContact.StreetAddress, RegistrantContact.Telephone, RegistrantContact.TelephoneExtension

Cabeçalhos

X-Authentication-Token

Você pode usar esse cabeçalho ou o parâmetro apiKey para chamadas de API.

Obtenha sua chave de API pessoal na página Meus produtos.

Parâmetros de entrada

apiKey

Obrigatório. Obtenha sua chave de API pessoal na página Meus produtos.

basicSearchTerms.include

Obrigatório. Conjunto de cadeias de caracteres de pesquisa. Todas elas devem estar presentes nos detalhes do registrante do domínio. Máximo de 4 itens. Não diferencia maiúsculas de minúsculas.

basicSearchTerms.exclude

Opcional. Conjunto de cadeias de caracteres de pesquisa. Todas elas NÃO devem estar presentes nos detalhes do registrante do domínio. Máximo de 4 itens. Não diferencia maiúsculas de minúsculas.

sinceDate

Opcional. Data no formato "AAAA-MM-DD".

Allowed dates are in the [Today minus 14 days — Today] interval.

Por padrão, a data de ontem.

Note that the results for yesterday are usually available between 10-12AM UTC.

Se estiver presente, pesquise as atividades descobertas desde a data especificada. Às vezes, há uma latência entre a data real de adição/renovação/expiração e a data em que nosso sistema detectou essa alteração. Recomendamos usar esse campo em suas ferramentas de monitoramento para filtrar alterações diárias.

modo

Opcional.

preview - retorna apenas o número de domínios. Nenhum crédito é deduzido.

purchase (compra ) - retorna a lista real de domínios (limitada a 10.000). 1 solicitação custa 10 créditos DRS.

Valores aceitáveis: preview | purchase

Padrão: preview

punycode

Opcional. Se for verdadeiro, os nomes de domínio na resposta serão codificados em Punycode.

Valores aceitáveis: false | true

Padrão: true

responseFormat

Opcional. Formato de saída da resposta.

Valores aceitáveis: json | xml

Padrão: json

createdDateFrom

Opcional. Data no formato "AAAA-MM-DD".

Se estiver presente, pesquisará os domínios criados após a data especificada.

createdDateTo

Opcional. Data no formato "AAAA-MM-DD".

Se estiver presente, pesquisará os domínios criados antes da data especificada.

updatedDateFrom

Opcional. Data no formato "AAAA-MM-DD".

Se estiver presente, pesquisará os domínios criados após a data especificada.

updatedDateTo

Opcional. Data no formato "AAAA-MM-DD".

Se estiver presente, pesquisará os domínios atualizados antes da data especificada.

expiredDateFrom

Opcional. Data no formato "AAAA-MM-DD".

Se estiver presente, pesquisará os domínios expirados após a data especificada.

expiredDateTo

Opcional. Data no formato "AAAA-MM-DD".

Se estiver presente, pesquisará os domínios expirados antes da data especificada.

Acesso gratuito

Após a inscrição, você recebe automaticamente um plano de assinatura gratuito limitado a 500 créditos DRS.

Limites de uso e limitação de solicitações

O número máximo de solicitações por segundo é 30. Caso o limite seja ultrapassado, suas solicitações subsequentes serão rejeitadas até o próximo segundo.

Essa API também está disponível com um balanceador de carga dedicado e um endpoint premium para permitir consultas mais rápidas como parte de nossos Premium API Services e Enterprise API Packages.

Documentos da API de pesquisa avançada

A pesquisa avançada permite pesquisar em campos concretos do WHOIS.