v0.2.0-beta

OpenAPI 3.1.0

Recursos 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

post/v1/beta/dataforseo/on_page/resources

Recursos da OnPage API

Os recursos que não são páginas encontrados por um rastreamento — imagens, scripts, folhas de estilo — com seus códigos de status e tamanhos. Paginado com search_after_token. Lê um rastreamento concluído, portanto precisa do id de post_dataforseo_on_page_submit e retorna crawl_progress mais um crawl_status com max_crawl_pages, pages_in_queue e pages_crawled — verifique esses valores antes de confiar em um resultado pequeno, pois um rastreamento ainda em andamento simplesmente tem menos a relatar. Para os recursos que o rastreador não conseguiu acessar, use post_dataforseo_on_page_uncrawlable_resources. 💰 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.

Corpo

application/json

Tipo: array (object | null)[]
- 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)
  você deve definir um operador lógico and, or entre as condições
  os seguintes operadores são suportados:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  você pode usar o operador % com like e not_like para corresponder a qualquer string de zero ou mais caracteres
  exemplo:
  ["resource_type","=","stylesheet"]
  
  [["resource_type","=","image"], "and",["checks.is_https","=",false]]
  
  [["fetch_timing.duration_time",">",1],"and",[["total_transfer_size",">",100],"or",["checks.high_loading_time","=",true]]]
  
  A lista completa dos filtros possíveis está disponível neste link.
  
  Objeto vazio
- id
  Tipo: string
  
  ID da tarefa
  campo obrigatório
  você pode obter este ID na resposta do endpoint Task POST
  exemplo:
  "07131248-1535-0216-1000-17384017ad04"
- limit
  Tipo: integer | null
  
  o número máximo de recursos retornados
  campo opcional
  valor padrão: 100
  valor máximo: 1000
- offset
  Tipo: integer | null
  
  deslocamento no array de resultados dos recursos retornados
  campo opcional
  valor padrão: 0
  valor máximo: 2000000
  se você especificar o valor 10, os dez primeiros recursos do array de resultados serão omitidos e os dados serão fornecidos para os recursos 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
  você deve usar uma vírgula para definir um tipo de ordenação
  exemplo:
  ["size,desc"]
  observe que você pode definir no máximo três regras de ordenação em uma única requisição
  você deve usar uma vírgula para separar várias regras de ordenação
  exemplo:
  ["size,desc","fetch_timing.fetch_end,desc"]
- relevant_pages_filters
  Tipo: array string[] | null
  
  filtrar os recursos pelas páginas relevantes
  campo opcional
  você pode usar este campo para obter recursos de páginas que correspondem aos parâmetros definidos
  você pode aplicar aqui os mesmos filtros disponíveis no endpoint pages
  você pode adicionar vários filtros de uma vez (máximo de 8 filtros)
  você deve definir um operador lógico and, or entre as condições
  os seguintes operadores são suportados:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  você pode usar o operador % com like e not_like para corresponder a qualquer string de zero ou mais caracteres
  exemplo:
  ["checks.no_image_title","=",true]
- 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
- url
  Tipo: string | null
  
  URL da página
  campo opcional
  especifique este campo se quiser obter os recursos de uma página específica
  observe que, para obter o meta de um recurso de uma determinada URL, você deve especificar a URL neste campo;
  se você não indicar um url ao definir uma tarefa, o meta do recurso nos resultados será retornado com base nos dados da página onde nosso rastreador viu o recurso pela primeira vez

Respostas

200
Tipo: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo
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_OnPageResourcesTaskInfo
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_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

current_offset
Tipo: integer | null

Integer numbers.

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

array items

cache_control
Tipo: object | null · Response36Afe1097B20_CacheControl

instruções para cache

cachable
Tipo: boolean | null

indica se a página pode ser armazenada em cache

ttl
Tipo: integer | null

tempo de vida o tempo durante o qual o navegador armazena um recurso em cache

checks
Tipo: object | null

