v0.2.0-beta

OpenAPI 3.1.0

Visão geral de Whois de domínio

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas Cliente

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operações

post/v1/beta/dataforseo/domain_analytics/whois/overview/live

Visão geral de Whois de domínio

Registros Whois enriquecidos com métricas de SEO. Cada item traz domain, created_datetime, changed_datetime, expiration_datetime, updated_datetime, first_seen, epp_status_codes, tld, registered e registrar, além de metrics e backlinks_info. Paginado com limit, offset e offset_token, filtrado pelos campos de get_dataforseo_domains_whois_available_filters.

Referência de preços

Medição: Custo da resposta reportado.
Estimativa de referência por requisição: USD 0.012.
Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

Corpo

application/json

Tipo: array (object | null)[]
- filters
  Tipo: array (object | null)[] | null
  
  array de parâmetros de filtragem de resultados
  campo opcional
  você pode adicionar vários filtros de uma vez (máximo de 8 filtros)
  você deve definir um operador lógico and, or entre as condições
  os seguintes operadores são suportados:
  regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  você pode usar o operador % com like e not_like para corresponder a qualquer string de zero ou mais caracteres
  
  Objeto vazio
- limit
  Tipo: integer | null
  
  número máximo de domínios retornados
  campo opcional
  valor padrão: 100
  valor máximo: 1000
- offset
  Tipo: integer | null
  
  deslocamento no array de resultados dos itens retornados
  campo opcional
  valor padrão: 0
  se você especificar o valor 10, os dez primeiros items no array de resultados serão omitidos e os dados serão fornecidos para os itens seguintes;
  Observação: recomendamos usar este parâmetro apenas para recuperar até 10.000 resultados; para recuperar mais de 10.000 resultados, use o offset_token
- offset_token
  Tipo: string | null
  
  token para requisições subsequentes
  campo opcional
  fornecido no campo identical da resposta a cada requisição;
  use este parâmetro para evitar timeouts ao tentar obter mais de 100.000 resultados em uma única requisição;
  ao especificar o valor exclusivo de offset_token do array de resposta, você obterá os resultados subsequentes da tarefa inicial;
  os valores de offset_token são exclusivos para cada tarefa subsequente
  Observação: se o offset_token for especificado na requisição, todos os outros parâmetros devem ser idênticos aos da requisição anterior
  saiba mais sobre este parâmetro na nossa Central de Ajuda
- order_by
  Tipo: array string[] | null
  
  regras de ordenação dos resultados
  campo opcional
  você pode usar os mesmos valores do array filters para ordenar os resultados
  tipos de ordenação possíveis:
  asc - os resultados serão ordenados em ordem crescente
  desc - os resultados serão ordenados em ordem decrescente
  a vírgula é usada como separador
  exemplo:
  ["metrics.organic.pos_1,desc"]
  regra padrão:
  ["metrics.organic.count,desc"]
  observação: você pode definir no máximo três regras de ordenação em uma única requisição
  você deve usar uma vírgula para separar várias regras de ordenação
  exemplo:
  ["expiration_datetime,asc","metrics.organic.etv,desc","metrics.organic.pos_1,desc"]
- tag
  Tipo: string | null
  
  identificador de tarefa definido pelo usuário
  campo opcional
  o limite de caracteres é 255
  você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado
  você encontrará o valor de tag especificado no objeto data da resposta

Respostas

200
Tipo: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveResponseInfo
cost
Tipo: number | null Formato: double

custo total das tarefas, USD

status_code
Tipo: integer | null

código de status geral você pode encontrar a lista completa dos códigos de resposta aqui

status_message
Tipo: string | null

mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui

tasks
Tipo: array (object | null)[] | null

array de tarefas

Tipo: object | null · Response36Afe1097B20_DomainAnalyticsWhoisOverviewLiveTaskInfo
cost
Tipo: number | null Formato: double

custo total das tarefas, USD

data
Tipo: object | null

contém os mesmos parâmetros que você especificou na requisição POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID

path
Tipo: array (string | null)[] | null

caminho da URL

result
Tipo: array (object | null)[] | null

array de resultados

items
Tipo: array (object | null)[] | null

contém dados de ranking e tráfego

array items

backlinks_info
Tipo: object | null · Response36Afe1097B20_BacklinksInfo

dados de backlinks para o domínio retornado

backlinks
Tipo: integer | null Formato: int64

número médio de backlinks

dofollow
Tipo: integer | null Formato: int64

