YepAPI

Command Palette

Search for a command to run...

POST/v1/serp/google-maps

Google Maps Places API

Google Maps Places API. Search any text query and get rich place data — ratings, reviews, hours, photos, phone, website, amenities, and AI summaries — sourced live from Google Maps.

Live Google Maps Places search powered directly by Google's Places (New) API. Send a text query (e.g. "restaurants in chicago") and get back full business profiles: ratings, review counts, hours, phone, website, photos, top reviews, AI-generated summaries, amenities, and more.

Try it live

Fill in the fields and hit Run to see a real response.

POST/v1/serp/google-maps
Response
Example response — hit "Send Request" to see a live result
{
  "ok": true,
  "data": {
    "query": "restaurants in chicago",
    "totalResults": 2,
    "nextPageToken": "AU_ZVEFqNRxa-OTq...",
    "searchUrl": "https://www.google.com/maps/search/restaurants+in+chicago",
    "results": [
      {
        "id": "ChIJs8mbNsUsDogRUnpg-b_IK5E",
        "name": "Girl & The Goat",
        "primaryType": "american_restaurant",
        "primaryTypeDisplay": "American Restaurant",
        "address": "809 W Randolph St, Chicago, IL 60607, USA",
        "shortAddress": "809 W Randolph St, Chicago",
        "addressComponents": {
          "city": "Chicago",
          "state": "Illinois",
          "country": "US",
          "postalCode": "60607",
          "neighborhood": "Fulton Market District"
        },
        "phone": "(312) 492-6262",
        "internationalPhone": "+1 312-492-6262",
        "website": "http://www.girlandthegoat.com/",
        "googleMapsUrl": "https://maps.google.com/?cid=10460675286346267218",
        "latitude": 41.8841279,
        "longitude": -87.6479354,
        "plusCode": "86HJV9M2+MR",
        "rating": 4.7,
        "userRatingCount": 7713,
        "priceLevel": "expensive",
        "priceRange": {
          "min": 50,
          "max": 100,
          "currency": "USD"
        },
        "businessStatus": "OPERATIONAL",
        "openNow": false,
        "hours": [
          "Monday: 4:30 – 10:00 PM",
          "Tuesday: 4:30 – 10:00 PM",
          "Wednesday: 4:30 – 10:00 PM",
          "Thursday: 4:30 – 10:00 PM",
          "Friday: 4:30 – 11:00 PM",
          "Saturday: 4:00 – 11:00 PM",
          "Sunday: 10:00 AM – 2:00 PM, 4:30 – 10:00 PM"
        ],
        "timezone": "America/Chicago",
        "summary": "Hot spot where Stephanie Izard serves up innovative small plates...",
        "aiSummary": "Cool eatery serving small dishes as well as familiar fare based on American recipes...",
        "reviewSummary": "People say this restaurant serves delicious goat empanadas, skirt steak, and great cocktails.",
        "iconUrl": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet.png",
        "iconBackgroundColor": "#FF9E67",
        "amenities": {
          "dineIn": true,
          "takeout": true,
          "delivery": false,
          "reservable": true,
          "servesDinner": true,
          "servesCocktails": true
        },
        "payments": {
          "acceptsCreditCards": true,
          "acceptsDebitCards": true,
          "acceptsNfc": true,
          "acceptsCashOnly": false
        },
        "parking": {
          "paidStreetParking": true,
          "valetParking": true
        },
        "accessibility": {
          "wheelchairAccessibleEntrance": true,
          "wheelchairAccessibleRestroom": true,
          "wheelchairAccessibleSeating": true
        },
        "photos": [
          {
            "reference": "places/ChIJs8.../photos/AU_ZVEFd3Y9...",
            "width": 1200,
            "height": 788,
            "attribution": "Girl & The Goat"
          }
        ],
        "topReview": {
          "rating": 5,
          "text": "Dining at Girl & the Goat was an amazing experience for my family on Christmas!...",
          "author": "Jisoo Choi",
          "publishedAt": "2026-01-15T18:12:52Z",
          "relativeTime": "3 months ago"
        },
        "directionsUrl": "https://www.google.com/maps/dir//...",
        "reviewsUrl": "https://www.google.com/maps/place//...",
        "photosUrl": "https://www.google.com/maps/place//...",
        "writeReviewUrl": "https://www.google.com/maps/place//..."
      }
    ]
  }
}

Features

Up to 20 places per call (paginate with nextPageToken)

Each POST to /v1/serp/google-maps returns up to 20 places; use the nextPageToken in the response to fetch the next page and walk through every result for a query.

Ratings, review counts, top reviews, AI review summaries

Every place returns its rating and userRatingCount plus a topReview object (text, author, date) and Google's aiSummary and reviewSummary fields — full reputation data without separate review calls.

Opening hours, current open status, timezone

Results include a full weekly hours array, a live openNow boolean, and the place's timezone, so you can show accurate open/closed status anywhere in the world.

