API para Google Maps: Buscar

Busque no Google Maps locais que correspondam a uma consulta e localização: até 20 registros de local normalizados por requisição, com notas, endereços e dados básicos de contato.

POST/v1/run/maps.search

Disponibilidade

99,96%

30d · 30.066 chamadas

Requisições

30.066

30d · semanal, últimas 12 sem.

Resposta

2,9s

mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

ProvedoresParcela das chamadas

LynxTentado primeiro29.601 atendidas100,00% de disponibilidade2713ms p5098,5%98,5%100,00% (29.601 chamadas)2713ms (29.601 chamadas)29.601US$ 1,75/mil req.preço fixo

Octopus408 atendidas97,84% de disponibilidade19468ms p501,4%1,4%97,84% (417 chamadas)19468ms (408 chamadas)408US$ 5,52/mil resultadosaté US$ 0,116 / requisição

Chameleon52 atendidas100,00% de disponibilidade3816ms p500,2%0,2%100,00% (52 chamadas)3816ms (52 chamadas)52US$ 3,25/mil req.preço fixo

Meerkat- atendidas- de disponibilidade- p50-----US$ 2,97/mil req.preço fixo

Teste

Faça sua primeira requisição

location*stringLocalização da busca em texto livre, de preferência cidade e país (ex.: Austin, USA).query*stringO que você digitaria na barra de busca do Google Maps (ex.: coffee shop).categoryFilterWordsarrayLista opcional de nomes de categoria de local do Google Maps a manter; os resultados ficam limitados a locais cuja categoria corresponda a um deles. Use os nomes de categoria em minúsculas, como aparecem no Google Maps (ex.: ["coffee shop", "restaurant"]). Omita para incluir todas as categorias e ficar no preço mais barato; um filtro de categoria direciona para uma fonte mais cara.languagestringCódigo de idioma de duas letras para os resultados (ex.: en).limitinteger 1-20Número máximo de resultados a retornar (1-20, padrão 20). O preço depende do provedor selecionado e pode ser fixo por requisição.placeMinimumStarsenumRetorna apenas locais com pelo menos esta nota média: two (2+), twoAndHalf (2.5+), three (3+), threeAndHalf (3.5+), four (4+) ou fourAndHalf (4.5+). Locais sem avaliações são excluídos. Omita este campo para ficar no preço mais barato; uma nota mínima direciona para uma fonte mais cara.

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 `cid` ou `street`, 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 um local 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.

websiteenumFiltra locais conforme listem ou não um site: allPlaces (padrão), withWebsite (apenas locais que têm site) ou withoutWebsite (apenas locais sem site). Omita este campo, ou envie allPlaces, para ficar no preço mais barato; withWebsite e withoutWebsite direcionam para uma fonte mais cara.

Abrir emPrompt copiado

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": [
      {
        "address": "123 Main St",
        "categories": [
          "example"
        ],
        "category": "general",
        "cid": "a1b2c3d4",
        "city": "San Francisco",
        "countryCode": "US",
        "image": "https://example.com/image.jpg",
        "latitude": 37.7749,
        "longitude": -122.4194,
        "name": "Example title",
        "permanentlyClosed": false,
        "phone": "+1 555-0142",
        "placeId": "a1b2c3d4",
        "postalCode": "94107",
        "priceLevel": "19.99",
        "rating": 4.6,
        "reviewCount": 12500,
        "state": "CA",
        "street": "123 Main St",
        "url": "https://example.com/page",
        "website": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}

Interface da resposta

