v0.2.0-beta

OpenAPI 3.1.0

Interseção de domínios

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

Interseção de domínios

Os domínios que linkam para vários targets de uma vez. ⚠️ Aqui targets é um objeto com chaves por posição — {"1": "a.com", "2": "b.com"} — e não o array que os endpoints em massa recebem. exclude_targets remove sites da comparação. Cada linha traz domain_intersection e um summary por target. Use para descobrir quem linka para seus concorrentes mas não para você. O equivalente no nível de página é post_dataforseo_backlinks_page_intersection_live.

Referência de preços

Medição: Custo da resposta reportado.
Estimativa de referência por requisição: USD 0.06.
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 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 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
- exclude_targets
 Tipo: array string[] | null
 
 domínios, subdomínios ou páginas web que você deseja excluir
 campo opcional
 você pode especificar até 10 domínios, subdomínios ou páginas web
 se você usar este array, os resultados conterão os domínios 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.internal_links_count",">","1"]
 
 [["2.referring_pages",">","2"], "and", ["1.backlinks",">","10"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["2.target","like","%dataforseo.com%"],"or",["1.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 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 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
- intersection_mode
 Tipo: string | null
 
 indica se os backlinks devem ser interseccionados
 campo opcional
 use este campo para interseccionar ou mesclar resultados dos domínios especificados
 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 resultados retornados
 campo opcional
 valor padrão: 100
 valor máximo: 1000
- offset
 Tipo: integer | null
 
 deslocamento no array de resultados 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:
 ["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
- 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_BacklinksDomainIntersectionLiveResponseInfo
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_BacklinksDomainIntersectionLiveTaskInfo
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 os domínios que linkam para todos os targets do array POST

domain_intersection
Tipo: object | null

contém dados sobre domínios que linkam para os destinos correspondentes especificados no array POST
os dados são fornecidos em objetos separados correspondentes aos domínios, subdomínios ou páginas especificados no objeto targets

propertyName
Tipo: object | null · Response36Afe1097B20_BacklinksDomainIntersection
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 o target
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

broken_pages
Tipo: integer | null

número de páginas quebradas

first_seen
Tipo: string | null

data e hora em que nosso rastreador encontrou o backlink deste target 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 target 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:
2019-11-15 12:57:46 +00:00

rank
Tipo: integer | null

rank referido ao target do array POST
indica o rank que o domínio de referência (target acima) refere ao seu target do array POST;
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

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 o destino correspondente

referring_ips
Tipo: integer | null Formato: int64

número de endereços IP de referência

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

Integer numbers.

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

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

Integer numbers.

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

propertyName
Tipo: integer | null

Integer numbers.

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

Integer numbers.

referring_links_types
Tipo: object | null

tipos dos links de referência
indica os tipos de 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

Integer numbers.

referring_main_domains
Tipo: integer | null Formato: int64

número de domínios principais de referência

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

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

target
Tipo: string | null

domínio que linka para o destino correspondente do array POST

type
Tipo: string | null

tipo de elemento

summary
Tipo: object | null · Response36Afe1097B20_IntersectionSummaryInfo

contém o resumo de interseções de domínios

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

domínios, subdomínios ou páginas web de destino em um array POST

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

quantidade total de resultados relevantes para sua 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/domain_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": 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": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operação bem-sucedida

Interseção de domínios

AutenticaçãoRequired

DataForSEO

Interseção de domínios

Referência de preços