Documentos avançados da API | 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",
    "advancedSearchTerms": [{
        "field": "RegistrantContact.Organization",
        "term": "Airbnb, Inc.",
        "exactMatch": true
    },
    {
        "field": "RegistrantContact.Country",
        "term": "UNITED STATES"
    }]
}

A pesquisa básica requer menos configuração e produz resultados mais amplos. A pesquisa avançada permite pesquisar em campos específicos do WHOIS.

Você pode fornecer até quatro termos de pesquisa em uma solicitação. Com vários termos de pesquisa, o resultado inclui os domínios que correspondem a todos eles.

O termo de pesquisa inclui um campo exato do registro WHOIS do domínio, um dos seguintes:

Campos comuns

E-mail

Os E-mail permite pesquisar em RegistrantContact.Email, AdminContact.Email, BillingContact.Email, TechContact.Email em uma única consulta.

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

Campos de contato do administrador

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

Campos de contato de faturamento

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

Campos de contato técnico

TechContact.City, TechContact.Country, TechContact.Email, TechContact.Fax, TechContact.FaxExtension, TechContact.Name, TechContact.Organization, TechContact.PostalCode, TechContact.State, TechContact.StreetAddress, TechContact.Telephone, TechContact.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 para pesquisa avançada

Para pesquisa avançada, em vez do bloco basicSearchTerms, use o bloco advancedSearchTerms com o seguinte formato:

advancedSearchTerms.field

Obrigatório. Qual campo WHOIS deve ser pesquisado.

advancedSearchTerms.term

Obrigatório. Cadeia de pesquisa. Não diferencia maiúsculas de minúsculas.

advancedSearchTerms.exactMatch

Opcional. Booleano. Se o campo deve corresponder exatamente ao termo de pesquisa. Se for false, o campo poderá conter um termo de pesquisa como uma substring.

Valores aceitáveis: false | true

Padrão: false

Observe que, atualmente, o parâmetro é compatível apenas com os seguintes campos: RegistrantContact.Name, RegistrantContact.Organization, RegistrantContact.StreetAddress, AdminContact.Name, AdminContact.Organization, AdminContact.StreetAddress, BillingContact.Name, BillingContact.Organization, BillingContact.StreetAddress, TechContact.Name, TechContact.Organization, TechContact.Street

Para todos os outros campos, ele é ignorado e interpretado como true.