APINEED
Google logo

Google Maps Place Details API

google_maps_place_details
87.5% off

Retrieve detailed public business information for one Google Maps place.

Look up a single place using either place_id or data_id from Maps Search. The response can include contact details, hours, ratings, categories, and popular-time data when available.

TYPEPlace detailsPRICE$0.003125 per requestRESPONSEStructured JSON

Google Maps Place Details API Playground

Edit the JSON request and inspect the API response. Requests use your signed-in APINEED account and balance; no API key is needed here.

Request JSON
$0.003125 per requestSign in required. Failed requests are refunded.
Example response
{
  "request_id": "example_google_maps_place_details",
  "tool": "google_maps_place_details",
  "output": {
    "data": {
      "place_results": {
        "address": "San Francisco, CA",
        "phone": "+1 555 0100",
        "rating": 4.8,
        "title": "Example Coffee"
      }
    },
    "place_id": "example_place_id"
  },
  "usage": {
    "price_usd": "0.003125",
    "quota": 1563
  }
}
ExampleIllustrative data; no request sent or charge made.

Google Maps Place Details API Pricing

Current pricing from the APINEED catalog. Failed requests are refunded; server usage records remain authoritative.

APINEED price$0.003125 per requestBilled from recorded usage
Billing policySuccessful requests onlyFailed requests are refunded
Account balanceOne shared balanceUse the same balance and API keys as your models

Quick Start

Invoke Google Maps Place Details with one APINEED key and a JSON request body.

1

Use your APINEED API key

Reuse the same APINEED API key that your application already uses for LLM, image, and video APIs. Keep it server-side.

Create API key
export API_NEED_API_KEY=sk-apineed-v1-...
2

Send the request

POST the same input shown in the Playground to /v1/tools/google_maps_place_details/invoke.

curl 'https://apineed.com/v1/tools/google_maps_place_details/invoke' \
  -H "Authorization: Bearer $API_NEED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "country": "us",
  "place_id": "example_place_id"
}'
3

Read the response

Use output.data.place_results for the result and usage.price_usd for the settled request price.

const place = response.output.data.place_results;

Endpoint

This endpoint uses bearer-token authentication and returns a synchronous normalized JSON response.

POST/v1/tools/google_maps_place_details/invoke
Authorization
Bearer $API_NEED_API_KEY
Content-Type
application/json
Billing
$0.003125 per request on successful invocation
Response
request_id, tool, output, usage

Google Maps Place Details API Parameters

Provide place_id, data_id, or both. country is optional and defaults upstream to us.

NameTypeRequirementValuesDescription
countrystringOptionalPattern: ^[A-Za-z]{2}$Optional two-letter target country. Defaults upstream to us.
data_idstringOptional1–2048 charactersGoogle Maps data ID returned by Maps Search.
place_idstringOptional1–2048 charactersGoogle Place ID returned by Maps Search.

Google Maps Place Details API Introduction

A practical guide to the request, response, billing, and application use cases.

Integration guide·Based on the live API catalog
01

Google Maps Place Details API

Look up a single place using either place_id or data_id from Maps Search. The response can include contact details, hours, ratings, categories, and popular-time data when available.

02

Directory enrichment

Fill public business records with contact, category, and opening-hour data.

03

Location intelligence

Inspect ratings, attributes, and popular-time signals for one place.

04

Request contract

Send a JSON object to /v1/tools/google_maps_place_details/invoke. Use the required fields, supported optional parameters, and bounds listed above. Undocumented parameters are not guaranteed to be supported.

05

Response and usage

Read the tool result from output.data.place_results and the settled charge from usage.price_usd. Keep request_id for troubleshooting. Preserve optional response fields rather than assuming they are always present.

Common Questions

Practical answers about authentication, parameters, pricing, and integration.

What does Google Maps Place Details API do?

Look up a single place using either place_id or data_id from Maps Search. The response can include contact details, hours, ratings, categories, and popular-time data when available.

How do I authenticate?

Send a POST request to /v1/tools/google_maps_place_details/invoke with your APINEED API key in the Authorization: Bearer header. The same key can be used for model APIs. Keep the key on your server, not in browser code.

Can I try this API without entering an API key?

Yes. The Playground uses your signed-in APINEED account and shared balance. Sign in to send a request, or add funds if your balance is insufficient.

Which input fields are required?

The current schema has no required top-level fields. Check the parameter table for the supported input and constraints.

Can I omit optional parameters?

Yes. Optional fields: country, data_id, place_id. Omitted fields are not sent. Explicit false and 0 values are preserved; use the defaults and limits documented in the parameter table.

How much does a request cost?

The current catalog price is $0.003125 per request. The final charge is recorded in usage.price_usd and your account usage logs. Failed requests are refunded.

How should I read the response?

A successful invocation returns request_id, tool, output, and usage. Read the result from output, preserve request_id for troubleshooting, and inspect usage for the settled charge. The Playground shows the returned JSON without changing it.