API Direct

Places Search

GET /v1/places/search

Search Google Maps places — local businesses, restaurants, hotels, shops and points of interest — by free-text query. Returns name, address, phone, website, rating, review count, opening hours, and coordinates. Each page returns up to 10 results. Optionally bias results by geographic center.

Cost

$0.01 per page

Free tier

20 requests/month

Parameters

query *

Search keyword, e.g. "coffee shops brooklyn" (max 500 characters)

pages

Number of pages to fetch, 1-20 (default: 1). Each page returns up to 10 results and is billed as one request

lat

Center latitude for geographic bias (use with lng)

lng

Center longitude for geographic bias (use with lat)

zoom

Map zoom level 1-20 (default: 13). Smaller widens radius

country

2-letter ISO 3166-1 alpha-2 region code (default: us)

language

2-letter ISO 639-1 language code (default: en)

Example Request

curl "https://apidirect.io/v1/places/search?query=pizza%20new%20york&pages=2" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/places/search",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "pizza new york",
        "pages": 2,
        "lat": 40.7549,
        "lng": -73.9870,
        "zoom": 14
    }
)
print(response.json())

Example Response

{
  "places": [
    {
      "place_id": "ChIJifIePKtZwokRVZ-UdRGkZzs",
      "name": "Joe's Pizza Broadway",
      "type": "Pizza restaurant",
      "subtypes": ["Pizza restaurant", "Pizza delivery", "Restaurant"],
      "phone_number": "+16465594878",
      "website": "https://www.joespizzanyc.com",
      "domain": "joespizzanyc.com",
      "rating": 4.5,
      "review_count": 25433,
      "reviews_per_rating": {"1": 753, "2": 604, "3": 2107, "4": 4946, "5": 17023},
      "price_level": "$10–20",
      "verified": true,
      "business_status": "OPEN",
      "opening_status": "Open · Closes 3 AM",
      "working_hours": {"Monday": ["10 AM–3 AM"]},
      "opening_date": null,
      "address": "1435 Broadway, New York, NY 10018",
      "street_address": "1435 Broadway",
      "district": "Manhattan",
      "city": "New York",
      "state": "New York",
      "zipcode": "10018",
      "country": "US",
      "latitude": 40.75468,
      "longitude": -73.98703,
      "timezone": "America/New_York",
      "summary": "Modern outpost of a longtime counter-serve pizza joint prepping New York-style slices and pies.",
      "about": {
        "summary": "Modern outpost of a longtime counter-serve pizza joint prepping New York-style slices and pies.",
        "details": {
          "Accessibility": {"Wheelchair accessible entrance": true}
        }
      },
      "photo_count": 22117,
      "photos_sample": [
        {
          "photo_id": "CIABIhBpKlqRIOpwhdI384bUAF4L",
          "type": "photo",
          "photo_url": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAH...",
          "photo_url_large": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAH...=w3000-h4000-k-no",
          "video_thumbnail_url": null,
          "latitude": 40.7546469,
          "longitude": -73.9868158,
          "photo_datetime_utc": "2026-06-16T00:00:00.000Z",
          "photo_timestamp": 1781568000
        }
      ],
      "place_link": "https://www.google.com/maps/place/...",
      "reviews_link": "https://search.google.com/local/reviews?placeid=ChIJifIePKtZwokRVZ-UdRGkZzs",
      "booking_link": "https://www.google.com/searchviewer/42?...",
      "reservations_link": "https://www.fooddiscoveryapp.com/new-york-city/joes-pizza",
      "order_link": "https://www.google.com/searchviewer/42?...",
      "owner_name": "Joe's Pizza Broadway",
      "owner_link": "https://maps.google.com/maps/contrib/103877821925204408966",
      "cid": "4280570365733019477",
      "google_mid": "/g/11bw4ws2mt"
    }
  ],
  "count": 1,
  "query": "pizza new york",
  "pages": 2
}

Your Usage

Free tier this month

Recent Activity