Google Maps API
Search for places and get detailed business information from Google Maps.
- Uses Playwright browser automation for reliable data extraction
- Supports place search by query and detailed place information
- Multi-language support via
languageparameter
Search
GET /gmaps/places/search — 2 credits
Search Google Maps for places matching a query.
| Param | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | Yes | — | Search query (e.g. “coffee shops in Tokyo”) |
language | string | No | en | Language code (e.g. en, ja, zh-TW) |
cURL
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.
| Param | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Place name or full Google Maps URL |
language | string | No | en | Language code (e.g. en, ja, zh-TW) |
cURL
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,
"hours": "Monday 8AM-6PM ...",
"lat": 35.6595,
"lng": 139.7004,
"priceLevel": "Price: Moderate",
"url": "https://www.google.com/maps/place/Blue+Bottle+Coffee/..."
}