Google API: Get place
Looks up a public Google Maps place by name and location and returns its profile: address, rating, hours, phone, website and photos.
Unofficial. Not affiliated with or endorsed by Google.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Location, required
location City, area, or address, such as Greenwich Village, New York.
Seattle, Washington
- Place Name, required
place_name Business or place name, such as Joe's Pizza.
Space Needle
Input as JSON
{ "location": "Seattle, Washington", "place_name": "Space Needle"}Output
{ "name": "Space Needle", "address": "400 Broad St, Seattle, WA 98109", "website": "https://www.spaceneedle.com/" , "category": "Observation deck", "latitude": 47.620506299999995, "open_now": "No", "longitude": -122.34927739999999, "plus_code": "JMC2+67 Seattle, Washington", "description": "Iconic, 605-ft-tall spire at the Seattle Center, with an observation deck & a rotating restaurant.", "photo_links": [ "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmyNGjXVaNO1wFdbnLTCMEENxuZz8P1xBHu8p5sBhammJXbwfalKs8GuoPCklHHW-79tcLjP0PU3HmmyMilpTQe2zFjhiKdcuEh1VIyRfil97ou-igWbOuFANlzMTcFWMEJg-RA=w86-h114-k-no" ], "price_level": null, "star_rating": 4.6, "phone_number": "(206) 905-2100", "review_count": null, "opening_hours": { "Friday": null, "Monday": "10:30 AM–8 PM", "Sunday": null, "Tuesday": null, "Saturday": null, "Thursday": null, "Wednesday": null }, "google_place_id": "ChIJ-bfVTh8VkFQRDZLQnmioK9s", "service_options": [], "google_maps_link": "https://www.google.com/maps/place/Space+Needle,+400+Broad+St,+Seattle,+WA+98109/@47.6205063,-122.3492774,2689a,13.1y/data=!4m2!3m1!1s0x5490151f4ed5b7f9:0xdb2ba8689ed0920d" }Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"google.com/get_place","input":{"location":"Seattle, Washington","place_name":"Space Needle"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "google.com/get_place" , "input": { "location": "Seattle, Washington", "place_name": "Space Needle" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "google.com/get_place" , "input": { "location": "Seattle, Washington", "place_name": "Space Needle" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run google.com/get_place# with {"location":"Seattle, Washington","place_name":"Space Needle"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "place_name", "location" ], "properties": { "location": { "type": "string", "description": "City, area, or address, such as Greenwich Village, New York." }, "place_name": { "type": "string", "description": "Business or place name, such as Joe's Pizza." } }, "additionalProperties": false}Output schema
{ "type": "object", "required": [ "name", "category", "star_rating", "review_count", "price_level", "address", "phone_number", "website", "open_now", "description", "google_maps_link", "google_place_id", "latitude", "longitude", "plus_code", "opening_hours", "service_options", "photo_links" ], "properties": { "name": { "type": "string", "description": "Place name." }, "address": { "type": [ "string", "null" ], "description": "Full street address." }, "website": { "type": [ "string", "null" ], "description": "Public website link." }, "category": { "type": [ "string", "null" ], "description": "Primary category." }, "latitude": { "type": [ "number", "null" ], "description": "Latitude." }, "open_now": { "type": [ "string", "null" ], "description": "Yes or No based on the current hours status." }, "longitude": { "type": [ "number", "null" ], "description": "Longitude." }, "plus_code": { "type": [ "string", "null" ], "description": "Plus code." }, "description": { "type": [ "string", "null" ], "description": "Short description, when shown." }, "photo_links": { "type": "array", "items": { "type": "string" }, "description": "Up to five public place photo links." }, "price_level": { "type": [ "string", "null" ], "description": "Price level as shown on Google Maps." }, "star_rating": { "type": [ "number", "null" ], "description": "Average star rating." }, "phone_number": { "type": [ "string", "null" ], "description": "Public phone number." }, "review_count": { "type": [ "integer", "null" ], "description": "Number of reviews." }, "opening_hours": { "type": "object", "required": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday" ], "properties": { "Friday": { "type": [ "string", "null" ], "description": "Friday hours as text." }, "Monday": { "type": [ "string", "null" ], "description": "Monday hours as text." }, "Sunday": { "type": [ "string", "null" ], "description": "Sunday hours as text." }, "Tuesday": { "type": [ "string", "null" ], "description": "Tuesday hours as text." }, "Saturday": { "type": [ "string", "null" ], "description": "Saturday hours as text." }, "Thursday": { "type": [ "string", "null" ], "description": "Thursday hours as text." }, "Wednesday": { "type": [ "string", "null" ], "description": "Wednesday hours as text." } }, "description": "Weekly opening hours as displayed.", "additionalProperties": false }, "google_place_id": { "type": [ "string", "null" ], "description": "Google place ID." }, "service_options": { "type": "array", "items": { "type": "string" }, "description": "Available service options." }, "google_maps_link": { "type": "string", "description": "Google Maps page link." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
google.com/get_place- Returns
- name, category, rating, review count, address, phone, website, hours, coordinates, photos
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method google.com/get_place with the inputs above.
Ask your agent
- What are the opening hours and phone number for Tartine Bakery in the Mission District, San Francisco?
- Pull up the Google Maps listing for Franklin Barbecue in Austin, TX — I need the rating, number of reviews, and address.
- Find the website and exact coordinates for the Powell's City of Books store in downtown Portland, Oregon.
- Is Dishoom in Covent Garden, London well rated? Show me its rating, hours, and a few photos from Google.
- Get me the address, category, and contact details for Blue Bottle Coffee near Shibuya, Tokyo.
See more
All Google methodsFinds businesses and places near a location on Google Maps, in Google Maps order, with rating, hours, contact details and links when shown.
google.com/search_placesFinds a place on Google Maps by name and location and returns its public reviews in the chosen order.
google.com/get_place_reviewsFinds a hotel on Google Hotels by name and city and returns its guest reviews in the chosen order, its Google rating and review count, and topic ratings averaged from the returned reviews that rate each topic.
google.com/get_hotel_reviewsGets up to three Google Maps routes between two places, with distances, travel times and step-by-step directions.
google.com/get_directionsGets a public Google Play app listing by app name or Play Store link, with developer, rating, downloads, price, what's new, descriptions and data safety highlights.
play.google.com/get_appFinds places to stay in a city or area for given dates on Google Hotels, with nightly and total prices, hotel class, guest ratings, amenities, address and cheapest booking site. Optional filters for price, stars and rating; vacation rentals are left out. Prices and availability can change.
google.com/search_hotelsGets public user reviews for an Android app on Google Play. The app can be given by name, Play Store link, or app ID.
play.google.com/get_app_reviewsLooks up a Google Books book by title or ISBN. Returns its details, reader ratings and the Google Play ebook offer in a chosen country.
books.google.com/get_book