API para Google Maps

API para Google Maps: Avaliações

Obtenha até 100 avaliações do Google Maps de um local pelo ID do local, ordenadas como você precisar, em uma única resposta normalizada.

POST/v1/run/maps.reviews
Disponibilidade
99,47%
30d · 16.512 chamadas
Requisições
17.144
30d · semanal, últimas 12 sem.
Resposta
16,2s
mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

Provedores
Giraffe7.630 atendidas99,50% de disponibilidade32490ms p5046,5%US$ 0,117978/mil resultadosaté US$ 0,0105 / requisiçãoIbexTentado primeiro5.426 atendidas81,05% de disponibilidade12012ms p5033,0%US$ 3,50/mil req.preço fixoOctopus2.772 atendidas99,39% de disponibilidade7716ms p5016,9%US$ 0,436634/mil resultadosaté US$ 0,0441 / requisiçãoLynx593 atendidas100,00% de disponibilidade5922ms p503,6%US$ 3,50/mil req.preço fixo

Teste

Faça sua primeira requisição

requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `isLocalGuide` ou `placeId`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em uma avaliação que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "data": {
    "items": [
      {
        "author": "Alex Rivera",
        "authorUrl": "https://example.com/page",
        "avatarUrl": "https://example.com/image.jpg",
        "createdUtc": 12.5,
        "isLocalGuide": true,
        "likes": 12500,
        "origin": "example",
        "ownerResponse": "Alex Rivera",
        "ownerResponseAt": "Alex Rivera",
        "placeId": "a1b2c3d4",
        "publishedAgo": "2024-01-15T09:30:00Z",
        "rating": 4.6,
        "reviewId": "A short example description of this item.",
        "reviewerId": "A short example description of this item.",
        "reviewerReviewsCount": 12500,
        "text": "A short example description of this item.",
        "url": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface MapsReviewsResponse {
  data: {
    items: {
      author?: string;
      authorUrl?: string;
      avatarUrl?: string;
      createdUtc?: number;
      isLocalGuide?: boolean;
      likes?: number;
      origin?: string;
      ownerResponse?: string;
      ownerResponseAt?: string;
      placeId?: string;
      publishedAgo?: string;
      rating?: number;
      reviewId: string;
      reviewerId?: string;
      reviewerReviewsCount?: number;
      text?: string;
      url?: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/maps.reviews
curl -X POST https://api.getanyapi.com/v1/run/maps.reviews \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"placeId":"ChIJN1t_tDeuEmsRUsoyG83frY4"}'
CampoTipoValor de exemplo
Corpo da requisição
placeIdstring"ChIJN1t_tDeuEmsRUsoyG83frY4"O ID de local do Google Maps cujas avaliações serão buscadas (ex.: ChIJj61dQgK6j4AR4GeTYWZsKWw).
languagestringCódigo de idioma de duas letras para os detalhes das avaliações (ex.: en).
limitinteger3Número máximo de resultados a retornar (1-100, padrão 100).
postedLimitenumRetorna apenas avaliações publicadas neste intervalo: 24h (últimas 24 horas), week (últimos 7 dias), month (último mês) ou year (último ano). Omita para não filtrar por data.
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `isLocalGuide` ou `placeId`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em uma avaliação que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
reviewsFilterStringstringRetorna apenas avaliações cujo texto contenha esta palavra-chave ou frase (sem diferenciar maiúsculas de minúsculas). Omita para retornar todas as avaliações (ex.: parking).
sortenumOrdem em que as avaliações são retornadas (ex.: newest).
Resposta
dataobjectThe reviews result, or null when not found.
data.itemsobject[]Review records: reviewer, star rating, review text (empty when the reviewer left only a rating), publish date, likes, and owner response where present. Populated whenever the provider has data for the entity.
data.items[].authorstringReviewer display name. Populated whenever the provider has data for the entity.
data.items[].authorUrlstringGoogle Maps contributor page URL for the reviewer.
data.items[].avatarUrlstringReviewer profile photo URL.
data.items[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
data.items[].isLocalGuidepode ser exigidobooleanWhether the reviewer is a Google Local Guide.
data.items[].likespode ser exigidointegerNumber of likes on the review.
data.items[].originpode ser exigidostringSource of the review (e.g. Google).
data.items[].ownerResponsestringOwner's reply text; empty when there is none.
data.items[].ownerResponseAtpode ser exigidostringISO 8601 timestamp of the owner's reply; empty when there is none.
data.items[].placeIdpode ser exigidostringGoogle Maps place id the review belongs to. Echoes the requested placeId; a lane that does not repeat it per review omits it.
data.items[].publishedAgostringHuman-relative publish time (e.g. '7 hours ago').
data.items[].ratingnumberStar rating the reviewer gave (1-5).
data.items[].reviewIdstringStable Google review id. Populated whenever the provider has data for the entity.
data.items[].reviewerIdstringStable Google id of the reviewer.
data.items[].reviewerReviewsCountintegerTotal number of reviews the reviewer has written.
data.items[].textstringReview text; empty string when the reviewer left only a star rating.
data.items[].urlstringDirect URL to the review on Google Maps. Populated whenever the provider has data for the entity.
foundbooleanWhether reviews were found.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisiçãoUSDUS$ 0,0035
Preço /mil req.USDUS$ 3,50

Dúvidas frequentes

Sobre o endpoint Avaliações da API para Google Maps

O endpoint Avaliações da AnyAPI para Google Maps retorna dados de Google Maps em JSON normalizado com uma chamada POST para /v1/run/maps.reviews. Obtenha até 100 avaliações do Google Maps de um local pelo ID do local, ordenadas como você precisar, em uma única resposta normalizada. A AnyAPI distribui cada requisição entre 4 fontes, com failover automático quando uma falha. Custa a partir de US$ 3,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 99,5% das chamadas ao endpoint Avaliações da API para Google Maps feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 16,2 segundos, em 16.512 chamadas medidas.

Custa a partir de US$ 3,50 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Obtenha até 100 avaliações do Google Maps de um local pelo ID do local, ordenadas como você precisar, em uma única resposta normalizada. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 99,5% das chamadas ao endpoint Avaliações da API para Google Maps feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 16,2 segundos, em 16.512 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.
Mais para chamar

Outros endpoints de Google Maps

Contatosa partir de US$ 3,25 /mil req.Locala partir de US$ 1,75 /mil req.Buscara partir de US$ 1,75 /mil req.Buscar nas proximidadesa partir de US$ 1,30 /mil req.