v0.2.0-beta

OpenAPI 3.1.0

Domínios de referência

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/backlinks/referring_domains/live

Domínios de referência

Os domínios que linkam para um target, uma linha por domínio com domain, rank, backlinks, first_seen, lost_date, backlinks_spam_score, broken_backlinks e broken_pages. Domínios de referência importam mais que a contagem bruta de links, já que mil links de um único domínio são um só relacionamento. Para os links individuais, use post_dataforseo_backlinks_backlinks_live; para agrupar ainda mais, em operadores de rede, use post_dataforseo_backlinks_referring_networks_live.

Referência de preços

Medição: Custo da resposta reportado.
Estimativa de referência por requisição: USD 0.0276.
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)[]
- backlinks_filters
  Tipo: array (object | null)[] | null
  
  filtre os backlinks do seu target
  campo opcional
  você pode usar este campo para filtrar os backlinks iniciais que serão incluídos no conjunto de dados de métricas agregadas do seu target
  você pode filtrar os backlinks por todos os campos disponíveis na resposta deste endpoint
  usando este parâmetro, você pode incluir apenas backlinks dofollow na resposta e criar um conjunto de dados de backlinks flexível para calcular as métricas
  exemplo:
  "backlinks_filters": ["dofollow", "=", true]
  
  Objeto vazio
- backlinks_status_type
  Tipo: string | null
  
  defina quais backlinks retornar e contar
  campo opcional
  você pode usar este campo para escolher quais backlinks serão retornados e usados para métricas agregadas do seu target;
  valores possíveis:
  all - todos os backlinks serão retornados e contados;
  live - os backlinks encontrados durante a última verificação serão retornados e contados;
  lost - os backlinks perdidos serão retornados e contados;
  
  valor padrão: live
- exclude_internal_backlinks
  Tipo: boolean | null
  
  indica se os backlinks de subdomínios do target são excluídos
  campo opcional
  se definido como false, os backlinks de subdomínios do target serão omitidos e você não receberá o mesmo domínio na resposta;
  valor padrão: true
