Docs / API reference

POST/v1/data/google/maps/place

Google Maps Place

Return one Google Maps place with contact details, rating breakdown, hours and categories.

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.

Google Maps Place Endpoint

Return one Google Maps place with contact details, rating breakdown, hours and categories.

Getting Started

Send your API key as a bearer token. Start with the smallest request below.

Run Google Maps Place

Send the smallest useful request and read the structured response.

curl -X POST "https://api.datablue.dev/v1/data/google/maps/place" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc"
}'
Example response
{
  "success": true,
  "time_taken": 1.414,
  "place": {
    "title": "Third Wave Coffee - Koramangala",
    "place_id": "ChIJ9fZczEkVrjsR_E8O1PogkTs",
    "data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
    "data_cid": "4292248181532413948",
    "address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034",
    "latitude": 12.934721699999999,
    "longitude": 77.6295729,
    "google_maps_url": "https://www.google.com/maps?cid=4292248181532413948",
    "website": "https://stores.thirdwavecoffeeroasters.com/store-pages/third-wave-coffee-koramangala-bengaluru/",
    "phone": "073376 84222",
    "international_phone": "+91 73376 84222",
    "rating": 4.4,
    "review_count": 5024,
    "rating_summary": [
      {
        "stars": 1,
        "amount": 138
      },
      {
        "stars": 2,
        "amount": 98
      }
    ],
    "open_now": true,
    "type": "Cafe",
    "subtypes": [
      "Cafe",
      "Coffee roastery"
    ],
    "photo_count": 3122,
    "working_hours": [
      {
        "day": "Sunday",
        "hours": "8 am–1 am"
      },
      {
        "day": "Monday",
        "hours": "8 am–1 am"
      }
    ]
  }
}

Options

Query and Target

Set the search term, identifier, or source URL that defines the request.

curl -X POST "https://api.datablue.dev/v1/data/google/maps/place" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
  "place_id": "ChIJEXAMPLE",
  "cid": "1234567890123456789"
}'
Example response
{
  "success": true,
  "time_taken": 1.414,
  "place": {
    "title": "Third Wave Coffee - Koramangala",
    "place_id": "ChIJ9fZczEkVrjsR_E8O1PogkTs",
    "data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
    "data_cid": "4292248181532413948",
    "address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034",
    "latitude": 12.934721699999999,
    "longitude": 77.6295729,
    "google_maps_url": "https://www.google.com/maps?cid=4292248181532413948",
    "website": "https://stores.thirdwavecoffeeroasters.com/store-pages/third-wave-coffee-koramangala-bengaluru/",
    "phone": "073376 84222"
  }
}

Location and Language

Localize results with country, language, coordinates, or delivery-location fields.

curl -X POST "https://api.datablue.dev/v1/data/google/maps/place" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
  "language": "en",
  "country": "us"
}'
Example response
{
  "success": true,
  "time_taken": 1.414,
  "place": {
    "title": "Third Wave Coffee - Koramangala",
    "place_id": "ChIJ9fZczEkVrjsR_E8O1PogkTs",
    "data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
    "data_cid": "4292248181532413948",
    "address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034",
    "latitude": 12.934721699999999,
    "longitude": 77.6295729,
    "google_maps_url": "https://www.google.com/maps?cid=4292248181532413948",
    "website": "https://stores.thirdwavecoffeeroasters.com/store-pages/third-wave-coffee-koramangala-bengaluru/",
    "phone": "073376 84222"
  }
}

Additional Options

Set endpoint-specific options for this request.

curl -X POST "https://api.datablue.dev/v1/data/google/maps/place" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "data_id": "example"
}'
Example response
{
  "success": true,
  "time_taken": 1.414,
  "place": {
    "title": "Third Wave Coffee - Koramangala",
    "place_id": "ChIJ9fZczEkVrjsR_E8O1PogkTs",
    "data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
    "data_cid": "4292248181532413948",
    "address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034",
    "latitude": 12.934721699999999,
    "longitude": 77.6295729,
    "google_maps_url": "https://www.google.com/maps?cid=4292248181532413948",
    "website": "https://stores.thirdwavecoffeeroasters.com/store-pages/third-wave-coffee-koramangala-bengaluru/",
    "phone": "073376 84222"
  }
}

Response

Read success first, then consume the endpoint-specific records and pagination fields shown below.

Error Handling

Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.

Parameters

NameTypeRequirementDescription
data_idstringOptionalGoogle Maps data ID from Google Maps results, e.g. 0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc. Send one of data_id, place_id, or cid.
place_idstringOptionalGoogle Place ID, e.g. ChIJ9fZczEkVrjsR_E8O1PogkTs.
cid / ludocidstringOptionalGoogle Maps CID (decimal business ID).
languagestringOptionalResult language.
countrystringOptionalTwo-letter country code for the Google market.

Response fields

FieldTypeDescription
successbooleanFalse when the place could not be found.
placeobjecttitle, place_id, data_id, cid, address, latitude, longitude, google_maps_url, website, phone, rating, review_count, rating_summary, open_now, type, subtypes, photos, photo_count, working_hours, and description when Google shows them.
time_takennumberAPI response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/google/maps/place" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc"
}'
Example response
{
  "success": true,
  "time_taken": 1.414,
  "place": {
    "title": "Third Wave Coffee - Koramangala",
    "place_id": "ChIJ9fZczEkVrjsR_E8O1PogkTs",
    "data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
    "data_cid": "4292248181532413948",
    "address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034",
    "latitude": 12.934721699999999,
    "longitude": 77.6295729,
    "google_maps_url": "https://www.google.com/maps?cid=4292248181532413948",
    "website": "https://stores.thirdwavecoffeeroasters.com/store-pages/third-wave-coffee-koramangala-bengaluru/",
    "phone": "073376 84222",
    "international_phone": "+91 73376 84222",
    "rating": 4.4,
    "review_count": 5024,
    "rating_summary": [
      {
        "stars": 1,
        "amount": 138
      },
      {
        "stars": 2,
        "amount": 98
      }
    ],
    "open_now": true,
    "type": "Cafe",
    "subtypes": [
      "Cafe",
      "Coffee roastery"
    ],
    "photo_count": 3122,
    "working_hours": [
      {
        "day": "Sunday",
        "hours": "8 am–1 am"
      },
      {
        "day": "Monday",
        "hours": "8 am–1 am"
      }
    ]
  }
}