Search APIs
Loading…
← API Store
Search & SEO

Google Maps

Google Maps

One Google Maps place

GET /google-maps/v1/place
Test this endpoint

Pass q or a Google Maps place URL. place_id selects a match inside that search.

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
qstring Example: Times Square Cafe
urlstringA Google Maps place URL (instead of q).
place_idstringGoogle place id to pick among the matches.

Every endpoint also takes: raw、fields、fresh、output、records

{
  "cached": false,
  "credits_used": 1,
  "place": {
    "address": "Times Square Cafe, 1657 Broadway, New York, NY 10019",
    "address_detail": [
      [
        [
          7,
          [
            [
              "Times Square Cafe"
            ],
            [
              "1657 Broadway"
            ],
            "… 1 more"
          ]
        ],
        [
          2,
          [
            [
              "Times Square Cafe, 1657 Broadway, New York, NY 10019"
            ]
          ]
        ],
        "… 2 more"
      ],
      [
        "Manhattan",
        "1657 Broadway",
        "… 5 more"
      ]
    ],
    "address_parts": [
      "1657 Broadway",
      "New York, NY 10019"
    ],
    "categories": [
      "Coffee shop"
    ],
    "category": "Coffee shop",
    "cid": "16166289381583153704",
    "city": "New York",
    "country_code": "US",
    "description": null,
    "feature_id": "0x89c25978f9c7111f:0xe05a328a356eea28",
    "full_address": "1657 Broadway, New York, NY 10019",
    "hours": {
      "Friday": [
        "Open 24 hours"
      ],
      "Monday": [
        "Open 24 hours"
      ],
      "Saturday": [
        "Open 24 hours"
      ],
      "Sunday": [
        "Open 24 hours"
      ],
      "Thursday": [
        "Open 24 hours"
      ],
      "Tuesday": [
        "Open 24 hours"
      ],
      "Wednesday": [
        "Open 24 hours"
      ]
    },
    "kgmid": "/g/11v68mmqzf",
    "latitude": 40.762524899999995,
    "longitude": -73.98361469999999,
    "name": "Times Square Cafe",
    "neighborhood": "Manhattan",
    "open_status": "Open 24 hours",
    "permanently_closed": null,
    "phone": "+1 555 010 0000",
    "phone_international": "+1 555 010 0000",
    "phones": [
      "+1 555 010 0000"
    ],
    "photos_count": 324,
    "place_id": "ChIJHxHH-XhZwokRKOpuNYoyWuA",
    "postal_code": "10019",
    "price_level": null,
    "review_count": 329,
    "service_options": {
      "Accessibility": [
        "Wheelchair accessible entrance",
        "Wheelchair accessible seating",
        "… 1 more"
      ]
    },
    "stars": 4.4,
    "state": "New York",
    "street": "1657 Broadway",
    "thumbnail": "https://lh5.googleusercontent.com/-XIHkSualLQo/AAAAAAAAAAI/AAAAAAAAAAA/pRqlMa0yV_0/s44-p-k-no-ns-nd/photo.jpg",
    "timezone": "America/New_York",
    "url": "https://www.google.com/maps/place/?q=place_id:ChIJHxHH-XhZwokRKOpuNYoyWuA",
    "website": "https://www.timessquarenyc.org/food-beverage/times-square-cafe",
    "website_domain": "timessquarenyc.org"
  },
  "query": "Times Square Cafe"
}
Response fields (65)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.credits_usedinteger
$.placeobject
$.place.addressstring
$.place.address_detailarray
$.place.address_detail[]array
$.place.address_detail[][]array | string
$.place.address_detail[][][]array | integer
$.place.address_detail[][][][]array | string
$.place.address_detail[][][][][]string
$.place.address_partsarray
$.place.address_parts[]string
$.place.categoriesarray
$.place.categories[]string
$.place.categorystring
$.place.cidstring
$.place.citystring
$.place.country_codestring
$.place.descriptionnull
$.place.feature_idstring
$.place.full_addressstring
$.place.hoursobject
$.place.hours.Fridayarray
$.place.hours.Friday[]string
$.place.hours.Mondayarray
$.place.hours.Monday[]string
$.place.hours.Saturdayarray
$.place.hours.Saturday[]string
$.place.hours.Sundayarray
$.place.hours.Sunday[]string
$.place.hours.Thursdayarray
$.place.hours.Thursday[]string
$.place.hours.Tuesdayarray
$.place.hours.Tuesday[]string
$.place.hours.Wednesdayarray
$.place.hours.Wednesday[]string
$.place.kgmidstring
$.place.latitudenumber
$.place.longitudenumber
$.place.namestring
$.place.neighborhoodstring
$.place.open_statusstring
$.place.permanently_closednull
$.place.phonestring
$.place.phone_internationalstring
$.place.phonesarray
$.place.phones[]string
$.place.photos_countinteger
$.place.place_idstring
$.place.postal_codestring
$.place.price_levelnull
$.place.review_countinteger
$.place.service_optionsobject
$.place.service_options.Accessibilityarray
$.place.service_options.Accessibility[]string
$.place.starsnumber
$.place.statestring
$.place.streetstring
$.place.thumbnailstring
$.place.timezonestring
$.place.urlstring
$.place.websitestring
$.place.website_domainstring
$.querystring