- 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)
  defina um operador lógico and ou or entre as condições
  os seguintes operadores são suportados:
  regex, not_regex, =, <>, in, not_in, like, not_like, match, not_match
  você pode usar o operador % com like e not_like para corresponder a qualquer string de zero ou mais caracteres
  exemplo:
  ["referring_pages",">","1"]
  
  [["referring_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["domain","like","%dataforseo.com%"],"or",["referring_domains",">","10"]]]
  
  A lista completa de filtros possíveis está disponível aqui.
  
  Objeto vazio
- include_indirect_links
  Tipo: boolean | null
  
  indica se links indiretos para o target serão incluídos nos resultados
  campo opcional
  se definido como true, os resultados incluirão dados sobre links indiretos que apontam para uma página que redireciona para o destino ou aponta para uma página canônica
  se definido como false, os links indiretos serão ignorados
  valor padrão: true
- include_subdomains
  Tipo: boolean | null
  
  indica se os subdomínios do target serão incluídos na pesquisa
  campo opcional
  se definido como false, os subdomínios serão ignorados
  valor padrão: true
- internal_list_limit
  Tipo: integer | null
  
  número máximo de elementos em arrays internos
  campo opcional
  você pode usar este campo para limitar o número de elementos nos seguintes arrays:
  referring_links_tld
  referring_links_types
  referring_links_attributes
  referring_links_platform_types
  referring_links_semantic_locations
  
  valor padrão: 10
  valor máximo: 1000
- 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 de domínios retornados
  campo opcional
  valor padrão: 0
  se você especificar o valor 10, os dez primeiros domínios do array de resultados serão omitidos e os dados serão fornecidos para as páginas seguintes
- 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
  use uma vírgula para definir o tipo de ordenação
  exemplo:
  ["backlinks,desc"]
  observe que você pode definir no máximo três regras de ordenação em uma única requisição
  use uma vírgula para separar várias regras de ordenação
  exemplo:
  ["backlinks,desc","rank,asc"]
- rank_scale
  Tipo: string | null
  
  define a escala usada para calcular e exibir os valores de rank, domain_from_rank e page_from_rank
  campo opcional
  
  você pode usar este parâmetro para escolher se os valores de rank são apresentados em uma escala de 0–100 ou de 0–1000
  
  valores possíveis:
  one_hundred — os valores de rank são exibidos em uma escala de 0–100
  one_thousand — os valores de rank são exibidos em uma escala de 0–1000
  
  valor padrão: one_thousand
  
  saiba mais sobre como este parâmetro funciona e como as métricas de ranking são calculadas neste artigo da Central de Ajuda
- 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
- target
  Tipo: string
  
  domínio, subdomínio ou página web para obter domínios de referência
  campo obrigatório
  um domínio ou subdomínio deve ser especificado sem https:// e www.
  uma página deve ser especificada com URL absoluta (incluindo http:// ou https://)

Respostas

200
Tipo: object | null · Response36Afe1097B20_BacklinksReferringDomainsLiveResponseInfo
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_BacklinksReferringDomainsLiveTaskInfo
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

array items

backlinks
Tipo: integer | null Formato: int64

indica o número de backlinks que apontam para o target

backlinks_spam_score
Tipo: integer | null Formato: int64

pontuação de spam média de todos os backlinks que apontam para o domínio
saiba mais sobre como a métrica é calculada nesta página da Central de Ajuda

broken_backlinks
Tipo: integer | null Formato: int64

número de backlinks quebrados
número de backlinks quebrados que apontam para o domínio

broken_pages
Tipo: integer | null

número de páginas quebradas
número de páginas que respondem com códigos de status 4xx ou 5xx para as quais os backlinks apontam

domain
Tipo: string | null

domínio de referência

first_seen
Tipo: string | null

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

lost_date
Tipo: string | null

data e hora em que o último backlink deste domínio foi perdido
indica a data e hora em que nosso rastreador visitou a página e ela respondeu com código de status 4xx ou 5xx, ou em que o último backlink foi removido
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:
2017-01-24 13:20:59 +00:00

rank
Tipo: integer | null

rank de domínio
volume de rank que um site de referência transmite ao target
rank é calculado com base no método de classificação de nós em um banco de dados de links — um princípio usado no algoritmo PageRank original do Google
saiba mais sobre a métrica e como ela é calculada neste artigo da Central de Ajuda

referring_domains
Tipo: integer | null Formato: int64

indica o número de domínios de referência
observe que calculamos domínios principais (domínios raiz, como example.com) e seus subdomínios (por exemplo, blog.example.com) separadamente para esta métrica

referring_domains_nofollow
Tipo: integer | null Formato: int64

número de domínios que apontam pelo menos um link nofollow para o target

referring_ips
Tipo: integer | null Formato: int64

número de endereços IP de referência
número de endereços IP que apontam para esta página

referring_links_attributes
Tipo: object | null

atributos de link dos links de referência
indica os atributos de link dos links de referência e a contagem de links por atributo

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_countries
Tipo: object | null

códigos de país ISO dos links de referência
indica os códigos de país ISO dos domínios onde os links de referência estão localizados e a contagem de links por país

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Tipo: object | null

tipos de plataformas de referência
indica os tipos de plataformas de referência e a contagem de links por plataforma

valores possíveis: cms, blogs, ecommerce, message-boards, wikis, news, organization

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Tipo: object | null

locais semânticos dos links de referência
indica os elementos semânticos em HTML onde os links de referência estão localizados e a contagem de links por local semântico

você pode obter a lista completa de elementos semânticos aqui
exemplos:
article, section, summary

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_tld
Tipo: object | null

domínios de nível superior dos links de referência
contém domínios de nível superior e a contagem de links de referência para cada um

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_types
Tipo: object | null

tipos de links de referência
indica os tipos dos links de referência e a contagem de links por tipo
valores possíveis:
anchor, image, link, meta, canonical, alternate, redirect

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_main_domains
Tipo: integer | null Formato: int64

indica o número de domínios principais de referência
o número de domínios primários (raiz) que fazem referência ao seu target

referring_main_domains_nofollow
Tipo: integer | null Formato: int64

número de domínios principais que apontam pelo menos um link nofollow para o target

referring_pages
Tipo: integer | null Formato: int64

indica o número de páginas que apontam para o target especificado

referring_pages_nofollow
Tipo: integer | null Formato: int64

número de páginas de referência que apontam pelo menos um link nofollow para o target

referring_subnets
Tipo: integer | null Formato: int64

número de sub-redes de referência

type
Tipo: string | null

tipo de elemento

items_count
Tipo: integer | null Formato: int64

número de itens no array items

target
Tipo: string | null

target em um array POST

total_count
Tipo: integer | null Formato: int64

número total de itens relevantes no banco de dados
número total de domínios principais que fazem referência ao seu target;
example.com e blog.example.com são contados como um único domínio de referência

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/backlinks/referring_domains/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/referring_domains/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "backlinko.com",
    "limit": 5,
    "order_by": [
      "rank,desc"
    ],
    "exclude_internal_backlinks": true,
    "backlinks_filters": [
      "dofollow",
      "=",
      true
    ],
    "filters": [
      "backlinks",
      ">",
      100
    ]
  }
]'

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": [
        {
          "target": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain": null,
              "rank": null,
              "backlinks": null,
              "first_seen": null,
              "lost_date": null,
              "backlinks_spam_score": null,
              "broken_backlinks": null,
              "broken_pages": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_links_tld": null,
              "referring_links_types": null,
              "referring_links_attributes": null,
              "referring_links_platform_types": null,
              "referring_links_semantic_locations": null,
              "referring_links_countries": null
            }
          ]
        }
      ]
    }
  ]
}

Operação bem-sucedida

Domínios de referência

AutenticaçãoRequired

DataForSEO

Domínios de referência

Referência de preços