número médio de links dofollow

referring_domains
Tipo: integer | null Formato: int64

número médio de domínios de referência

referring_main_domains
Tipo: integer | null Formato: int64

número médio de domínios principais de referência

referring_pages
Tipo: integer | null Formato: int64

número médio de páginas de referência

time_update
Tipo: string | null

data e hora em que os dados de backlinks foram atualizados
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”;
exemplo:
2019-11-15 12:57:46 +00:00

changed_datetime
Tipo: string | null

data e hora em que o registro do domínio foi alterado
data e hora (no formato ISO 8601) em que o registro do domínio foi modificado pela última vez
exemplo:
"2021-01-14 08:36:28 +00:00"

created_datetime
Tipo: string | null

data e hora de registro
data e hora (no formato ISO 8601) em que o domínio foi registrado pela primeira vez
exemplo:
"1997-03-29 03:00:00 +00:00"

domain
Tipo: string | null

nome do domínio

epp_status_codes
Tipo: array (string | null)[] | null

códigos de status do protocolo de provisionamento extensivo
o status de um registro de nome de domínio conforme definido pela ICANN

expiration_datetime
Tipo: string | null

data e hora em que o domínio expirará
data e hora (no formato ISO 8601) em que o domínio deve expirar
exemplo:
"2022-11-26 17:21:23 +00:00"

first_seen
Tipo: string | null

data e hora em que nosso rastreador encontrou o domínio pela primeira vez
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:
"2019-11-15 12:57:46 +00:00"

metrics
Tipo: object | null · Response36Afe1097B20_MetricsBundleInfo

dados de ranking relevantes para o domínio especificado

organic
Tipo: object | null · Response36Afe1097B20_MetricsInfo

dados de classificação e tráfego da pesquisa orgânica

count
Tipo: integer | null Formato: int64

contagem total de SERPs orgânicas que contêm o domínio

estimated_paid_traffic_cost
Tipo: number | null

custo estimado de converter tráfego de pesquisa orgânica em pago
representa o custo mensal estimado de veicular anúncios (USD) para todas as palavras-chave pelas quais um domínio se classifica
a métrica é calculada como o produto dos valores de etv orgânico e cpc pago e indica o custo de direcionar o volume estimado de tráfego orgânico mensal por meio de publicidade PPC no Google Search
saiba mais sobre como a métrica é calculada neste artigo da central de ajuda

etv
Tipo: number | null

volume de tráfego estimado
tráfego orgânico mensal estimado para o domínio
calculado como o produto dos valores de CTR (taxa de cliques) e de volume de pesquisa de todas as palavras-chave para as quais o domínio se posiciona
saiba mais sobre como a métrica é calculada neste artigo da central de ajuda

is_down
Tipo: integer | null Formato: int64

classificação caiu indica quantos elementos classificados deste domínio caíram no Google Search

is_lost
Tipo: integer | null Formato: int64

elementos classificados perdidos indica quantos elementos classificados deste domínio estavam apresentados anteriormente nas SERPs, mas não foram encontrados durante a última verificação

is_new
Tipo: integer | null Formato: int64

número de novos elementos classificados indica quantos novos elementos classificados foram encontrados para este domínio

is_up
Tipo: integer | null Formato: int64

classificação subiu indica quantos elementos classificados deste domínio subiram no Google Search

pos_1
Tipo: integer | null

número de SERPs orgânicas em que o domínio está na posição #1

pos_11_20
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #11-20

pos_2_3
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #2-3

pos_21_30
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #21-30

pos_31_40
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #31-40

pos_4_10
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #4-10

pos_41_50
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #41-50

pos_51_60
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #51-60

pos_61_70
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #61-70

pos_71_80
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #71-80

pos_81_90
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #81-90

pos_91_100
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #91-100

paid
Tipo: object | null · Response36Afe1097B20_MetricsInfo

dados de classificação e tráfego da pesquisa paga

count
Tipo: integer | null Formato: int64

contagem total de SERPs orgânicas que contêm o domínio

estimated_paid_traffic_cost
Tipo: number | null

custo estimado de converter tráfego de pesquisa orgânica em pago
representa o custo mensal estimado de veicular anúncios (USD) para todas as palavras-chave pelas quais um domínio se classifica
a métrica é calculada como o produto dos valores de etv orgânico e cpc pago e indica o custo de direcionar o volume estimado de tráfego orgânico mensal por meio de publicidade PPC no Google Search
saiba mais sobre como a métrica é calculada neste artigo da central de ajuda

