Skip to Content
API ReferenceGoogle Maps

Google Maps

Search for places, get detailed business information, and read reviews from Google Maps.

  • Search: Find places by query
  • Places: Get detailed business info (hours, photos, popular times, etc.)
  • Reviews: Paginated reviews with sorting
  • Multi-language support via language parameter

GET /gmaps/places/search — 2 credits

Search Google Maps for places matching a query.

ParamTypeRequiredDefaultDescription
qstringYes—Search query (e.g. “coffee shops in Tokyo”)
languagestringNoenLanguage code (e.g. en, ja, zh-TW)
curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/gmaps/places/search?q=coffee+shops+in+Tokyo&language=en"

Response

{
  "query": "coffee shops in Tokyo",
  "resultType": "list",
  "places": [
    {
      "name": "Blue Bottle Coffee",
      "category": "Coffee shop",
      "address": "1-2-3 Shibuya, Tokyo, Japan",
      "website": "https://bluebottlecoffee.com",
      "rating": 4.5,
      "description": "Hip cafe for gourmet coffee & pastries",
      "lat": 35.6595,
      "lng": 139.7004,
      "placeId": "ChIJ...",
      "photoCount": 500
    }
  ],
  "totalResults": 20
}

Places

GET /gmaps/places — 15 credits

Get detailed information about a Google Maps place.

ParamTypeRequiredDefaultDescription
querystringYes—Place name or full Google Maps URL
languagestringNoenLanguage code (e.g. en, ja, zh-TW)
curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/gmaps/places?query=Blue+Bottle+Coffee+Tokyo&language=en"

Response

{
  "name": "Blue Bottle Coffee",
  "category": "Coffee shop",
  "address": "1-2-3 Shibuya, Tokyo, Japan",
  "website": "https://bluebottlecoffee.com",
  "phone": "+81 3-1234-5678",
  "rating": 4.5,
  "reviewCount": 1691,
  "ratingDistribution": { "1": 148, "2": 49, "3": 116, "4": 341, "5": 1037 },
  "reviewHighlights": [
    "The service was fantastic and the staff was happy to engage.",
    "Best coffee I've ever had, the matcha latte was incredible."
  ],
  "description": "Hip cafe for gourmet coffee & pastries",
  "lat": 35.6595,
  "lng": 139.7004,
  "placeId": "ChIJ...",
  "visitDuration": "People typically spend 30 min to 1 hr here",
  "photos": ["https://lh3.googleusercontent.com/..."],
  "popularTimes": {
    "Monday": { "6": 0, "7": 15, "8": 30, "9": 50, "10": 65 },
    "Tuesday": { "6": 0, "7": 20, "8": 35, "9": 55, "10": 70 }
  },
  "currentPopularity": 65,
  "additionalInfo": {
    "Service options": [{ "Takeout": true }, { "Dine-in": true }],
    "Accessibility": [{ "Wheelchair accessible entrance": true }],
    "Amenities": [{ "Wi-Fi": true }, { "Restroom": true }]
  },
  "businessStatus": "Open",
  "peopleAlsoSearch": [
    { "name": "Starbucks Reserve", "rating": 4.3, "reviewCount": 2100 }
  ]
}

Reviews

GET /gmaps/places/reviews — 5 credits

Get reviews for a Google Maps place (10 per page, paginated).

ParamTypeRequiredDefaultDescription
querystringYes—Place name or full Google Maps URL
sortstringNorelevantSort order: relevant, newest, highest, lowest
pageTokenstringNo—Pagination token from previous response
languagestringNoenLanguage code (e.g. en, ja, zh-TW)
curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/gmaps/places/reviews?query=Blue+Bottle+Coffee+Tokyo&sort=newest&language=en"

Response

{
  "reviews": [
    {
      "reviewId": "ChZDSU...",
      "author": {
        "name": "John Doe",
        "profileUrl": "https://www.google.com/maps/contrib/...",
        "id": "123456789"
      },
      "rating": 5,
      "text": "Amazing place! The view from the top is breathtaking.",
      "language": "en",
      "publishedTime": "1772886371029154",
      "images": [{ "url": "https://lh3.googleusercontent.com/..." }],
      "ownerResponse": null
    }
  ],
  "totalReviews": 10,
  "nextPageToken": "CAESY0..."
}
Last updated on
LinkedInTrustpilot