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

Resumo de páginas em massa

Servidor:https://openapi.felo.ai
Bibliotecas Cliente

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

Resumo de páginas em massa

​

Métricas de links de entrada por página para muitos targets de uma vez: uma linha por url com rank, main_domain_rank, backlinks, first_seen, lost_date, backlinks_spam_score e broken_backlinks. A versão para um único target é post_dataforseo_backlinks_domain_pages_summary_live. 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.0242.
  • 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)[]
    • 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

    • 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: array string[]

      domínios, subdomínios ou páginas web para obter dados de resumo
      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://)
      você pode especificar até 1000 páginas, domínios ou subdomínios em cada requisição.
      observe que as URLs definidas em uma única requisição não podem pertencer a mais de 100 domínios diferentes.

Respostas
  • 200
    Tipo: object | null · Response36Afe1097B20_BacklinksBulkPagesSummaryLiveResponseInfo
    • 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_BacklinksBulkPagesSummaryLiveTaskInfo
        • 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

              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 backlinks quebrados
              número de backlinks quebrados que apontam para a página

            • 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 um backlink para esta página 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 para esta página 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

            • main_domain_rank
              Tipo: integer | null

              rank do domínio principal
              o rank do domínio principal é 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

            • rank
              Tipo: integer | null

              rank de página
              rank da página no site 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 que fazem referência à página

            • 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, footer

              • 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

              Signed 64-bit integers (long type).

            • referring_pages
              Tipo: integer | null Formato: int64

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

            • 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

            • url
              Tipo: string | null

              URL da página

          • items_count
            Tipo: integer | null Formato: int64

            número de itens no array de resultados

          • 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
Request Example for post/v1/beta/dataforseo/backlinks/bulk_pages_summary/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/bulk_pages_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "https://dataforseo.com/solutions",
      "https://dataforseo.com/about-us"
    ]
  }
]'
{
  "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": [
        {
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "rank": null,
              "main_domain_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
            }
          ]
        }
      ]
    }
  ]
}
Bulk Pages Summary