Google Dataset Info Advanced em tempo real
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Dataset Info Advanced em tempo real
Retorna o registro de um conjunto de dados no Google Dataset Search, de forma síncrona. Retorna keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count e items. advanced é a escolha padrão; use regular quando apenas a lista classificada importar e html somente para verificar o que o analisador descartou. 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.02.
- 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)[]
- datasetTipo: string
_id ID do conjunto de dados
campo obrigatório
você pode encontrar o ID do conjunto de dados na URL do conjunto de dados ou no item
datasetdo resultado da Google Dataset Searchexemplo:
L2cvMTFqbl85ZHN6MQ== - deviceTipo: string | null
tipo de dispositivo
campo opcional
retorna resultados para um tipo específico de dispositivo
valor possível:
desktop - languageTipo: string | null
_code código de idioma do mecanismo de busca
campo opcional
se você usar este campo, não precisa especificar
language_namevalor possível:
en - languageTipo: string | null
_name nome completo do idioma do mecanismo de busca
campo opcional
se você usar este campo, não precisa especificar
language_codevalor possível:
English - osTipo: string | null
sistema operacional do dispositivo
campo opcional
valores possíveis:
windows,macosvalor padrão:
windows - tagTipo: string | null
identificador de tarefa definido pelo usuário
campo opcional
o limite é de 255 caracteres
você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado
você encontrará o valor
tagespecificado no objetodatada resposta
- Tipo: object | null · Response36Afe1097B20_SerpGoogleDatasetInfoLiveAdvancedResponseInfo200
- 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_SerpGoogleDatasetInfoLiveAdvancedTaskInfo
- 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
- checkTipo: string | null
_url URL direta para os resultados do mecanismo de busca
você pode usá-la para garantir que fornecemos resultados precisos - datetimeTipo: string | null
data e hora em que o resultado foi recebido
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2019-11-15 12:57:46 +00:00 - itemTipo: array (string | null)[] | null
_types tipos de resultados de pesquisa na SERP
contém os tipos de resultados de pesquisa (items) encontrados na SERP.
tipo de item possível:dataset - itemsTipo: array (object | null)[] | null
elementos de resultados de pesquisa encontrados na SERP
- areaTipo: array (string | null)[] | null
_covered a lista de áreas cobertas no conjunto de dados
por exemplo:Africa,Global - authorsTipo: array (object | null)[] | null
a lista de autores do conjunto de dados
- domainTipo: string | null
domínio do link do autor
- nameTipo: string | null
nome do autor do conjunto de dados
- typeTipo: string | null
tipo de elemento
- urlTipo: string | null
URL do link do autor
- datasetTipo: object | null · Response36Afe1097B20_DatasetDescription
_description descrição do conjunto de dados
- linksTipo: array (object | null)[] | null
links apresentados em 'dataset_description'
- descriptionTipo: string | null
descrição do elemento de resultados
- domainTipo: string | null
domínio para o qual um link aponta
- snippetTipo: string | null
texto ao lado do título do link
- titleTipo: string | null
título de um determinado elemento de link
- typeTipo: string | null
tipo de elemento
- urlTipo: string | null
URL
- xpathTipo: string | null
o XPath do elemento
- textTipo: string | null
texto da descrição
- datasetTipo: string | null
_id ID do conjunto de dados
- datasetTipo: array (object | null)[] | null
_providers a lista de instituições que forneceram o conjunto de dados
- domainTipo: string | null
domínio na SERP
- titleTipo: string | null
título do elemento
- typeTipo: string | null
tipo de elemento
- urlTipo: string | null
URL de pesquisa com parâmetros de refinamento
- formatsTipo: array (object | null)[] | null
a lista de formatos de arquivo do conjunto de dados
- formatTipo: string | null
tipo de formato de arquivo do conjunto de dados
por exemplo:zip,html,csv - sizeTipo: integer | null Formato: int64
tamanho do arquivo em bytes
- typeTipo: string | null
tipo de elemento
- imageTipo: string | null
_url URL da imagem
a URL que leva à imagem no recurso original ou no armazenamento do DataForSEO (caso a fonte original não esteja disponível) - licensesTipo: array (object | null)[] | null
a lista de licenças emitidas para o conjunto de dados
- domainTipo: string | null
domínio na SERP
- titleTipo: string | null
título do elemento
- typeTipo: string | null
tipo de elemento
- urlTipo: string | null
URL de pesquisa com parâmetros de refinamento
- linksTipo: array (object | null)[] | null
sitelinks
os links exibidos abaixo de alguns resultados de pesquisa do Google Dataset
se não houver nenhum, equivale anull- descriptionTipo: string | null
descrição do elemento de resultados
- domainTipo: string | null
domínio para o qual um link aponta
- snippetTipo: string | null
texto ao lado do título do link
- titleTipo: string | null
título de um determinado elemento de link
- typeTipo: string | null
tipo de elemento
- urlTipo: string | null
URL
- xpathTipo: string | null
o XPath do elemento
- periodTipo: object | null · Response36Afe1097B20_PeriodCovered
_covered período coberto no conjunto de dados
- displayedTipo: string | null
_date período exibido no SERP
exemplo:Mar 2, 2020 - Dec 9, 2022 - endTipo: string | null
_date data e hora em que o período termina
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2022-12-09 02:00:00 +00:00 - startTipo: string | null
_date data e hora em que o período começa
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2020-03-02 02:00:00 +00:00
- positionTipo: string | null
o alinhamento do elemento na SERP
pode assumir os seguintes valores:left,right - rankTipo: integer | null
_absolute classificação absoluta na SERP
posição absoluta entre todos os elementos da SERP - rankTipo: integer | null
_group classificação de grupo na SERP
posição dentro de um grupo de elementos com valores detypeidênticos
as posições dos elementos com valores detypediferentes são omitidas derank_group - relatedTipo: string | null
_article link para o artigo relacionado
link para o artigo publicado relacionado ao conjunto de dados - scholarlyTipo: string | null
_articles _url URL de artigos acadêmicos
link para a lista de artigos acadêmicos no Google Scholar
exemplo:https://scholar.google.com/scholar?q=%2210.6084%20m9%20figshare%207427933%20v1%22 - scholarlyTipo: integer | null Formato: int64
_citations _count contagem de artigos que fazem referência ao conjunto de dados
- titleTipo: string | null
título do elemento
- typeTipo: string | null
tipo de elemento
- uniqueTipo: string | null
_identifier identificador digital de um objeto
identificador digital exclusivo do conjunto de dados
exemplo:https://doi.org/10.5061/dryad.hmgqnk9m3 - updatedTipo: string | null
_date data e hora em que o resultado foi atualizado pela última vez
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2022-11-27 02:00:00 +00:00 - xpathTipo: string | null
- itemsTipo: integer | null Formato: int64
_count o número de resultados retornados no array
items - keywordTipo: string | null
palavra-chave recebida em um array POST
a palavra-chave é retornada com %## decodificado (o caractere '+' será decodificado como um espaço) - languageTipo: string | null
_code código de idioma em um array POST
- seTipo: string | null
_domain domínio do mecanismo de busca em um array POST
- seTipo: integer | null Formato: int64
_results _count total de resultados na SERP
- spellTipo: object | null · Response36Afe1097B20_SpellInfo
autocorreção do mecanismo de busca
se o mecanismo de busca forneceu resultados para uma palavra-chave corrigida, indicaremos a palavra-chave corrigida pelo mecanismo de busca e o tipo de autocorreção- keywordTipo: string | null
palavra-chave obtida como resultado da autocorreção do mecanismo de pesquisa os resultados serão fornecidos para a palavra-chave corrigida
- typeTipo: string | null
tipo de autocorreção valores possíveis: did_you_mean, showing_results_for, no_results_found_for, including_results_for observação: Yahoo e Yandex suportam apenas o seguinte tipo de autocorreção: including_results_for
- 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/serp/google/dataset_info/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"dataset_id": "L2cvMTFqbl85ZHN6MQ=="
}
]'
{
"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": [
{
"keyword": null,
"se_domain": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"item_types": [
null
],
"se_results_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"position": null,
"xpath": null,
"dataset_id": null,
"title": null,
"image_url": null,
"scholarly_citations_count": null,
"scholarly_articles_url": null,
"unique_identifier": null,
"related_article": null,
"links": [
"[Max Depth Exceeded]"
],
"dataset_providers": [
"[Max Depth Exceeded]"
],
"formats": [
"[Max Depth Exceeded]"
],
"authors": [
"[Max Depth Exceeded]"
],
"licenses": [
"[Max Depth Exceeded]"
],
"updated_date": null,
"area_covered": [
"[Max Depth Exceeded]"
],
"period_covered": "[Max Depth Exceeded]",
"dataset_description": "[Max Depth Exceeded]"
}
]
}
]
}
]
}