Mapas e lugaresDisponível

Google Maps Reviews

Primeira página de avaliações do Google Maps de um local (por data_id): nota, texto, data, fotos e autor. Ainda não inclui respostas do proprietário.

Consulte cada endpoint com exemplos de requisição, parâmetros e o preço por requisição. Uma única chave de API chama todos; aplicam-se limites da conta.

Referência da API Abrir no Playground

Resumo

Endpoint: POST https://api.serpbase.dev/google/maps/reviews
Preço: 2 créditos / solicitação
Autenticação: X-API-Key
Tipo de resultado: schemas.source_data

Endpoint e regras de cobrança

POSThttps://api.serpbase.dev/google/maps/reviews

Custo por solicitação

2 créditos / solicitação

Cada solicitação usa o preço fixo do catálogo, não uma tarifa por página. Web Crawl e User Agent custam atualmente 1 crédito por solicitação cada; User Agent não é gratuito. A ausência real confirmada pela fonte e identidade do recurso é cobrada. no_results, HTTP 404 ou falta de hydration/dados analisados, isoladamente, não provam ausência. Falhas executadas podem consumir créditos; não há garantia de reembolso de todas as falhas. credits_charged informa a cobrança real: 0 indica zero; null ou campo ausente significa desconhecido. charge_status UNKNOWN permanece desconhecido mesmo com valor numérico. Confira os registros e contate o suporte com request_id; não presuma reembolso nem repita solicitações às cegas.

Exemplos de parâmetros

Os exemplos não são uma lista completa nem regras de obrigatoriedade. Campos conhecidos são validados e parâmetros adicionais são permitidos.

Exemplos de parâmetros
Parâmetro	Tipo do exemplo	Valor do exemplo
data_id	string	"0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"

JSON

{
  "data_id": "0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"
}

Os exemplos não são uma lista completa nem regras de obrigatoriedade. Campos conhecidos são validados e parâmetros adicionais são permitidos.
Alias	Parâmetro	Tipo
country	locale.country	string
cursor	pagination.cursor	string
dataID	data_id	string
device	options.device	string
gl	locale.country	string
google_domain	locale.engine_domain	string
gooogle_domain	locale.engine_domain	string
hl	locale.language	string
html	include_html	boolean
language	locale.language	string
limit	pagination.limit	integer
markdown	include_markdown	boolean
mobile	options.device	boolean
next_page_token	next_token	string
num	pagination.limit	integer
page	pagination.page	integer
q	query	string
results	pagination.limit	integer
topic_id	attributes.topic_id	string

Dispositivos: desktop; padrão: desktop.

Exemplos de solicitações

cURL

curl -X POST 'https://api.serpbase.dev/google/maps/reviews' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"data_id":"0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa"}'

JavaScript

const response = await fetch("https://api.serpbase.dev/google/maps/reviews", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"data_id\":\"0x89c25896f660c26f:0x3b2fa4f4b6c6a1fa\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);

Resposta e resultado da API

As respostas são JSON. HTTP 200 não prova sucesso: verifique status e error. Os campos dependem do contrato e dos dados de origem.

Ver documentação da resposta

Perguntas frequentes

Quanto custa a API de Google Maps Reviews?

Cada requisição custa 2 créditos. Os créditos vêm de pacotes pré-pagos ou do plano mensal, e contas novas começam com créditos grátis.

Como chamo a API de Google Maps Reviews?

Envie uma requisição POST para https://api.serpbase.dev/google/maps/reviews com sua chave de API no cabeçalho X-API-Key. A resposta é JSON; verifique status (0 significa sucesso).

Quais dispositivos são suportados?

Dispositivos suportados: desktop. O padrão é desktop.

A API de Google Maps Reviews já está disponível?

Sim. Qualquer chave de API ativa pode chamá-la.