v0.2.0-beta

OpenAPI 3.1.0

Páginas do 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/backlinks/domain_pages/live

Páginas do domínio

As páginas de um target que têm links de entrada, com a visão do rastreador sobre cada uma: main_domain, domain, tld, page, ip, first_visited, prev_visited e fetch_time. Use para descobrir quais páginas realmente conquistam links. Para contagens de links por página em vez de metadados de rastreamento, use post_dataforseo_backlinks_domain_pages_summary_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
  
  define 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;
  valores possíveis:
  all - todos os backlinks serão retornados e contados;
  live - os backlinks encontrados na ú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 backlinks internos de subdomínios para o target serão excluídos dos resultados
  campo opcional
  se definido como true, os resultados não incluirão dados sobre backlinks internos de subdomínios do mesmo domínio que o target
  se definido como false, os links internos serão incluídos nos resultados
  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, ilike, not_ilike, match, not_match
  você pode usar o operador % com like e not_like para corresponder a qualquer string de zero ou mais caracteres
  exemplo:
  ["meta.internal_links_count",">","1"]
  
  [["meta.external_links_count",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_visited",">","2017-10-23 11:31:45 +00:00"], "and", [["title","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  A lista completa de filtros possíveis está disponível aqui.
  
  Objeto vazio
- 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
  
  o número máximo de páginas retornadas
  campo opcional
  valor padrão: 100
  valor máximo: 1000
- offset
  Tipo: integer | null
  
  deslocamento no array de resultados de páginas retornadas
  campo opcional
  valor padrão: 0
  se você especificar o valor 10, as dez primeiras páginas no array de resultados serão omitidas 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:
  ["page_summary.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:
  ["page_summary.backlinks,desc","page_summary.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 ou subdomínio
  campo obrigatório
  um domínio ou subdomínio deve ser especificado sem https:// e www.
  exemplo:
  forbes.com

Respostas

200
Tipo: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo
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_BacklinksDomainPagesLiveTaskInfo
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

content_encoding
Tipo: string | null

tipo de codificação

domain
Tipo: string | null

domínio
domínio onde a página foi encontrada

encoded_size
Tipo: integer | null

tamanho da página após a codificação
indica o tamanho da página codificada, em bytes

fetch_time
Tipo: string | null

data e hora mais recentes em que nosso rastreador visitou a página
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:
2017-01-24 13:20:59 +00:00

first_visited
Tipo: string | null

data e hora da primeira visita à página
data e hora em que nosso rastreador visitou esta página pela primeira vez
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:
2017-01-24 13:20:59 +00:00

ip
Tipo: string | null

endereço IP

location
Tipo: string | null

cabeçalho de localização
indica a URL para a qual redirecionar uma página, se houver

main_domain
Tipo: string | null

domínio principal do site
o domínio principal do site não inclui subdomínios

media_type
Tipo: string | null

tipos de mídia usados para exibir uma página

meta
Tipo: object | null · Response36Afe1097B20_BacklinksPageMeta

metadados da página

canonical
Tipo: string | null

página canônica

charset
Tipo: string | null

codificação de caracteres
exemplos:
utf-8

external_links_count
Tipo: integer | null Formato: int64

número de links externos na página

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

tag h1
conteúdo das tags h1

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

tag h2
conteúdo das tags h2

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

tag h3
conteúdo das tags h3

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

conteúdo das tags alt

images_count
Tipo: integer | null Formato: int64

número de imagens na página

internal_links_count
Tipo: integer | null Formato: int64

número de links internos na página

language
Tipo: string | null

idioma do conteúdo da página
exemplo:
en

page_spam_score
Tipo: integer | null

pontuação de spam da página
saiba mais sobre como a métrica é calculada nesta página da Central de Ajuda

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

tipo de plataforma

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

detalhes do CMS

social_media_tags
Tipo: object | null
propertyName
Tipo: string | null
technologies
Tipo: object | null

tecnologias do site

propertyName
Tipo: string | null
title
Tipo: string | null

título da página

words_count
Tipo: integer | null Formato: int64

número de palavras na página

page
Tipo: string | null

URL da página
URL da página relevante

page_summary
Tipo: object | null · Response36Afe1097B20_PageSummary

contém dados de backlinks desta página

backlinks
Tipo: integer | null Formato: int64

indica o número de backlinks

backlinks_spam_score
Tipo: integer | null Formato: int64

pontuação de spam média dos backlinks que apontam para a página
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 links de entrada quebrados
número de links de entrada quebrados que apontam para a page

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

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 link de entrada desta página foi perdido
indica a data e hora em que nosso rastreador visitou a página e ela respondeu com um código de status 4xx ou 5xx, ou em que o último link de entrada 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 página
rank da page
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

referring_domains_nofollow
Tipo: integer | null Formato: int64

número de domínios que apontam pelo menos um link nofollow para a page

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
propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_countries
Tipo: object | null
propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_platform_types
Tipo: object | null
propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
Tipo: object | null
propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_tld
Tipo: object | null
propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_links_types
Tipo: object | null
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

referring_main_domains_nofollow
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

referring_pages
Tipo: integer | null Formato: int64

indica o número de páginas que apontam para a page

referring_pages_nofollow
Tipo: integer | null Formato: int64

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

referring_subnets
Tipo: integer | null Formato: int64

número de sub-redes de referência

prev_visited
Tipo: string | null

data anterior à mais recente em que nosso rastreador visitou a página
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:
2017-01-24 13:20:59 +00:00

server
Tipo: string | null

versão do servidor

size
Tipo: integer | null

indica o tamanho da página, em bytes

status_code
Tipo: integer | null

código de status geral
você pode encontrar a lista completa dos códigos de resposta aqui
Observação: recomendamos fortemente projetar um sistema necessário para lidar com condições excepcionais ou de erro relacionadas

tld
Tipo: string | null

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

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

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/domain_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 5,
    "filters": [
      [
        "page_summary.backlinks",
        ">",
        5
      ],
      "and",
      [
        "page",
        "like",
        "%sites%"
      ]
    ]
  }
]'

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,
              "main_domain": null,
              "domain": null,
              "tld": null,
              "page": null,
              "ip": null,
              "first_visited": null,
              "prev_visited": null,
              "fetch_time": null,
              "status_code": null,
              "location": null,
              "size": null,
              "encoded_size": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "meta": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "social_media_tags": "[Max Depth Exceeded]"
              },
              "page_summary": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "referring_main_domains_nofollow": "[Max Depth Exceeded]",
                "referring_links_tld": "[Max Depth Exceeded]",
                "referring_links_types": "[Max Depth Exceeded]",
                "referring_links_attributes": "[Max Depth Exceeded]",
                "referring_links_platform_types": "[Max Depth Exceeded]",
                "referring_links_semantic_locations": "[Max Depth Exceeded]",
                "referring_links_countries": "[Max Depth Exceeded]"
              }
            }
          ]
        }
      ]
    }
  ]
}

Operação bem-sucedida

Páginas do domínio

AutenticaçãoRequired

DataForSEO

Páginas do domínio

Referência de preços