DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Microdata da OnPage API
Valida os dados estruturados de uma url rastreada. 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. ⚠️ A página precisa ter feito parte do rastreamento: pedir uma URL que não fez retorna status_code 40406, Requested page was not submitted for crawling, dentro de um HTTP 200. Aumente max_crawl_pages ou defina start_url na chamada de envio se a página desejada estiver faltando. 💰 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.
- Tipo: array (object | null)[]
- idTipo: string
- 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 do recurso
campo obrigatório
você pode obter esta URL na resposta do endpoint Pages
exemplo:https://dataforseo.com/apis
- Tipo: object | null · Response36Afe1097B20_OnPageMicrodataResponseInfo200
- 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_OnPageMicrodataTaskInfo
- 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 - crawlTipo: object | null · Response36Afe1097B20_CrawlStatusInfo
_status detalhes da sessão de rastreamento
- maxTipo: integer | null Formato: int64
_crawl _pages número máximo de páginas a rastrear indica o limite max_crawl_pages que você especificou ao definir uma tarefa
- pagesTipo: integer | null Formato: int64
_crawled número de páginas rastreadas
- pagesTipo: integer | null Formato: int64
_in _queue número de páginas atualmente na fila de rastreamento
- itemsTipo: array (object | null)[] | null
array items
- inspectionTipo: object | null · Response36Afe1097B20_MicrodataInspectionInfo
_info informações relacionadas à validação de microdados
- fieldsTipo: array (object | null)[] | null
campos de microdados
um array de objetos que contém campos de dados relacionados ao tipo de microdados específico- fieldsTipo: array (object | null)[] | null
campos de microdados
um array de objetos que contém campos de dados relacionados ao tipo de microdados específico- fieldsTipo: array (object | null)[] | null
campos de microdados
um array de objetos que contém campos de dados relacionados ao tipo de microdados específico - nameTipo: string | null
nome do campo
nome do campo de dados - testTipo: object | null · Response36Afe1097B20_MessageInfo
_results resultados do teste de validação de microdados
resultados do teste de microdados do subtipo que contêm erros detectados e mensagens relacionadas- levelTipo: string | null
nível do erro pode assumir os seguintes valores: fatal, error, warning, info
- messageTipo: string | null
mensagem associada a um erro mensagem que fornece os detalhes do erro detectado
- typesTipo: array (string | null)[] | null
lista de tipos de microdados
- valueTipo: string | null
valor de microdados valor de microdados especificado em uma página web de destino
- nameTipo: string | null
nome do campo
nome do campo de dados - testTipo: object | null · Response36Afe1097B20_MessageInfo
_results resultados do teste de validação de microdados
resultados do teste de microdados do subtipo que contêm erros detectados e mensagens relacionadas- levelTipo: string | null
nível do erro pode assumir os seguintes valores: fatal, error, warning, info
- messageTipo: string | null
mensagem associada a um erro mensagem que fornece os detalhes do erro detectado
- typesTipo: array (string | null)[] | null
lista de tipos de microdados
- valueTipo: string | null
valor de microdados valor de microdados especificado em uma página web de destino
- typesTipo: array (string | null)[] | null
- typeTipo: string | null
tipo de elemento
- itemsTipo: integer | null Formato: int64
_count número de itens no array de resultados
- testTipo: object | null · Response36Afe1097B20_TestSummary
_summary resultados do teste de validação de microdados
- errorTipo: integer | null
número de erros graves de microdata
- fatalTipo: integer | null
número de erros fatais de microdata
- infoTipo: integer | null
número de sinalizações informativas de microdata
- warningTipo: integer | null
número de avisos de microdata
- 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/microdata \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "02241700-1535-0216-0000-034137259bc1",
"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,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"test_summary": {
"fatal": null,
"error": null,
"warning": null,
"info": null
},
"items_count": null,
"items": [
{
"type": null,
"inspection_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}