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

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

Links de entrada

​

Os links de entrada individuais de um target, uma linha por link. Retorna total_count, items_count, items e um search_after_token para paginação — use-o em vez de offset após as primeiras páginas. mode e custom_mode controlam o agrupamento, backlinks_status_type seleciona live, lost ou all. Para contagens em vez de linhas, use post_dataforseo_backlinks_summary_live; para os domínios que linkam agrupados, post_dataforseo_backlinks_referring_domains_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_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

    • custom_mode
      Tipo: object | null

      tipo de agrupamento detalhado dos resultados
      campo opcional
      use este objeto para obter um número específico de backlinks por field
      se você usar custom_mode, mode será ignorado
      exemplo:
      "custom_mode": {"field": "domain", "value": 100}

      • propertyName
        Tipo: object | null
    • 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:
      =, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, match, not_match
      você pode usar o operador % com like e not_like para corresponder a qualquer string de zero ou mais caracteres
      exemplo:
      ["rank",">","80"]

      [["page_from_rank",">","55"],
      "and",
      ["dofollow","=",true]]

      [["first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]

      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

    • limit
      Tipo: integer | null

      o número máximo de backlinks retornados
      campo opcional

      valor padrão: 100
      valor máximo: 1000

    • mode
      Tipo: string | null

      tipo de agrupamento dos resultados
      campo opcional
      tipos de agrupamento possíveis:
      as_is - retorna todos os backlinks
      one_per_domain - retorna um backlink por domínio
      one_per_anchor - retorna um backlink por âncora

      valor padrão: as_is

    • 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;
      Observação: o valor máximo é 20,000, use o search_after_token se quiser deslocar mais resultados

    • 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

    • search_after_token
      Tipo: string | null

      token para requisições subsequentes
      campo opcional
      fornecido no campo idêntico da resposta a cada requisição;
      use este parâmetro para evitar timeouts ao tentar obter mais de 20,000 resultados em uma única requisição;
      ao especificar o valor exclusivo de search_after_token do array de resposta, você receberá os resultados subsequentes da tarefa inicial;
      os valores de search_after_token são exclusivos para cada tarefa subsequente ;
      Observação: se o search_after_token for especificado na requisição, todos os outros parâmetros deverão ser idênticos aos da requisição anterior

    • 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 backlinks
      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_BacklinksBacklinksLiveResponseInfo
    • 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_BacklinksBacklinksLiveTaskInfo
        • 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

          • custom_mode
            Tipo: object | null

            modo personalizado especificado em um array POST

            • propertyName
              Tipo: object | null
          • items
            Tipo: array (object | null)[] | null

            contém backlinks relevantes e dados de domínios de referência

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

            • image_url
              Tipo: string | null

              URL da imagem
              a URL que leva à imagem no recurso original ou no armazenamento do DataForSEO (caso a fonte original não esteja disponível)

            • 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, 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 que o backlink em questão transmite ao 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

            • ranked_keywords_info
              Tipo: object | null · Response36Afe1097B20_RankedKeywordsInfo
              • page_from_keywords_count_top_10
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

              • page_from_keywords_count_top_100
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

              • page_from_keywords_count_top_3
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • 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

              snippet 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

          • items_count
            Tipo: integer | null Formato: int64

            o número de resultados retornados no array items

          • mode
            Tipo: string | null

            modo especificado em um array POST

          • search_after_token
            Tipo: string | null

            token para requisições subsequentes
            ao especificar o search_after_token exclusivo ao definir uma nova tarefa, você receberá os resultados subsequentes da tarefa inicial;
            os valores de search_after_token são exclusivos para cada tarefa subsequente

          • target
            Tipo: string | null

            domínio de destino em um array POST

          • 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
Request Example for post/v1/beta/dataforseo/backlinks/backlinks/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/backlinks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "mode": "as_is",
    "filters": [
      "dofollow",
      "=",
      true
    ],
    "limit": 5
  }
]'

{
  "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,
          "mode": null,
          "custom_mode": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain_from": null,
              "url_from": null,
              "url_from_https": null,
              "domain_to": null,
              "url_to": null,
              "url_to_https": null,
              "tld_from": null,
              "is_new": null,
              "is_lost": null,
              "backlink_spam_score": null,
              "rank": null,
              "page_from_rank": null,
              "domain_from_rank": null,
              "domain_from_platform_type": [
                "[Max Depth Exceeded]"
              ],
              "domain_from_is_ip": null,
              "domain_from_ip": null,
              "domain_from_country": null,
              "page_from_external_links": null,
              "page_from_internal_links": null,
              "page_from_size": null,
              "page_from_encoding": null,
              "page_from_language": null,
              "page_from_title": null,
              "page_from_status_code": null,
              "first_seen": null,
              "prev_seen": null,
              "last_seen": null,
              "item_type": null,
              "attributes": [
                "[Max Depth Exceeded]"
              ],
              "dofollow": null,
              "original": null,
              "alt": null,
              "image_url": null,
              "anchor": null,
              "text_pre": null,
              "text_post": null,
              "semantic_location": null,
              "links_count": null,
              "group_count": null,
              "is_broken": null,
              "url_to_status_code": null,
              "url_to_spam_score": null,
              "url_to_redirect_target": null,
              "ranked_keywords_info": "[Max Depth Exceeded]",
              "is_indirect_link": null,
              "indirect_link_path": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "search_after_token": null
        }
      ]
    }
  ]
}

Operação bem-sucedida

Backlinks