Felo API PlatformFelo API Platform
Todos os endpoints de DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Resumo de links de entrada

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

Resumo de links de entrada

​

O perfil completo de links de entrada de um target em uma única chamada: first_seen, lost_date, rank, backlinks, backlinks_spam_score, crawled_pages, internal_links_count e um bloco info, com contagens de domínios de referência e de âncoras ao lado. É o hub da família: comece aqui e aprofunde na parte que importar: post_dataforseo_backlinks_backlinks_live para os links individuais, post_dataforseo_backlinks_referring_domains_live para quem linka, post_dataforseo_backlinks_anchors_live para o texto usado. Este endpoint não aceita parâmetro de limite, então a única forma de reduzir o custo é chamá-lo com menos frequência.

Referência de preços

  • Medição: Custo da resposta reportado.
  • Estimativa de referência por requisição: USD 0.024.
  • 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 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

    • 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

    • 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 dados
      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_BacklinksSummaryLiveResponseInfo
    • 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_BacklinksSummaryLiveTaskInfo
        • 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

          • backlinks
            Tipo: integer | null Formato: int64

            indica o número de backlinks

          • backlinks_spam_score
            Tipo: integer | null Formato: int64

            pontuação de spam dos backlinks
            exibe a pontuação de spam total de todos os backlinks que apontam para o domínio, subdomínio ou página web do target;
            para saber mais sobre como a métrica é calculada, consulte esta 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 target

          • broken_pages
            Tipo: integer | null

            número de páginas quebradas
            número de páginas no target que respondem com códigos de status 4xx ou 5xx

            observe que o número de páginas quebradas inclui páginas no target descobertas ao seguir links externos, mas também pode incluir páginas descobertas ao seguir o sitemap do target

          • crawled_pages
            Tipo: integer | null

            número de páginas rastreadas para o target

          • external_links_count
            Tipo: integer | null Formato: int64

            número de links externos na página
            calculado como a soma dos links externos nas páginas do target especificado

          • first_seen
            Tipo: string | null

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

          • info
            Tipo: object | null · Response36Afe1097B20_TargetInfo

            informações sobre o target

            • cms
              Tipo: string | null

              sistema de gerenciamento de conteúdo

            • country
              Tipo: string | null

              código do país ao qual o domínio target pertence

            • ip_address
              Tipo: string | null

              endereço IP do target

            • is_ip
              Tipo: boolean | null

              indica se o target é IP
              se true, o domínio, subdomínio ou página funciona como um endereço IP e não possui nome de domínio

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

              tipo de plataforma

            • server
              Tipo: string | null

              servidor

            • target_spam_score
              Tipo: integer | null

              pontuação de spam do target
              se o target for um domínio/subdomínio, este campo indica a pontuação de spam média de todas as páginas desse domínio/subdomínio;
              saiba mais sobre como a métrica é calculada nesta página da central de ajuda

          • internal_links_count
            Tipo: integer | null Formato: int64

            número de links internos
            calculado como a soma dos links internos nas páginas do target especificado

          • lost_date
            Tipo: string | null

            data e hora em que o backlink foi perdido
            indica a data e hora em que nosso rastreador visitou o target e ele respondeu com um código de status 4xx ou 5xx, ou em que seu ú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 do target
            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
            domínios de referência incluem subdomínios contados como domínios separados 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
            valores de exemplo:
            nofollow, noopener, noreferrer, external, ugc, sponsored

            • 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
            valores de exemplo:
            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

          • 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

            target em um array POST

        • 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
Request Example for post/v1/beta/dataforseo/backlinks/summary/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "explodingtopics.com",
    "internal_list_limit": 10,
    "include_subdomains": true,
    "backlinks_filters": [
      "dofollow",
      "=",
      true
    ],
    "backlinks_status_type": "all"
  }
]'

{
  "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,
          "first_seen": null,
          "lost_date": null,
          "rank": null,
          "backlinks": null,
          "backlinks_spam_score": null,
          "crawled_pages": null,
          "info": {
            "server": null,
            "cms": null,
            "platform_type": [
              "[Max Depth Exceeded]"
            ],
            "ip_address": null,
            "country": null,
            "is_ip": null,
            "target_spam_score": null
          },
          "internal_links_count": null,
          "external_links_count": 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

Backlinks Summary