Captura de tela de página da OnPage API
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Captura de tela de página da OnPage API
Renderiza qualquer url e retorna uma captura de tela, com full_page_screenshot para toda a altura de rolagem e browser_screen_width e browser_screen_height definindo a viewport. Autônomo — não precisa de rastreamento. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. ⚠️ Uma imagem é um resultado de ferramenta grande mesmo antes de um agente poder fazer algo com ela; peça uma captura de tela apenas quando o visual for o ponto, e use post_dataforseo_on_page_content_parsing_live quando o texto for.
Referência de preços
- Medição: Custo da resposta reportado.
- Estimativa de referência por requisição: USD 0.0051.
- 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.
- Tipo: array (object | null)[]
- acceptTipo: string | null
_language cabeçalho de idioma para acessar o site
campo opcional
todos os formatos de locale são suportados (xx, xx-XX, xxx-XX, etc.)
observação: se você não especificar este parâmetro, alguns sites podem negar o acesso; nesse caso, você obterá"error_message":"Screenshot is empty"no array de resposta - browserTipo: string | null
_preset preset para parâmetros de tela do navegador
campo opcional
se você usar este campo, não precisa indicarbrowser_screen_width,browser_screen_height,browser_screen_scale_factorvalores possíveis:
desktop,mobile,tableto preset
desktopaplicará os seguintes valores:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1o preset
mobileaplicará os seguintes valores:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3o preset
tabletaplicará os seguintes valores:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2Observação: neste endpoint, os parâmetros
enable_browser_rendering,enable_javascript,load_resourceseenable_xhrestão sempre habilitados. - browserTipo: integer | null
_screen _height altura da tela do navegador
campo opcional
você pode definir uma altura de tela de navegador personalizada para realizar a auditoria de um dispositivo específico;
se você usar este campo, não precisa indicarbrowser_preset, pois ele será ignorado;valor mínimo, em pixels:
240
valor máximo, em pixels:9999 - browserTipo: number | null
_screen _scale _factor fator de escala da tela do navegador
campo opcional
você pode definir uma proporção de resolução de tela de navegador personalizada para realizar a auditoria de um dispositivo específico;
se você usar este campo, não precisa indicarbrowser_preset, pois ele será ignorado;valor mínimo:
0.5
valor máximo:3 - browserTipo: integer | null Formato: int64
_screen _width largura da tela do navegador
campo opcional
você pode definir uma largura de tela de navegador personalizada para realizar a auditoria de um dispositivo específico;
se você usar este campo, não precisa indicarbrowser_preset, pois ele será ignorado;valor mínimo, em pixels:
240
valor máximo, em pixels:9999 - customTipo: string | null
_user _agent user agent personalizado
campo opcional
user agent personalizado para rastrear um site
exemplo:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
valor padrão:Mozilla/5.0 (compatible; RSiteAuditor) - disableTipo: boolean | null
_cookie _popup desativar o pop-up de cookies
campo opcional
defina comotruese quiser desativar o pop-up que solicita o consentimento de cookies do usuário;
valor padrão:false - fullTipo: boolean | null
_page _screenshot capturar uma captura de tela da página inteira
campo opcional
defina comofalsese quiser capturar apenas a parte da página exibida antes da rolagem
valor padrão:true - ipTipo: string | null
_pool _for _scan pool de proxies
campo opcional
você pode escolher um local do pool de proxies que será usado para obter os dados solicitados;
o parâmetro pode ser usado se o conteúdo da página estiver inacessível em um dos locais, resultando em errossite_unreachableocasionais
valores possíveis:us,de - switchTipo: boolean | null
_pool alternar pool de proxies
campo opcional
setrue, pools de proxies adicionais serão usados para obter os dados solicitados;
o parâmetro pode ser usado se uma grande quantidade de tarefas for definida simultaneamente, resultando em errosrate-limite/ousite_unreachableocasionais - urlTipo: string
URL da página
campo obrigatório
URL absoluta da página a capturar
observação: se a URL indicada aqui retornar um código de status 404 ou o valor indicado não for uma URL válida, você obterá"error_message":"Screenshot is empty"no array de resposta
- Tipo: object | null · Response36Afe1097B20_OnPagePageScreenshotResponseInfo200
- Tipo: number | null Formato: doublecost
custo total das tarefas, USD
- Tipo: integer | nullstatus
_code código de status geral você pode encontrar a lista completa dos códigos de resposta aqui
- Tipo: string | nullstatus
_message mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui
- Tipo: array (object | null)[] | nulltasks
array de tarefas
- Tipo: object | null · Response36Afe1097B20_OnPagePageScreenshotTaskInfo
- costTipo: number | null Formato: double
custo total das tarefas, USD
- dataTipo: object | null
contém os mesmos parâmetros que você especificou na requisição POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID
- pathTipo: array (string | null)[] | null
caminho da URL
- resultTipo: array (object | null)[] | null
array de resultados
- crawlTipo: string | null
_progress status da sessão de rastreamento
valores possíveis:in_progress,finished - errorTipo: string | null
_message mensagem de erro
se aurlindicada retornar um código de status 404 ou não for uma URL válida, você obterá"error_message":"Screenshot is empty"
se nenhum erro for encontrado, o valor seránull - itemsTipo: array (object | null)[] | null
array items
- imageTipo: string | null
captura de tela da página solicitada
URL da captura de tela da página no armazenamento do DataForSEO
observação: a captura de tela salva no armazenamento do DataForSEO permanece acessível por apenas um dia após a realização da requisição
- itemsTipo: integer | null Formato: int64
_count número de itens no array de resultados
- resultTipo: integer | null Formato: int64
_count número de elementos no array de resultados
- statusTipo: integer | null
_code 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
- statusTipo: string | null
_message mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui
- timeTipo: string | null
tempo de execução, segundos
- Tipo: integer | null Formato: int64tasks
_count o número de tarefas no array de tarefas
- Tipo: integer | null Formato: int64tasks
_error o número de tarefas no array de tarefas retornadas com erro
- Tipo: string | nulltime
tempo total de execução, em segundos
- Tipo: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/page_screenshot \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"url": "https://dataforseo.com/apis"
}
]'
{
"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,
"error_message": null,
"items_count": null,
"items": [
{
"image": null
}
]
}
]
}
]
}