Google Maps Places by Category

Find every place of a given category around a location — cafes, restaurants, hotels, gyms, salons, gas stations, parks, you name it. When category is hotel, automatically enriches with booking prices per platform.

What you get

A list of places matching {category} near {location}. Each item has name, full address, coordinates, average rating, review count, and the Google Maps category. For hotels, an extra prices[] array lists every booking partner (booking.com, agoda, traveloka, expedia, etc.) with start/end price and room options.

Use cases

• Lead lists for B2B sales — pull every "dentist near Manhattan" or "gym in London" into a CRM.
• Hotel intelligence — see real-time pricing for every 3–5 star hotel in a city across booking platforms.
• Local SEO discovery — list every business in a category to find unclaimed Google Business Profiles.
• Competition mapping — count cafes within 1 km of your planned new shop, compare ratings.
• Travel apps — power "Restaurants near me" or "Best gyms in town" features.

Why this actor

• Generic: one actor for hotels, cafes, restaurants, gyms, anything searchable on Google Maps.
• Hotel-aware: automatically pulls booking-partner pricing when category is hotel — replaces 5+ separate price-comparison API calls.
• Country & language aware: works for any region, returns localized data.
• Star-range filter for hotels: pass hotel_star_min / hotel_star_max to narrow to your tier.
• Parallel enrichment: hotel pricing for 20 places fetched concurrently for fast results.

Sample input — cafes in New York

{
    "location": "New York",
    "category": "cafe",
    "max_items": 5,
    "language": "en",
    "country": "us"
}

Sample output — cafes

[
    {
        "item_id": "0x89c2590014a48ff9:0x34466e9af9759422",
        "name": "Le Cafe Coffee",
        "coordinate": [40.765291, -73.9767121],
        "address": "1427 6th Ave, New York, NY 10019",
        "rating_star": 4.6,
        "review_count": null,
        "category": "Coffee shop"
    },
    {
        "item_id": "0x89c2591b920da2bf:0x974c3ae78a7be9e4",
        "name": "Urban Backyard",
        "coordinate": [40.7208064, -73.9966015],
        "address": "180 Mulberry St, New York, NY 10012",
        "rating_star": 4.7,
        "review_count": null,
        "category": "Coffee shop"
    },
    {
        "item_id": "0x89c259b52862a671:0xd50cb6d3dbcffc98",
        "name": "In Common NYC - A Breakfast & Brunch Restaurant",
        "coordinate": [40.753834999999995, -73.99624299999999],
        "address": "441 9th Ave Ste 101, New York, NY 10001",
        "rating_star": 4.5,
        "review_count": null,
        "category": "Cafe"
    }
]

Sample input — 4–5 star hotels in New York

{
    "location": "New York",
    "category": "hotel",
    "hotel_star_min": 4,
    "hotel_star_max": 5,
    "with_pricing": true,
    "max_items": 10,
    "language": "en",
    "country": "us"
}

When category=hotel, each item additionally has:

{
    "item_id": "0x89c259490f5bc24b:0x3368727b11e06bfc",
    "name": "The Flat NYC - Hotel & Event Space New York",
    "address": "25 W 24th St, New York, NY 10010",
    "rating_star": 4.1,
    "hotel_star": "3",
    "categories": ["Hotel", "Event management company", "Live music venue", "... 2 more"],
    "checkin_out_date": "2026-08-03:2026-08-04",
    "prices": [
        {
            "site_name": "The Flat Hotel NYC",
            "start_price": "IDR 686,711",
            "end_price": "IDR 4,915,395",
            "rooms": [
                {"beds_available": "1 king bed", "room_price": "IDR 5,328,367"},
                {"beds_available": "1 queen bed", "room_price": "IDR 4,915,395"},
                "... 1 more"
            ]
        },
        {"site_name": "klook", "start_price": "IDR 555,847", "end_price": "IDR 3,870,416", "rooms": []},
        {"site_name": "Vio.com", "start_price": "IDR 552,968", "end_price": "IDR 3,990,798", "rooms": []}
    ],
    "desc": "..."
}

Prices come back in whatever currency Google shows for your run's location — not necessarily the country you set. If you need a fixed currency, convert after the run.

How to get the inputs

• location — any city, neighborhood, or area name a user would type into Google Maps ("New York", "Manhattan SoHo", "Bali Ubud", "Tokyo Shibuya"). No URL or item_id needed.
• category — any business category Google Maps recognizes ("cafe", "restaurant", "hotel", "gym", "pharmacy", "bar", "park", ...).

Tips

• For non-hotel categories, set with_pricing: false to skip the enrichment step (faster).
• Use specific neighborhoods for tighter result clusters.
• For hotels, restrict to your star tier with hotel_star_min/hotel_star_max (0 to 5).

Pair with other actors

• Chain each result's item_id into Google Maps Reviews to pull every review per place — perfect for "all reviews of every cafe in Soho".
• Chain item_id into Google Maps Place Detail for full enrichment (popular times, contact info).
• Chain item_id into Google Maps Photos & Videos to assemble galleries of every place in the list.
• For free-text search instead of category-near-location, use Google Maps Search Places.