v0.2.0-beta

OpenAPI 3.1.0

Interseção de páginas

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

Interseção de páginas

As páginas que linkam para várias URLs de destino de uma vez, em vez dos domínios. ⚠️ targets é um objeto com chaves por posição e recebe URLs completas, não domínios sem protocolo. Cada linha traz page_intersection e um summary por target. O equivalente no nível de domínio é post_dataforseo_backlinks_domain_intersection_live, que é o primeiro a consultar.

Referência de preços

Medição: Custo da resposta reportado.
Estimativa de referência por requisição: USD 0.033.
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_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 dos seus targets;
 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 no resultado
 valor padrão: true
- exclude_targets
 Tipo: array string[] | null
 
 domínios, subdomínios ou páginas web que você deseja excluir
 campo opcional
 você pode definir até 10 domínios, subdomínios ou páginas web
 se você usar este array, os resultados conterão as páginas de referência que apontam para targets, mas não para exclude_targets
 exemplo:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- 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:
 ["1.rank",">","80"]
 
 [["2.page_from_rank",">","55"], "and", ["1.original","=","true"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]
 
 A lista completa de filtros possíveis está disponível aqui.
 
 Objeto vazio
- include_indirect_links
 Tipo: boolean | null
 
 indica se links indiretos para os targets 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 um alvo 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 dos targets 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:
 attributes
 domain_from_platform_type
 
 valor padrão: 10
 valor máximo: 1000
- intersection_mode
 Tipo: string | null
 
 indica se os backlinks devem ser interseccionados
 campo opcional
 use este campo para interseccionar ou mesclar resultados das URLs especificadas
 valores possíveis: all, partial
 all - os resultados se baseiam em todos os backlinks;
 partial - os resultados se baseiam apenas nos backlinks que se intersectam;
 valor padrão: all
- limit
 Tipo: integer | null
 
 o número máximo de backlinks retornados
 campo opcional
 
 valor padrão: 100
 valor máximo: 1000
- offset
 Tipo: integer | null
 
 deslocamento no array de resultados dos backlinks retornados
 campo opcional
 
 valor padrão: 0
 se você especificar o valor 10, os dez primeiros backlinks do array de resultados serão omitidos e os dados serão fornecidos para os backlinks 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:
 ["rank,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:
 ["domain_from_rank,desc","page_from_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
- targets
 Tipo: object | null
 
 domínios, subdomínios ou páginas web para obter links
 campo obrigatório
 você pode definir até 20 domínios, subdomínios ou páginas web
 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://)
 exemplo:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 Tipo: string | null

Respostas

200
Tipo: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo
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_BacklinksPageIntersectionLiveTaskInfo
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 backlinks relevantes e dados de domínios de referência

page_intersection
Tipo: object | null

contém dados sobre páginas que linkam para os destinos correspondentes especificados no array POST
os dados são fornecidos em objetos separados correspondentes às páginas especificadas no objeto targets

propertyName
Tipo: array (object | null)[] | null
alt
Tipo: string | null

texto alternativo da imagem
este campo será null se o type do backlink não for image

anchor
Tipo: string | null

texto âncora do backlink

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

atributos de link dos links de referência
exemplo:
nofollow

backlink_spam_score
Tipo: integer | null

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

dofollow
Tipo: boolean | null

indica se o backlink é dofollow
se for false, o backlink é nofollow

domain_from
Tipo: string | null

domínio que faz referência ao domínio ou à página web de destino

domain_from_country
Tipo: string | null

código de país ISO do domínio de referência

domain_from_ip
Tipo: string | null

endereço IP do domínio de referência

domain_from_is_ip
Tipo: boolean | null

indica se o domínio é um IP
se for true, o domínio funciona como um endereço IP e não tem nome de domínio

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

tipos de plataforma do domínio de referência

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

domain_from_rank
Tipo: integer | null

rank de domínio do domínio de referência
indica o rank do domínio no momento em que nosso rastreador viu o backlink pela última vez;
domain_from_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

domain_to
Tipo: string | null

domínio para o qual o backlink aponta

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

group_count
Tipo: integer | null Formato: int64

indica o número total de backlinks deste domínio
por exemplo, se mode estiver definido como one_per_domain, este campo indicará o número total de backlinks provenientes deste domínio

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

caminho do link indireto
indica uma URL ou uma sequência de URLs que levam a url_to

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

type
Tipo: string | null

tipo de elemento

url
Tipo: string | null

URL do link indireto

is_broken
Tipo: boolean | null

indica se o backlink está quebrado
se for true, o backlink aponta para uma página que responde com um código de status 4xx ou 5xx

is_indirect_link
Tipo: boolean | null

indica se o backlink é um link indireto
se for true, o backlink é um link indireto que aponta para uma página que redireciona para url_to ou aponta para uma página canônica

is_lost
Tipo: boolean | null

indica se o backlink foi removido
se for true, o backlink ou a página inteira foi removido

is_new
Tipo: boolean | null

indica se o backlink é novo
se for true, o backlink foi encontrado na página na última vez que nosso rastreador a visitou

item_type
Tipo: string | null

tipo de link
valores possíveis:
anchor, image, link, meta, canonical, alternate, redirect

last_seen
Tipo: string | null

data mais recente em que nosso rastreador visitou o backlink
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:
2019-11-15 12:57:46 +00:00

links_count
Tipo: integer | null Formato: int64

número de backlinks idênticos encontrados na página de referência

original
Tipo: boolean | null

indica se o backlink estava presente na página de referência quando nosso rastreador a visitou pela primeira vez

page_from_encoding
Tipo: string | null

codificação de caracteres da página de referência
exemplo:
utf-8

page_from_external_links
Tipo: integer | null

número de links externos encontrados na página de referência

page_from_internal_links
Tipo: integer | null

número de links internos encontrados na página de referência

page_from_language
Tipo: string | null

idioma da página de referência
no formato ISO 639-1
exemplo:
en

page_from_rank
Tipo: integer | null

rank da página de referência
page_from_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

page_from_size
Tipo: integer | null

tamanho da página de referência, em bytes
exemplo:
63357

page_from_status_code
Tipo: integer | null

código de status HTTP retornado pela página de referência
exemplo:
200

page_from_title
Tipo: string | null

título da página de referência

prev_seen
Tipo: string | null

data anterior à mais recente em que nosso rastreador visitou o backlink
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:
2019-11-15 12:57:46 +00:00

rank
Tipo: integer | null

rank de backlink
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

semantic_location
Tipo: string | null

indica o elemento semântico em HTML onde o backlink é encontrado
você pode obter a lista completa de elementos semânticos aqui
exemplos:
article, section, summary

text_post
Tipo: string | null

snippet depois do texto âncora

text_pre
Tipo: string | null

trecho de texto antes do texto âncora

tld_from
Tipo: string | null

domínio de nível superior da URL de referência

type
Tipo: string | null

tipo de elemento

url_from
Tipo: string | null

URL da página onde o backlink é encontrado

url_from_https
Tipo: boolean | null

indica se a URL de referência está protegida com HTTPS
se for true, a URL de referência está protegida com HTTPS

url_to
Tipo: string | null

URL para a qual o backlink aponta

url_to_https
Tipo: boolean | null

indica se a URL para a qual o backlink aponta está protegida com HTTPS
se for true, a URL está protegida com HTTPS

url_to_redirect_target
Tipo: string | null

URL de destino do redirecionamento
página de destino para a qual o redirecionamento aponta

url_to_spam_score
Tipo: integer | null

pontuação de spam da página referenciada
se o valor for null, nosso rastreador ainda não visitou a página para a qual o link aponta
saiba mais sobre como a métrica é calculada nesta página da Central de Ajuda

url_to_status_code
Tipo: integer | null

código de status da página referenciada
se o valor for null, nosso rastreador ainda não visitou a página para a qual o link aponta
exemplo:
200

summary
Tipo: object | null · Response36Afe1097B20_IntersectionSummaryInfo

contém o resumo de interseções de páginas

intersections_count
Tipo: integer | null Formato: int64

número total de interseções

items_count
Tipo: integer | null Formato: int64

o número de resultados retornados no array items

targets
Tipo: object | null

targets de um array POST

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

quantidade total de resultados relevantes para a requisiçã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/backlinks/page_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/page_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "football.com",
      "2": "fifa.com"
    },
    "exclude_targets": [
      "skysports.com"
    ],
    "limit": 5,
    "order_by": [
      "1.rank,desc"
    ],
    "filters": [
      [
        "2.domain_from_rank",
        ">",
        400
      ],
      "and",
      [
        "1.dofollow",
        "=",
        true
      ]
    ]
  }
]'

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": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "page_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operação bem-sucedida

Interseção de páginas

AutenticaçãoRequired

DataForSEO

Interseção de páginas

Referência de preços