Fazer solicitações | Documentação | Domains & Subdomains Discovery API | WhoisXML API

Fazer solicitações

Endpoint da API

POST https://domains-subdomains-discovery.whoisxmlapi.com/api/v1
Leva até um minuto para ativar sua conta após o registro.

Coleção Postman

O Postman é um aplicativo de desktop e 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 pontos de extremidade das APIs WhoisXML ao explorar a funcionalidade das APIs, bem como quando estiver solucionando problemas com seu aplicativo.

A coleção Postman da API WhoisXML 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, entre em contato conosco.

Exemplo de corpo de solicitação POST: somente domínios (1 crédito DRS)

Retorna apenas os domínios que correspondem aos termos de pesquisa especificados nas zonas de domínio e TLD, excluindo as zonas de subdomínio.

{
    "apiKey": "YOUR_API_KEY",
    "domains": {
        "include": [
            "amazon.*"
        ]
    }
}

Exemplo de corpo de solicitação POST: somente subdomínios (10 créditos DRS)

Retorna apenas os subdomínios que correspondem aos termos de pesquisa especificados nas zonas de subdomínio, excluindo as zonas de domínio e TLD.

{
    "apiKey": "YOUR_API_KEY",
    "subdomains": {
        "include": [
            "adidas*"
        ],
        "exclude": [
            "*shoes*"
        ]
    }
}

Exemplo de corpo de solicitação POST: domínios e subdomínios (11 créditos DRS)

Retorna domínios E subdomínios que correspondem aos termos de pesquisa especificados em todo o nome do host.

{
    "apiKey": "YOUR_API_KEY",
    "domains": {
        "include": [
            "amazon.com"
        ]
    },
    "subdomains": {
        "include": [
            "aws*"
        ],
        "exclude": [
            "*portal*",
            "*beta*"
        ]
    }
}

Você pode fornecer até quatro termos de pesquisa de inclusão e exclusão em uma única solicitação.

Parâmetros de entrada

apiKey

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

[domains|subdomains].include

Obrigatório. Conjunto de termos de pesquisa incluídos. Máximo de 4 itens. Não diferencia maiúsculas de minúsculas.

[domains|subdomains].exclude

Opcional. Conjunto de termos de pesquisa excluídos. Máximo de 4 itens. Não diferencia maiúsculas de minúsculas.

sinceDate

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

Se estiver presente, pesquisará os domínios/subdomínios descobertos desde a data especificada.

outputFormat

Opcional. Formato de saída da resposta.

Valores aceitáveis: JSON | XML

Padrão: JSON

1 solicitação para os custos da API de descoberta de domínios e subdomínios:

  • Somente domínios: 1 crédito DRS
  • Somente subdomínios: 10 créditos DRS
  • Domínios e subdomínios: 11 créditos DRS

Pesquisa de curinga

Você pode usar curingas para fazer a pesquisa. Observe que essas consultas podem ser lentas.

{
    "apiKey": "YOUR_API_KEY",
    "domains": {
        "include": [
            "amazon.*"
        ]
    },
    "subdomains": {
        "include": [
            "aws*"
        ],
        "exclude": [
            "*portal*",
            "*beta*"
        ]
    }
}

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.