interface MapsSearchResponse {
  data: {
    items: {
      address?: string;
      categories?: string[];
      category?: string;
      cid?: string;
      city?: string;
      countryCode?: string;
      image?: string;
      latitude?: number;
      longitude?: number;
      name: string;
      permanentlyClosed?: boolean;
      phone?: string;
      placeId: string;
      postalCode?: string;
      priceLevel?: string;
      rating?: number;
      reviewCount?: number;
      state?: string;
      street?: string;
      url: string;
      website?: 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.search

curl -X POST https://api.getanyapi.com/v1/run/maps.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"location":"Austin, TX","query":"coffee"}'

Campo	Tipo	Valor de exemplo
Corpo da requisição
location	string	"Austin, TX"Localização da busca em texto livre, de preferência cidade e país (ex.: Austin, USA).
query	string	"coffee"O que você digitaria na barra de busca do Google Maps (ex.: coffee shop).
categoryFilterWords	array	Lista opcional de nomes de categoria de local do Google Maps a manter; os resultados ficam limitados a locais cuja categoria corresponda a um deles. Use os nomes de categoria em minúsculas, como aparecem no Google Maps (ex.: ["coffee shop", "restaurant"]). Omita para incluir todas as categorias e ficar no preço mais barato; um filtro de categoria direciona para uma fonte mais cara.
language	string	Código de idioma de duas letras para os resultados (ex.: en).
limit	integer	3Número máximo de resultados a retornar (1-20, padrão 20). O preço depende do provedor selecionado e pode ser fixo por requisição.
placeMinimumStars	enum	Retorna apenas locais com pelo menos esta nota média: two (2+), twoAndHalf (2.5+), three (3+), threeAndHalf (3.5+), four (4+) ou fourAndHalf (4.5+). Locais sem avaliações são excluídos. Omita este campo para ficar no preço mais barato; uma nota mínima direciona para uma fonte mais cara.
requireFields	array	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 `cid` ou `street`, 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 um local 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.
website	enum	Filtra locais conforme listem ou não um site: allPlaces (padrão), withWebsite (apenas locais que têm site) ou withoutWebsite (apenas locais sem site). Omita este campo, ou envie allPlaces, para ficar no preço mais barato; withWebsite e withoutWebsite direcionam para uma fonte mais cara.
Resposta
data	object	The result wrapper, or null when nothing matched.
data.items	object[]	Matching Google Maps place records. Populated whenever the provider has data for the entity.
data.items[].address	string	Full formatted street address.
data.items[].categories	string[]	Every Google Maps category listed for the place.
data.items[].category	string	Primary place category (e.g. Coffee shop).
data.items[].cidpode ser exigido	string	Google customer/place id (cid).
data.items[].citypode ser exigido	string	City the place is in.
data.items[].countryCodepode ser exigido	string	Two-letter country code.
data.items[].image	string	Primary place photo URL.
data.items[].latitude	number	Latitude of the place in decimal degrees.
data.items[].longitude	number	Longitude of the place in decimal degrees.
data.items[].name	string	Place name. Populated whenever the provider has data for the entity.
data.items[].permanentlyClosedpode ser exigido	boolean	True when the place is marked permanently closed.
data.items[].phonepode ser exigido	string	Business phone number in E.164 format, when listed.
data.items[].placeId	string	Google Maps place id (stable identifier for the place). Populated whenever the provider has data for the entity.
data.items[].postalCodepode ser exigido	string	Postal code of the place.
data.items[].priceLevelpode ser exigido	string	Relative price level indicator (e.g. $, $10-20).
data.items[].rating	number	Average star rating out of 5.
data.items[].reviewCount	number	Total number of reviews.
data.items[].statepode ser exigido	string	State or region the place is in.
data.items[].streetpode ser exigido	string	Street line of the address.
data.items[].url	string	Canonical Google Maps URL for the place. Populated whenever the provider has data for the entity.
data.items[].website	string	The place's own website URL, when listed.
found	boolean	True when the search returned at least one matching place.
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ção	USD	US$ 0,00175
Preço /mil req.	USD	US$ 1,75

Dúvidas frequentes

Sobre o endpoint Buscar da API para Google Maps

O endpoint Buscar da AnyAPI para Google Maps retorna dados de Google Maps em JSON normalizado com uma chamada POST para /v1/run/maps.search. Busque no Google Maps locais que correspondam a uma consulta e localização: até 20 registros de local normalizados por requisição, com notas, endereços e dados básicos de contato. A AnyAPI distribui cada requisição entre 4 fontes, com failover automático quando uma falha. Custa a partir de US$ 1,75 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para Google Maps feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,9 segundos, em 30.066 chamadas medidas.

Custa a partir de US$ 1,75 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.

Busque no Google Maps locais que correspondam a uma consulta e localização: até 20 registros de local normalizados por requisição, com notas, endereços e dados básicos de contato. 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, 100,0% das chamadas ao endpoint Buscar da API para Google Maps feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 2,9 segundos, em 30.066 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.Avaliaçõesa partir de US$ 3,50 /mil req.Buscar nas proximidadesa partir de US$ 1,30 /mil req.

Uma chave, uma carteira e
sua primeira chamada de Google Maps.

Ganhe ~150 requisições grátis

API para Google Maps: Buscar

Provedores ordenados por tráfego

Faça sua primeira requisição

Requisição, resposta e preço

Sobre o endpoint Buscar da API para Google Maps

Quanto custa o endpoint Buscar da API para Google Maps?

O que o endpoint Buscar da API para Google Maps retorna?

Quão confiável é o endpoint Buscar da API para Google Maps?

Outros endpoints de Google Maps

Uma chave, uma carteira esua primeira chamada de Google Maps.

Uma chave, uma carteira e
sua primeira chamada de Google Maps.