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

Resumo da OnPage API

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 da OnPage API

​

O estado e as principais métricas de um rastreamento, por id. Retorna crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info e page_metrics. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. É também como saber que um rastreamento terminou — consulte em polling até crawl_progress ser finished antes de ler qualquer outro endpoint desta família, ou você lerá resultados parciais que parecem reais. 💰 Gratuito no upstream: consultar um rastreamento concluído não custa nada; só o próprio rastreamento custa.

Referência de preços

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

Parâmetros de Caminho
  • id
    Tipo: string
    obrigatório

    identificador da tarefa
    campo obrigatório
    você pode obter este ID na resposta do endpoint Task POST
    exemplo:
    “07131248-1535-0216-1000-17384017ad04”

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

          • crawl_gateway_address
            Tipo: string | null

            endereço IP do rastreador
            exibe o endereço IP usado pelo rastreador para iniciar a sessão de rastreamento atual
            você pode encontrar a lista completa de IPs usados pelo nosso rastreador na seção Visão geral

          • crawl_progress
            Tipo: string | null

            status da sessão de rastreamento
            valores possíveis: in_progress, finished

          • crawl_status
            Tipo: object | null · Response36Afe1097B20_CrawlStatusInfo

            detalhes da sessão de rastreamento

            • max_crawl_pages
              Tipo: integer | null Formato: int64

              número máximo de páginas a rastrear indica o limite max_crawl_pages que você especificou ao definir uma tarefa

            • pages_crawled
              Tipo: integer | null Formato: int64

              número de páginas rastreadas

            • pages_in_queue
              Tipo: integer | null Formato: int64

              número de páginas atualmente na fila de rastreamento

          • crawl_stop_reason
            Tipo: string | null

            motivo pelo qual o rastreamento parou
            informações sobre o motivo pelo qual o processo de rastreamento parou;
            valores possíveis:
            limit_exceeded - o limite definido em max_crawl_pages foi excedido;
            empty_queue - todas as URLs na fila foram rastreadas;
            force_stopped - o processo de rastreamento foi interrompido usando a função On Page API Force Stop;
            unexpected_exception - foi encontrado um erro interno durante o rastreamento do target; entre em contato com o suporte para mais informações

          • domain_info
            Tipo: object | null · Response36Afe1097B20_DomainInfo

            informações de todo o domínio
            informações on-page sobre o domínio de destino e o processo de rastreamento

            • canonicalization_status_code
              Tipo: integer | null

              código de status retornado por uma página canonizada
              a verificação do comportamento do servidor quando nosso rastreador tenta acessar o site via IP;
              na maioria dos casos, recomenda-se que as páginas canonizadas respondam com um código de status 301 ou 302

            • checks
              Tipo: object | null

              verificações do site
              outras verificações na página relacionadas ao site

              • propertyName
                Tipo: boolean | null
            • cms
              Tipo: string | null

              sistema de gerenciamento de conteúdo
              sistema de gerenciamento de conteúdo identificado em um site
              o conteúdo da meta tag generator
              os dados são obtidos da primeira página aleatória que retorna o código de resposta 200
              se nosso rastreador não conseguiu identificar o CMS, o valor seria nulln

            • crawl_end
              Tipo: string | null

              hora em que o rastreamento terminou
              data e hora em que o rastreamento foi concluído
              no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              exemplo:
              2019-11-15 12:57:46 +00:00
              Observação: informativo apenas se "crawl_progress" for "finished"
              se "crawl_progress" for in_progress, o valor será null

            • crawl_start
              Tipo: string | null

              hora em que o rastreamento começou
              data e hora em que o site foi enviado para rastreamento
              no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              exemplo:
              2019-11-15 12:57:46 +00:00

            • directory_browsing_status_code
              Tipo: integer | null

              código de status retornado por um diretório
              o código de status retornado por uma página de diretório em um site de destino
              na maioria dos casos, recomenda-se que os diretórios respondam com um código de status 403 ou 401

            • extended_crawl_status
              Tipo: string | null

              status e erros do rastreamento
              indica o motivo pelo qual um site não foi rastreado;
              pode assumir os seguintes valores:
              no_errors - nenhum erro de rastreamento foi detectado;
              site_unreachable - nosso rastreador não conseguiu acessar um site e, portanto, não conseguiu obter um código de status;
              invalid_page_status_code - código de status da primeira página rastreada >= 400;
              forbidden_meta_tag - a primeira página rastreada contém a tag <meta robots="noindex">;
              forbidden_robots - robots.txt proíbe o rastreamento da página;
              forbidden_http_header - o cabeçalho HTTP da página contém "X-Robots-Tag: noindex" ;
              too_many_redirects - a primeira página rastreada tem mais de 10 redirecionamentos;
              unknown - o motivo é desconhecido

            • ip
              Tipo: string | null

              endereço IP do domínio

            • main_domain
              Tipo: string | null

              nome do domínio raiz

            • name
              Tipo: string | null

              nome do domínio

            • page_not_found_status_code
              Tipo: integer | null

              código de status retornado por uma página inexistente
              na maioria dos casos, recomenda-se que um servidor retorne um código de resposta 404

            • server
              Tipo: string | null

              servidor do site
              a versão do servidor detectada em um site
              o conteúdo do cabeçalho server
              as informações são obtidas da primeira página cujo código de resposta é 200

            • ssl_info
              Tipo: object | null · Response36Afe1097B20_SslInfo

              informações do certificado SSL
              informações sobre o protocolo Secure Sockets Layer detectado em um site

              • certificate_expiration_date
                Tipo: string | null

                data de expiração do certificado SSL
                a data e hora em que o certificado SSL expira
                no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                exemplo:
                2019-11-15 12:57:46 +00:00

              • certificate_hash
                Tipo: string | null

                hash do certificado SSL
                a versão da função hash do certificado SSL

              • certificate_issuer
                Tipo: string | null

                autoridade do certificado SSL
                a entidade que emitiu o certificado SSL detectado

              • certificate_subject
                Tipo: string | null

                titular do certificado SSL
                a entidade associada à chave pública

              • certificate_version
                Tipo: integer | null

                versão do certificado SSL
                indica a versão de X.509 usada por um certificado SSL

              • valid_certificate
                Tipo: boolean | null

                validade do certificado SSL
                indica se o certificado SSL detectado em um site não está expirado, suspenso, revogado ou inválido

            • total_pages
              Tipo: integer | null Formato: int64

              total de páginas rastreadas
              o número total de páginas rastreadas

            • total_uncrawlable_resources
              Tipo: integer | null Formato: int64

              total de recursos não rastreáveis
              o número total de recursos que não puderam ser rastreados;
              o recurso é considerado não rastreável quando o tipo de conteúdo real do recurso não corresponde ao tipo de conteúdo esperado pelo rastreador

            • www_redirect_status_code
              Tipo: integer | null

              código de status do redirecionamento
              o código de status do redirecionamento de www para não www
              na maioria dos casos, recomenda-se que o redirecionamento retorne um código de status 301

          • page_metrics
            Tipo: object | null · Response36Afe1097B20_PageMetrics

            informações específicas da página
            métricas das páginas do site de destino

            • broken_links
              Tipo: integer | null

              número de links quebrados
              número de links quebrados em todas as páginas rastreadas de um site de destino

            • broken_resources
              Tipo: integer | null

              número de recursos quebrados
              o número de imagens e outros recursos com links quebrados

            • checks
              Tipo: object | null

              verificações on-page específicas da página

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • duplicate_content
              Tipo: integer | null

              número de páginas com conteúdo duplicado

            • duplicate_description
              Tipo: integer | null

              número de páginas com descrições duplicadas

            • duplicate_title
              Tipo: integer | null

              número de páginas com títulos duplicados

            • links_external
              Tipo: integer | null

              número de links externos
              o número de links que apontam para outros sites

            • links_internal
              Tipo: integer | null

              número de links internos
              o número de links que apontam para outras páginas dentro do site de destino

            • links_relation_conflict
              Tipo: integer | null

              número de links presentes no site de destino que podem ter conflito
              por exemplo, se "links_relation_conflict": 2, o site de destino faz referência à mesma origem por pelo menos um link interno com o atributo rel="nofollow" e por pelo menos um link dofollow

            • non_indexable
              Tipo: integer | null

              número de páginas não indexáveis
              número de páginas que estão bloqueadas de serem indexadas pelo Google e outros mecanismos de busca por robots.txt, cabeçalhos HTTP ou configurações de tags meta;
              você pode receber uma lista de URLs não indexáveis usando este endpoint

            • onpage_score
              Tipo: number | null

              mostra o quão otimizado o site está em uma escala de 100 pontos
              este campo mostra o quão otimizado o site está considerando problemas críticos e avisos detectados na página;
              100 é a pontuação máxima possível, o que significa que o site não tem nenhum problema crítico nem avisos importantes;
              observação: este valor depende do número de páginas rastreadas;
              saiba mais sobre como a métrica é calculada neste artigo da central de ajuda

            • redirect_loop
              Tipo: integer | null

              número de cadeias de redirecionamento que começam e terminam na mesma URL
              número de cadeias de redirecionamento em que a URL de destino redireciona de volta para a URL original

        • 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 get/v1/beta/dataforseo/on_page/summary/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/summary/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "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": [
        {
          "crawl_progress": null,
          "crawl_status": {
            "max_crawl_pages": null,
            "pages_in_queue": null,
            "pages_crawled": null
          },
          "crawl_gateway_address": null,
          "crawl_stop_reason": null,
          "domain_info": {
            "name": null,
            "cms": null,
            "ip": null,
            "server": null,
            "crawl_start": null,
            "crawl_end": null,
            "extended_crawl_status": null,
            "ssl_info": "[Max Depth Exceeded]",
            "checks": null,
            "total_pages": null,
            "total_uncrawlable_resources": null,
            "page_not_found_status_code": null,
            "canonicalization_status_code": null,
            "directory_browsing_status_code": null,
            "www_redirect_status_code": null,
            "main_domain": null
          },
          "page_metrics": {
            "links_external": null,
            "links_internal": null,
            "duplicate_title": null,
            "duplicate_description": null,
            "duplicate_content": null,
            "broken_links": null,
            "broken_resources": null,
            "links_relation_conflict": null,
            "redirect_loop": null,
            "onpage_score": null,
            "non_indexable": null,
            "checks": null
          }
        }
      ]
    }
  ]
}

Operação bem-sucedida

OnPage API Summary