verificações do site verificações na página relacionadas à página

propertyName
Tipo: boolean | null
content_encoding
Tipo: string | null

tipo de codificação

encoded_size
Tipo: integer | null

tamanho da página após a codificação indica o tamanho da página codificada medido em bytes

fetch_time
Tipo: string | null

data e hora em que um recurso foi obtido no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” exemplo: 2019-11-15 12:57:46 +00:00

last_modified
Tipo: object | null · Response36Afe1097B20_LastModified

contém dados sobre alterações relacionadas ao recurso se não houver dados, o valor será null

header
Tipo: string | null

data e hora da última modificação do cabeçalho no formato UTC: "yyyy-mm-dd hh-mm-ss +00:00" exemplo: 2019-11-15 12:57:46 +00:00 se não houver dados, o valor será null

meta_tag
Tipo: string | null

data e hora da última modificação da meta tag no formato UTC: "yyyy-mm-dd hh-mm-ss +00:00" exemplo: 2019-11-15 12:57:46 +00:00 se não houver dados, o valor será null

sitemap
Tipo: string | null

data e hora da última modificação do sitemap no formato UTC: "yyyy-mm-dd hh-mm-ss +00:00" exemplo: 2019-11-15 12:57:46 +00:00 se não houver dados, o valor será null

location
Tipo: string | null

cabeçalho de localização indica a URL para a qual redirecionar uma página

media_type
Tipo: string | null

tipos de mídia usados para exibir uma página

resource_errors
Tipo: object | null · Response36Afe1097B20_OnPageResourceIssueInfo

erros e avisos do recurso

errors
Tipo: array (object | null)[] | null

erros de recurso

column
Tipo: integer | null

coluna onde o erro foi encontrado

line
Tipo: integer | null

linha onde o erro foi encontrado

message
Tipo: string | null

mensagem de texto do erro; a lista completa de erros HTML possíveis pode ser encontrada aqui

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

warnings
Tipo: array (object | null)[] | null

avisos de recurso

column
Tipo: integer | null

coluna onde o erro foi encontrado

line
Tipo: integer | null

linha onde o erro foi encontrado

message
Tipo: string | null

mensagem de texto do erro; a lista completa de erros HTML possíveis pode ser encontrada aqui

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

resource_type
Tipo: string | null

tipo de elemento

server
Tipo: string | null

versão do servidor

size
Tipo: integer | null

tamanho do recurso indica o tamanho de uma determinada página medido em bytes

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

total_transfer_size
Tipo: integer | null Formato: int64

tamanho da página compactada indica o tamanho compactado de uma determinada página

url
Tipo: string | null

URL da página

items_count
Tipo: integer | null Formato: int64

número de itens no array de resultados

search_after_token
Tipo: string | null
total_items_count
Tipo: integer | null Formato: int64

número total de itens relevantes rastreados

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/on_page/resources

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/resources \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "07281559-0695-0216-0000-c269be8b7592",
    "filters": [
      [
        "resource_type",
        "=",
        "image"
      ],
      "and",
      [
        "size",
        ">",
        100000
      ]
    ],
    "order_by": [
      "size,desc"
    ],
    "limit": 10
  }
]'

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": [
        {
          "crawl_progress": null,
          "crawl_status": {
            "max_crawl_pages": null,
            "pages_in_queue": null,
            "pages_crawled": null
          },
          "search_after_token": null,
          "current_offset": null,
          "total_items_count": null,
          "items_count": null,
          "items": [
            {
              "resource_type": null,
              "status_code": null,
              "location": null,
              "url": null,
              "resource_errors": "[Max Depth Exceeded]",
              "size": null,
              "encoded_size": null,
              "total_transfer_size": null,
              "fetch_time": null,
              "cache_control": "[Max Depth Exceeded]",
              "checks": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "last_modified": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operação bem-sucedida

Recursos da OnPage API

AutenticaçãoRequired

DataForSEO

Recursos da OnPage API

Referência de preços