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.

Execution Model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit Weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

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"
    }
  ]
}