The Google Maps places your agent needs.
Google Maps Search returns places for a query, each with address, rating, phone, website and hours. Control it by minimum rating and open now.
terminal
Google Maps Search APIfor AI agents
One API call to search Google Maps. Get places with ratings and contact details as JSON.
What people use it for.
Build a lead list
Search a business type in a city. Save name, phone, website and address of each place as a lead.
Recommend a place that is open
Set minRating to 4.5 and openNow to true. An agent can then suggest a good place that is open.
Check a local ranking
Search your category in your city and find your business in the results. Its place in the list is your local rank.
More Google endpoints.
- SearchSearch Google and get results, the AI Overview, the knowledge panel and related questions
- NewsSearch Google News by keyword, date, site and country, or read headlines by topic
- ImagesSearch Google Images and get each full-size image with the page it comes from
- AI ModeAsk Google AI Mode a question and get its answer with the sources it cites
- ShoppingCompare product prices and sellers on Google Shopping by country
- SuggestionsGet Google search suggestions for a keyword
- Search adsSearch ads in the Google ads library
- AdGet a Google ad's details
- AdvertisersFind advertisers in the Google ads library
- ScholarSearch Google Scholar for papers, books and case law, with citations
- VideosSearch Google's Videos tab for videos from every site, with duration and channel
- JobsSearch Google Jobs: openings from many job sites, with apply links and highlights
- PatentsSearch Google Patents by words, inventor, assignee, office, dates and status
- Maps placeGet a place's address, hours, rating and contact details
- Maps reviewsGet a place's reviews
- Related searchesGet related searches for a keyword
- Trending nowGet what is trending on Google now
- FlightsSearch flights with prices and times
- HotelsSearch Google Hotels with prices, ratings and Google's own filters
- Play appGet an app's details from Google Play
- Play searchSearch Google Play apps
- Play reviewsGet an app's Google Play reviews
- Trends interest over timeGet Google Trends search interest over time, newest first, with one value per query
- Trends by regionGet Google Trends search interest by region
- All Google endpointsOne API for Google data. Get search results, Maps places, Trends, flights, Play apps and ads as JSON.
Ways to call it.
- Use the APISend a POST request with a Bearer key. Every endpoint returns success, data, creditsUsed and requestId.
- Use MCPAdd https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent finds an endpoint and calls it.
- Use the SDKInstall the TypeScript or Python client. Call an endpoint by its id, such as youtube.transcript.
- Use the CLICall an endpoint from the terminal. The CLI prints JSON, so you can pipe the result into a script.
Start free. Pay per call after.
No plans and no monthly fee. 1,000 free credits to start, then $1.50 per 1,000 credits, $1.20 from $100 and $0.80 from $500. Credits never expire.
Free
Every account starts with free credits. No card needed.
1,000 free credits
$0
- ✓Every source
Pay as you go
Add credits to your balance and spend them one call at a time.
$1.50 per 1,000 credits, $1.20 from $100 and $0.80 from $500
$0.0015/ credit
10,000 credits≈ $13.50
Most calls cost 1 credit.
- ✓Never expires
Custom
For teams that need higher rate limits or a source we do not cover yet.
Volume pricing
Custom
- ✓Custom rate limits
- ✓New sources on request
- ✓Direct support
Questions and answers.
No. You call Stophy, so you need no Google Cloud project and no Places API key. The first page of a search needs no key at all, and a free daily limit applies. To get later pages, send a Stophy API key.
A results list and the page number. Each place has placeId, googlePlaceId, placeUrl, name, categories, address, latitude, longitude, rating, reviews, phone, website, hours, hoursToday and openStatus.
query is what you look for, such as coffee. location is where, such as Austin, TX. Both are required.
minRating takes 2, 2.5, 3, 3.5, 4 or 4.5. openNow keeps the places that are open at the moment of the search. country and language set the region and the language of the results.
Set page to 2, 3 and so on, up to 10. A request for a page after the first needs an API key.
1 credit for each call that returns data. A call that returns an error or an empty list uses 0 credits.
Yes. Add the MCP server at https://api.stophy.dev/mcp to Claude, Cursor or Codex. The agent calls the endpoint by the id googleMapsSearch. The agent can pass a placeId to googleMapsReviews to read what customers wrote.
Get started
Give your agent the web today.
Sign up for 1,000 free credits. No card needed.