Phone, website, photos, plus codes, coordinates

Each place returns phone and internationalPhone, website, a photos array with references and dimensions, plusCode, and latitude/longitude — everything needed to load a lead into a CRM or pin it on a map.

Amenities (dine-in, takeout, reservable, dog-friendly, ...)

The amenities object exposes flags like dineIn, takeout, delivery, reservable, and servesCocktails, alongside payments, parking, and accessibility objects for deeper filtering.

Filter by open-now, min rating, price level, place type

Use the open_now toggle and rank_by select (relevance or distance) on the request, and filter the priceLevel and primaryType fields in the response to narrow to exactly the businesses you want.

Optional location bias (lat/lng + radius)

Supply a latitude/longitude and radius to bias results toward an area, which also unlocks rank_by distance for proximity-ordered local search.

Use cases

Local Lead Discovery

Find every restaurant, salon, gym, or store in any city or neighborhood with phone, website, and ratings ready to load into your CRM.

Competitor Mapping

See exactly which businesses dominate Google Maps for any keyword — rating, review count, photos, hours, and price range in one call.

Local SEO Audits

Monitor your business and competitor visibility in Google Maps results across markets.

Travel & Directory Sites

Power city guides, restaurant directories, or travel apps with real Google Maps data — no SDK, no quota juggling.

Quick start

Copy this snippet and start making calls.

const res = await fetch('https://api.yepapi.com/v1/serp/google-maps', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "query": "restaurants in chicago",
    "limit": 10,
    "language": "en",
    "rank_by": "relevance"
  }),
});
const data = await res.json();
console.log(data);

Google Maps Places API — full business profiles from a text query

The YepAPI Google Maps Places API turns a plain text query like "restaurants in chicago" into rich, structured place data sourced live from Google Maps. One call returns business profiles with ratings, review counts, hours, phone, website, photos, top reviews, AI summaries, and amenities.

It runs on the same key as the rest of YepAPI's SERP, scraping, and AI endpoints, so local data discovery costs a flat $0.01 per call with no Google SDK, quota juggling, or per-field billing.

What is a Google Maps Places API?

A Google Maps Places API lets you programmatically search Google Maps with a text query and get structured business profiles back instead of an interactive map. For each place it returns the name, address and parsed address components, phone, website, rating and review count, opening hours with live open status, price level and range, coordinates and plus code, photos, top reviews, AI-generated summaries, and amenity, payment, parking, and accessibility flags. That means a query like "salons in austin" returns a complete, CRM-ready dataset of every matching business in one request — no Places SDK, no per-field pricing, no quota math.

Build your own local lead or directory tool

With full place profiles as JSON you can build a local lead-gen scraper, a competitor-mapping tool, or a city-guide directory. Search any "[business type] in [city]" query, paginate with nextPageToken to capture every result, and load names, phones, websites, ratings, and hours straight into your CRM or database. The amenities, price, and accessibility fields let you segment leads, and rank_by distance plus location bias powers proximity-based discovery for field-sales or delivery apps.

Google Maps Places API pricing — $0.01 per call

Every call to /v1/serp/google-maps is a flat $0.01 for up to 20 full place profiles, with all fields included — no extra charges per review, photo, or detail. Google's own Places Text Search SKU runs about $0.032 per call and meters fields separately; SerpApi charges $0.05. YepAPI bundles ratings, reviews, hours, amenities, and AI summaries into one cheap, predictable call you can pair with the rest of the platform.

Run local SEO audits and competitor mapping

Maps results decide who wins local intent. Use the endpoint to see exactly which businesses dominate Google Maps for any keyword — their rating, review count, photos, price range, and hours — then track how your own listing ranks across markets. Re-run the same query with different location bias to audit visibility city by city, and filter by min rating or price level to benchmark against direct competitors in your category.

Try the Google Maps Places API free

Start with $5 in free credit and no credit card required. That covers 500 live Maps queries — enough to pull thousands of full business profiles and test open-now, rank-by-distance, and location-bias filters against real cities.

Start making API calls in 30 seconds

$5 free credit on signup. No credit card required. Pay per call.

What developers say

Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.

Marcus T.

SEO Platform Founder

One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.

Priya S.

Full-Stack Developer

The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.

Jake R.

Indie Hacker

Frequently asked questions

Live Google Maps Places search powered directly by Google's Places (New) API. Send a text query (e.g. "restaurants in chicago") and get back full business profiles: ratings, review counts, hours, phone, website, photos, top reviews, AI-generated summaries, amenities, and more.

Each API call costs $0.01. No monthly minimums or subscriptions — you only pay for what you use.

Sign up for a free API key, then send a POST request to /v1/serp/google-maps. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.

YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.

Ready to integrate?

Get your API key and start making calls in 30 seconds. $5 free credit on signup — no credit card required.

More serp api endpoints