JSON do Lighthouse OnPage em tempo real
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
JSON do Lighthouse OnPage em tempo real
Executa uma auditoria do Google Lighthouse em uma url e retorna o relatório completo: lighthouseVersion, requestedUrl, finalUrl, fetchTime, gatherMode, runWarnings e todas as pontuações de auditoria e categoria. for_mobile troca o dispositivo emulado; categories e audits restringem a execução. Passe categories ou audits para reduzi-la, e prefira post_dataforseo_on_page_waterfall quando a pergunta for simplesmente por que uma página está lenta. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200.
Referência de preços
- Medição: Custo da resposta reportado.
- Estimativa de referência por requisição: USD 0.005.
- 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)[]
- auditsTipo: array string[] | null
auditorias do Lighthouse
campo opcional
as auditorias são testes individuais que o Lighthouse executa para cada recurso/otimização/métrica específica, a fim de produzir uma pontuação numérica (consulte a definição oficial);se você ignorar este campo, retornaremos dados para todas as auditorias;
use este campo para obter dados de auditorias específicas indicadas aqui;Observação: algumas auditorias não pertencem a uma categoria específica e são medições independentes de qualidade da página;
em geral, pode haver vários casos de uso:
1. se você ignorar
categories, poderá usar este campo para obter dados apenas das auditorias especificadas
por exemplo, se você ignorar"categories"e especificar"audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"], obterá dados apenas dessas auditorias2. se você especificar uma categoria, poderá usar este campo para receber também auditorias que não pertencem à(s) categoria(s) especificada(s)
por exemplo, se você especificar"categories": ["seo"]e"audits": ["metrics/cumulative-layout-shift","metrics/largest-contentful-paint","metrics/total-blocking-time"], obterá apenas essas auditorias em "performance" e todas as auditorias em "seo"você pode obter a lista completa das auditorias possíveis aqui
- browserTipo: number | null
_cpu _throttling _multiplier multiplicador de limitação de CPU do navegador
obrigatório sebrowser_network_throttling_methodestiver definido comodevtools;
defina o multiplicador de limitação de CPU para simular as condições de desempenho do dispositivo durante a auditoria do Lighthouse;
pode ser especificado dentro do seguinte intervalo:1–4;
Observação: este parâmetro só é aplicado quandobrowser_network_throttling_methodestá definido comodevtools; - browserTipo: string | null
_network _throttling limitação de rede do navegador
obrigatório sebrowser_network_throttling_methodestiver definido comodevtools;
defina o perfil de limitação de rede para simular as condições de velocidade de conexão durante a auditoria do Lighthouse;
valores possíveis:no_throttling,fast_4g,slow_4g,regular_3g,pc;
Observação: este parâmetro só é aplicado quandobrowser_network_throttling_methodestá definido comodevtools; - browserTipo: string | null
_network _throttling _method método de limitação de rede do navegador
campo opcional
define o método usado para aplicar a limitação durante a auditoria do Lighthouse;
valores possíveis:simulate- calcula métricas de desempenho estimadas sem aplicar limitação explícita;devtools- aplica as configurações de limitação especificadas embrowser_network_throttlingebrowser_cpu_throttling_multiplier;provided- usa as condições de rede do ambiente de rastreamento; - browserTipo: integer | null
_screen _height altura da tela do navegador
campo opcional
defina a altura da tela do navegador usado para a auditoria do Lighthouse para emular um dispositivo específico;
pode ser especificada dentro do seguinte intervalo:240–9999; - browserTipo: number | null
_screen _scale _factor fator de escala da tela do navegador
campo opcional
defina a proporção de pixels do dispositivo do navegador usado para a auditoria do Lighthouse;
pode ser especificada dentro do seguinte intervalo:0.5–3; - browserTipo: integer | null Formato: int64
_screen _width largura da tela do navegador
campo opcional
defina a largura da tela do navegador usado para a auditoria do Lighthouse para emular um dispositivo específico;
pode ser especificada dentro do seguinte intervalo:240–9999; - categoriesTipo: array string[] | null
categorias de auditorias do Lighthouse
campo opcional
cada categoria é uma coleção de auditorias e grupos de auditorias que aplica ponderação e pontuação à seção (consulte a definição oficial)se você ignorar este campo, retornaremos dados de todas as categorias, a menos que você especifique
audits
use este campo para obter dados das categorias específicas indicadas aquivalores possíveis:
seo,performance,best_practices,accessibility - customTipo: string | null
_user _agent user agent personalizado
campo opcional
especifique o user agent personalizado usado pelo navegador ao executar a auditoria do Lighthouse;
pode ser especificado com até 254 caracteres; - forTipo: boolean | null
_mobile aplica emulação de dispositivo móvel
campo opcional
se definido comotrue, o Lighthouse usará emulação de dispositivo e tela móveis para testar a página no ambiente móvel
se definido comofalse, os resultados serão fornecidos para desktop
valor padrão:false - languageTipo: string | null
_code código de idioma do Lighthouse
campo opcional
você pode receber a lista de idiomas disponíveis do mecanismo de busca com seuslanguage_codefazendo uma requisição separada parahttps://api.dataforseo.com/v3/on_page/lighthouse/languages
valor padrão:en - languageTipo: string | null
_name nome do idioma do Lighthouse
campo opcional
você pode receber a lista de idiomas disponíveis do mecanismo de busca com seuslanguage_namefazendo uma requisição separada parahttps://api.dataforseo.com/v3/on_page/lighthouse/languages
valor padrão:English - tagTipo: 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 detagespecificado no objetodatada resposta - urlTipo: string
URL de destino
campo obrigatório
a página de destino deve ser especificada com sua URL absoluta (incluindo http:// ou https://)
exemplo:https://dataforseo.com/ - versionTipo: string | null
- Tipo: object | null · Response36Afe1097B20_OnPageLighthouseLiveJsonResponseInfo200
- 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_OnPageLighthouseLiveJsonTaskInfo
- 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
resultados da auditoria do Lighthouse
este array incluirá dados de acordo com os parâmetros que você especificou ao definir uma tarefa;todos os campos e suas descrições estão disponíveis na documentação oficial neste link.
- propertyTipo: object | null
Name
- 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/lighthouse/live/json \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"url": "https://dataforseo.com",
"for_mobile": true,
"tag": "some_string_123"
}
]'
{
"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": [
null
]
}
]
}