Fazer solicitações | Documentação | Reverse WHOIS API | WhoisXML API

Fazer solicitações

API endpoint

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

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 endpoints do WhoisXML APIs 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 variável api_key para enviar cada solicitação. Obtenha sua chave API pessoal na página My products. Se você tiver dúvidas relacionadas à API, entre em contato conosco.

Exemplo de corpo de solicitação POST

{
    "apiKey": "YOUR_API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "punycode": true,
    "basicSearchTerms": {
        "include": [
            "Airbnb, Inc.",
            "US"
        ],
        "exclude": [
            "Europe",
            "EU"
        ]
    }
}

Você pode fornecer até quatro termos de pesquisa de inclusão e exclusão em uma única 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.

O resultado inclui domínios com termos em qualquer um dos campos WHOIS.

Headers

X-Authentication-Token

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

Obtenha sua chave API pessoal na página My products.

Input parameters

apiKey

Required. Obtenha sua chave API pessoal na página My products.

basicSearchTerms.include

Required. Matriz de strings de pesquisa. Todas elas devem estar presentes nos detalhes WHOIS do domínio. Máximo de 4 itens. Não diferencia maiúsculas de minúsculas.

basicSearchTerms.exclude

Optional. Matriz de strings de pesquisa. Todas elas NÃO devem estar presentes nos detalhes WHOIS do domínio. Máximo de 4 itens. Não diferencia maiúsculas de minúsculas.

searchType

Optional. Tipo de pesquisa.

current - pesquisa somente os registros WHOIS atuais.

historic - pesquisa registros WHOIS atuais e históricos.

Acceptable values: current | historic

Default: current

mode

Optional.

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 1 crédito DRS.

Acceptable values: preview | purchase

Default: preview

punycode

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

Acceptable values: false | true

Default: true

includeAuditDates

Opcional. Se for verdadeiro, cada nome de domínio na saída será complementado com as datas de auditoria correspondentes. Observação: o parâmetro altera a saída: matriz de nomes de domínio (se falso) -> matriz de objetos (se verdadeiro) que contém o nome de domínio e as datas de auditoria. datas de auditoria.

Leia mais sobre a API output aqui.

Acceptable values: false | true

Default: false

responseFormat

Optional. Formato de saída da resposta.

Acceptable values: json | xml

Default: json

createdDateFrom

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

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

createdDateTo

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

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

updatedDateFrom

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

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

updatedDateTo

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

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

expiredDateFrom

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

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

expiredDateTo

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

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

searchAfter

Optional. Como cada resposta é limitada a 10.000 registros, é possível recuperar a próxima página usando esse parâmetro. O valor deve ser obtido de nextPageSearchAfter. Todos os nomes de domínio no resultado são classificados pelas datas em que apareceram em nossos bancos de dados em ordem decrescente.

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.