POST/v1/data/google/maps

Google Maps

Search Google Maps for places, businesses, and points of interest. Supports search queries, coordinate-based nearby search, and single place detail lookups via place_id or CID. Returns full business data including reviews.

Target Latency

1.2s - 4.5s

Credits

1 cr/req

Parameters

Name	Type	Requirement	Description
query	string	optional	Search query (e.g. 'restaurants near Times Square'). Max 2048 characters.
coordinates	string	optional	GPS coordinates as 'lat,lng' (e.g. '40.7580,-73.9855').
radius	number	optional	Search radius in meters (100-50000). Default 5000.
zoom	number	optional	Map zoom level (1-21). Auto-calculated from radius if not set.
type	string	optional	Place type filter: restaurant, hotel, gas_station, hospital, cafe, bar, gym, pharmacy, bank, supermarket, park, museum, airport.
keyword	string	optional	Additional keyword filter (max 500 chars). E.g. 'vegetarian', 'rooftop'.
min_rating	number	optional	Minimum star rating filter (1.0-5.0).
open_now	boolean	optional	Only show places that are currently open.
price_level	number	optional	Price range filter: 1=$, 2=$$, 3=$$$, 4=$$$$.
sort_by	string	optional	Sort order: "relevance", "distance", "rating", "reviews".
num_results	number	optional	Number of places to return (1-200).
place_id	string	optional	Google Place ID for detailed single place lookup (e.g. 'ChIJN1t_tDeuEmsRUsoyG').
cid	string	optional	CID / Ludocid permanent business identifier.
data	string	optional	Google Maps data parameter (encoded place reference).
language	string	optional	Language code (hl parameter).
country	string	optional	Country code for geo-targeting (gl parameter).
include_reviews	boolean	optional	Include user reviews for each place.
reviews_limit	number	optional	Maximum reviews per place (1-20). Requires include_reviews=true.
reviews_sort	string	optional	Review sort: "most_relevant", "newest", "highest", "lowest".

cURL Example

curl -X POST "https://api.datablue.dev/v1/data/google/maps" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "best ramen restaurants",
  "coordinates": "40.7580,-73.9855",
  "radius": 3000,
  "num_results": 5,
  "min_rating": 4,
  "include_reviews": true,
  "reviews_limit": 3
}'

System Responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

EXAMPLE RESPONSE

{
  "success": true,
  "query": "best ramen restaurants",
  "coordinates_used": "40.7580,-73.9855",
  "search_type": "search",
  "total_results": "5",
  "time_taken": 3.42,
  "filters_applied": {
    "min_rating": 4,
    "radius": 3000
  },
  "places": [
    {
      "position": 1,
      "title": "Ichiran Ramen",
      "place_id": "ChIJ4Y8RmkRYwokR5ntGn3BDXY8",
      "address": "132 W 31st St, New York, NY 10001",
      "gps_coordinates": {
        "latitude": 40.7487,
        "longitude": -73.9903
      },
      "url": "https://maps.google.com/?cid=10325091291252938854",
      "website": "https://www.ichiranusa.com",
      "phone": "+1 212-465-0701",
      "rating": 4.5,
      "reviews": 3847,
      "price": "$$",
      "price_level": 2,
      "type": "Ramen restaurant",
      "subtypes": [
        "Ramen restaurant",
        "Japanese restaurant",
        "Noodle shop"
      ],
      "open_state": "Open - Closes 2 AM",
      "open_now": true,
      "thumbnail": "https://lh5.googleusercontent.com/p/AF1QipN...",
      "user_reviews": [
        {
          "author_name": "Sarah Chen",
          "rating": 5,
          "text": "Best ramen in NYC. The solo booth concept is genius. Rich tonkotsu broth...",
          "relative_time": "2 weeks ago"
        },
        {
          "author_name": "Mike Johnson",
          "rating": 4,
          "text": "Great flavors, a bit pricey for what you get but the experience is unique.",
          "relative_time": "1 month ago"
        }
      ]
    }
  ],
  "related_searches": [
    {
      "query": "ramen near me"
    },
    {
      "query": "japanese restaurants midtown"
    }
  ]
}