etv
Tipo: number | null

volume de tráfego estimado
tráfego orgânico mensal estimado para o domínio
calculado como o produto dos valores de CTR (taxa de cliques) e de volume de pesquisa de todas as palavras-chave para as quais o domínio se posiciona
saiba mais sobre como a métrica é calculada neste artigo da central de ajuda

is_down
Tipo: integer | null Formato: int64

classificação caiu indica quantos elementos classificados deste domínio caíram no Google Search

is_lost
Tipo: integer | null Formato: int64

elementos classificados perdidos indica quantos elementos classificados deste domínio estavam apresentados anteriormente nas SERPs, mas não foram encontrados durante a última verificação

is_new
Tipo: integer | null Formato: int64

número de novos elementos classificados indica quantos novos elementos classificados foram encontrados para este domínio

is_up
Tipo: integer | null Formato: int64

classificação subiu indica quantos elementos classificados deste domínio subiram no Google Search

pos_1
Tipo: integer | null

número de SERPs orgânicas em que o domínio está na posição #1

pos_11_20
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #11-20

pos_2_3
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #2-3

pos_21_30
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #21-30

pos_31_40
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #31-40

pos_4_10
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #4-10

pos_41_50
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #41-50

pos_51_60
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #51-60

pos_61_70
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #61-70

pos_71_80
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #71-80

pos_81_90
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #81-90

pos_91_100
Tipo: integer | null

número de SERPs orgânicas em que o domínio está nas posições #91-100

registered
Tipo: boolean | null

status de registro do domínio
se false, o registro do nome de domínio expirou
Observação: domínios expirados permanecerão no banco de dados por apenas um curto período de tempo

registrar
Tipo: string | null

registrador do domínio
se null, o registrador do domínio é desconhecido
exemplo:
NameCheap, Inc.

tld
Tipo: string | null

domínio de nível superior
domínio de nível superior na zona raiz do DNS

updated_datetime
Tipo: string | null

data e hora em que o domínio foi atualizado
data e hora (no formato ISO 8601) em que o domínio foi atualizado pela última vez
exemplo:
"2021-01-29 13:59:38 +00:00"

items_count
Tipo: integer | null Formato: int64

o número de resultados retornados no array items

offset
Tipo: integer | null

valor de deslocamento dos resultados especificado na solicitação POST

offset_token
Tipo: string | null
total_count
Tipo: integer | null Formato: int64

quantidade total de resultados em nosso banco de dados relevantes para a sua solicitação

result_count
Tipo: integer | null Formato: int64

número de elementos no array de resultados

status_code
Tipo: integer | null

código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000 você pode encontrar a lista completa dos códigos de resposta aqui

status_message
Tipo: string | null

mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui

time
Tipo: string | null

tempo de execução, segundos

tasks_count
Tipo: integer | null Formato: int64

o número de tarefas no array de tarefas

tasks_error
Tipo: integer | null Formato: int64

o número de tarefas no array de tarefas retornadas com erro

time
Tipo: string | null

tempo total de execução, em segundos

version
Tipo: string | null

a versão atual da API
application/json
400

Não foi possível processar a requisição. Verifique os parâmetros da requisição.
401

É necessária uma chave de API da Felo válida.
402

A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
403

A conta não tem permissão para realizar esta operação.
429

Um limite de requisições ou de gastos foi atingido.
502

O serviço não pôde concluir a requisição.
503

A API ou o serviço de cobrança está temporariamente indisponível.
504

O serviço atingiu o tempo limite ao processar a requisição.
default

Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

application/json

post/v1/beta/dataforseo/domain_analytics/whois/overview/live

curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/whois/overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "limit": 2,
    "filters": [
      [
        "epp_status_codes",
        "in",
        [
          "client_transfer_prohibited",
          "client_update_prohibited"
        ]
      ]
    ]
  }
]'

Mostrar Schema

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "total_count": null,
          "items_count": null,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "domain": null,
              "created_datetime": null,
              "changed_datetime": null,
              "expiration_datetime": null,
              "updated_datetime": null,
              "first_seen": null,
              "epp_status_codes": [
                "[Max Depth Exceeded]"
              ],
              "tld": null,
              "registered": null,
              "registrar": null,
              "metrics": "[Max Depth Exceeded]",
              "backlinks_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operação bem-sucedida

Visão geral de Whois de domínio

AutenticaçãoRequired

DataForSEO

Visão geral de Whois de domínio

Referência de preços