Obter resultados de Business Data Google Extended Reviews por id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Obter resultados de Business Data Google Extended Reviews por id
Recupera por id uma tarefa enfileirada com o histórico completo de avaliações do Google de uma empresa, além da primeira página que o endpoint padrão retorna. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. ⚠️ O tamanho varia conforme o depth definido no envio e não pode ser reduzido aqui.
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: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetResponseInfo200
- 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_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo
- 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 - cidTipo: string | null
- 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 - featureTipo: string | null
_id - itemsTipo: array (object | null)[] | null
avaliações encontradas
você pode obter mais resultados usando o parâmetrodepthao definir uma tarefa- imagesTipo: array (object | null)[] | null
imagens enviadas pelo avaliador
- altTipo: string | null
tag alt da imagem
- 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) - typeTipo: string | null
tipo de elemento
- urlTipo: string | null
URL relevante
- localTipo: boolean | null
_guide indica se o avaliador tem o status de 'local guide'
- originalTipo: string | null
_owner _answer texto original da resposta do proprietário
a resposta original à avaliação, sem tradução automática aplicada - originalTipo: string | null
_review _text conteúdo original da avaliação
o conteúdo original da avaliação, sem tradução automática aplicada - ownerTipo: string | null
_answer texto da resposta do proprietário
a resposta do proprietário à avaliação - ownerTipo: string | null
_time _ago horário de publicação
indica o momento (no formato 'há quanto tempo') em que o proprietário enviou a resposta à avaliação - ownerTipo: string | null
_timestamp data e hora da resposta do proprietário à avaliação
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2019-11-15 12:57:46 +00:00 - photosTipo: integer | null Formato: int64
_count número total de fotos enviadas pelo avaliador
- positionTipo: string | null
o alinhamento da avaliação na SERP
pode assumir os seguintes valores:right - profileTipo: string | null
_image _url URL da imagem de perfil do avaliador
- profileTipo: string | null
_name nome de perfil do avaliador
- profileTipo: string | null
_url URL do perfil do avaliador
- rankTipo: integer | null
_absolute rank absoluto entre todas as avaliações listadas
posição absoluta entre todas as avaliações da lista - rankTipo: integer | null
_group posição dentro de um grupo de elementos com valores de
typeidênticos
as posições dos elementos com valores detypediferentes são omitidas derank_group - ratingTipo: object | null · Response36Afe1097B20_RatingInfo
a pontuação enviada pelo avaliador
- ratingTipo: integer | null
_max o valor máximo para um rating_type
- ratingTipo: string | null
_type o tipo de avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax
- valueTipo: number | null Formato: double
o valor da avaliação
- votesTipo: integer | null Formato: int64
_count a quantidade de feedback
- reviewTipo: array (object | null)[] | null
_highlights destaques da avaliação
contém critérios e avaliações em destaque- assessmentTipo: string | null
avaliação do aspecto
- featureTipo: string | null
aspecto avaliado
- reviewTipo: string | null
_id o identificador exclusivo de uma avaliação no Google
exemplo:ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE - reviewTipo: string | null
_text o conteúdo da avaliação
- reviewTipo: string | null
_url a URL da avaliação
- reviewsTipo: integer | null Formato: int64
_count número total de avaliações enviadas pelo avaliador
- sourceTipo: object | null · Response36Afe1097B20_Source
origem da avaliação
contém informações sobre o local onde a avaliação foi publicada- domainTipo: string | null
domínio da fonte onde a avaliação foi publicada
- imageTipo: string | null
imagem destacada da fonte
- titleTipo: string | null
nome da fonte onde a avaliação foi publicada
- timeTipo: string | null
_ago o horário de publicação
indica o momento (no formato 'há quanto tempo') em que a avaliação foi listada - timestampTipo: string | null
data e hora em que uma avaliação foi publicada
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:2019-11-15 12:57:46 +00:00 - typeTipo: string | null
tipo de elemento
- xpathTipo: string | null
- itemsTipo: integer | null Formato: int64
_count o número de itens de avaliações no array de resultados
você pode obter mais resultados usando o parâmetrodepthao definir uma tarefa - 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
- locationTipo: integer | null
_code código de localização em um array POST
- placeTipo: string | null
_id - ratingTipo: object | null · Response36Afe1097B20_RatingInfo
avaliação do estabelecimento local correspondente
taxa de popularidade com base nas avaliações e exibida na SERP- ratingTipo: integer | null
_max o valor máximo para um rating_type
- ratingTipo: string | null
_type o tipo de avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax
- valueTipo: number | null Formato: double
o valor da avaliação
- votesTipo: integer | null Formato: int64
_count a quantidade de feedback
- reviewsTipo: integer | null Formato: int64
_count o número total de avaliações
- seTipo: string | null
_domain domínio do mecanismo de busca em um array POST
- subTipo: string | null
_title subtítulo do elemento 'reviews' na SERP
informações adicionais (por exemplo, endereço) sobre o elemento 'reviews' para o qual as avaliações são coletadas - titleTipo: string | null
título do elemento 'reviews' na SERP
o nome do estabelecimento local para o qual as avaliações são coletadas - typeTipo: string | null
tipo de elemento
- 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/business_data/google/extended_reviews/task_get/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"title": null,
"sub_title": null,
"rating": {
"rating_type": null,
"value": null,
"votes_count": null,
"rating_max": null
},
"feature_id": null,
"place_id": null,
"cid": null,
"reviews_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"position": null,
"xpath": null,
"review_text": null,
"original_review_text": null,
"time_ago": null,
"timestamp": null,
"rating": "[Max Depth Exceeded]",
"reviews_count": null,
"photos_count": null,
"local_guide": null,
"profile_name": null,
"profile_url": null,
"review_url": null,
"profile_image_url": null,
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null,
"review_id": null,
"images": [
"[Max Depth Exceeded]"
],
"review_highlights": [
"[Max Depth Exceeded]"
],
"source": "[Max Depth Exceeded]"
}
]
}
]
}
]
}