---
title: "Place"
description: "Get one place's details from Google."
---

> Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt)

```http
GET | POST /v1/google/place
```

Send parameters as a query string with `GET`, or as a JSON body with `POST`. Both are equivalent.

## Request

```bash tab="cURL"
curl "https://gateway.apinoa.com/v1/google/place?id=0x8644ca6bc309e81b:0x1f1a903bbb66839" \
  -H "x-api-key: $APINOA_API_KEY"
```

```js tab="JavaScript"
const params = new URLSearchParams({ id: "0x8644ca6bc309e81b:0x1f1a903bbb66839" });
const res = await fetch(`https://gateway.apinoa.com/v1/google/place?${params}`, {
  headers: { "x-api-key": process.env.APINOA_API_KEY },
});
const { success, data, error } = await res.json();
```

```python tab="Python"
import os

import requests

res = requests.get(
    "https://gateway.apinoa.com/v1/google/place",
    params={"id": "0x8644ca6bc309e81b:0x1f1a903bbb66839"},
    headers={"x-api-key": os.environ["APINOA_API_KEY"]},
)
body = res.json()
```

## Parameters

| Parameter | Type | Required | Notes |
|---|---|---|---|
| `id` | string |  | The place's id, as `places` returns it. |
| `lang` | string |  | Interface language. |
| `url` | string |  | A Google Maps place URL. |

The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json

## Response

Returns [`Place`](/docs/api-reference/serp/response-schema#place) in `data`. A real response, shortened: arrays keep their first entries and long text is cut.

```json
{
  "success": true,
  "data": {
    "id": "0x8644ca6bc309e81b:0x1f1a903bbb66839",
    "name": "Epoch Coffee",
    "url": "https://www.google.com/maps/preview/place/Epoch+Coffee,+221+W+N+Loop+Blvd,+Austin,+TX+78751/@30.3186037,-97.7245402,3444a,13.1y/data=!4m2!3m1!1s0x8644ca6bc309e8…",
    "address": {
      "full": "221 W N Loop Blvd, Austin, TX 78751",
      "street": "221 W N Loop Blvd",
      "city": "Austin",
      "region": "TX",
      "postalCode": "78751",
      "country": "US"
    },
    "coordinates": {"lat": 30.318603699999997, "lng": -97.72454019999999},
    "categories": ["Coffee shop"],
    "rating": 4.5,
    "reviewCount": 2534,
    "phone": "(512) 454-3762",
    "website": "http://www.epochcoffee.com/",
    "hours": [{"day": "Thursday", "hours": "Open 24 hours"}, {"day": "Friday", "hours": "Open 24 hours"}],
    "photos": [
      "https://lh3.googleusercontent.com/grass-cs/AABkmLf8MEzqjutCui37zmqNvXY83Pca5LQ_lkwbIzVGenHSqnuLI_Ik30zwgz1Awup0_iDR4V9H7mtV_8aijxQ8AFP-Y-hD1_ht7ogdduCfc_WLN64AT…",
      "https://lh3.googleusercontent.com/grass-cs/AABkmLfLrOLlfLpkdnFppSN1k1TI7tV6OWF-xDiQkpFLqZnWhXweai7GzvrOlD-tnNT7WECPmHVyFhvMJ1F8Q-ZW_Pfb3drJVOHG_2vjuFcXtAqPD9L__…"
    ],
    "attributes": [
      {"group": "Accessibility", "label": "Wheelchair accessible entrance"},
      {"group": "Accessibility", "label": "Wheelchair accessible parking lot"}
    ],
    "status": "open",
    "description": "Cool, vibrant small-chain cafe featuring nibbles, tea & carefully brewed espresso drinks.",
    "ext": {
      "placeId": "ChIJG-gJw2vKRIYROWi2uwOp8QE",
      "kgmid": "/g/1v76_180",
      "timeZone": "America/Chicago",
      "summary": "Hip coffee shop with light bites",
      "plusCode": {"global": "8624879G+C5", "compound": "879G+C5 Austin, Texas"},
      "areas": ["Americas", "Southern United States"],
      "owner": {
        "name": "Epoch Coffee (Owner)",
        "image": "https://lh5.googleusercontent.com/-WzsTjK0vgDQ/AAAAAAAAAAI/AAAAAAAAAAA/uanMPnqDLak/s44-p-k-no-ns-nd/photo.jpg"
      },
      "ratingHistogram": {"1": 84, "2": 60, "3": 149, "4": 462, "5": 1779},
      "reviewHighlights": [
        {
          "text": "The atmosphere is homey with mix matched furniture and funky decor.",
          "authorUrl": "https://www.google.com/maps/contrib/102913306226507508797?hl=en-US",
          "authorImage": "https://lh3.googleusercontent.com/a/ACg8ocK5EThT9DL2VwXLsgfvtdMFUTBc3PuaIs7oflgrtRY-u1ICqNA=s40-k-cc-rp-mo",
          "reviewerId": "102913306226507508797",
          "reviewId": "Ci9DQUlRQUNvZENodHljRjlvT2pOYVN6aHVhblppV0hNdFltTjRZWEZoVFdkRE1GRRAB"
        },
        {
          "text": "Classic Austin vibes with awesome prices and super friendly/ cool staff.",
          "authorUrl": "https://www.google.com/maps/contrib/100932097603579677275?hl=en-US",
          "authorImage": "https://lh3.googleusercontent.com/a/ACg8ocI598pfuVwBh_mkX_eCkPx1MjjrtWs16XS2FK2BaIB_yXZBAQ=s40-k-cc-rp-mo",
          "reviewerId": "100932097603579677275",
          "reviewId": "ChdDSUhNMG9nS0VJQ0FnSURBNkpmY3BRRRAB"
        }
      ],
      "topics": [{"label": "outdoor seating", "mentions": 71}, {"label": "study spot", "mentions": 20}],
      "reviews": [
        {
          "id": "Ci9DQUlRQUNvZENodHljRjlvT2tSS1ZtOUdNMlZ6Wm05eVowWnFXa2RKVFdOdVNHYxAB",
          "author": "Naomi • Intentionally Crafted",
          "rating": 5,
          "body": "A friend recommended Epoch Coffee on North Loop, so yesterday morning I made it the destination for my walk from East Austin—and I’m so glad I did!\n\nNestled nea…",
          "date": "2026-08-11T15:58:45.622Z",
          "language": "en",
          "images": [
            "https://lh3.googleusercontent.com/grass-cs/AABkmLerlYc1H21T5s0eRV7P6uroxN8CRED2zWk0KWFbIDxJx1Y7UjmKISAKFm-Y3QFcnINhD-nvGhkIq6zODbm4b1gs3I2jsgnGjkl1cvlTyGE3B7LCd…"
          ],
          "ext": {
            "dateText": "2 months ago",
            "source": "Google",
            "url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2tSS1ZtOUdNMlZ6Wm05eVowWnFXa2RKVFdOdVNHYxAB!2m1!1s0x0:0x1f1a903bbb66839!3m…",
            "authorUrl": "https://www.google.com/maps/contrib/104340167270615172538?hl=en-US",
            "authorImage": "https://lh3.googleusercontent.com/a-/ALV-UjVf_oseTFdaaXHxa7GWOkwHt9yWcYzESPE_-bMx2ojJbVdthaA=s120-c-rp-mo-ba12-br100",
            "reviewerId": "104340167270615172538",
            "authorReviewCount": 66,
            "authorPhotoCount": 395,
            "authorBadge": "Local Guide · 66 reviews",
            "answers": [{"question": "Order type", "answer": "Dine in"}]
          }
        },
        {
          "id": "Ci9DQUlRQUNvZENodHljRjlvT2pOYVN6aHVhblppV0hNdFltTjRZWEZoVFdkRE1GRRAB",
          "author": "Briana N.",
          "rating": 5,
          "body": "First impression they have friendly and welcoming baristas. Great menu with variety. I got a lemonade with peach syrup and hibiscus tea (so delicious!). My part…",
          "date": "2026-06-27T22:49:37.010Z",
          "language": "en",
          "images": [
            "https://lh3.googleusercontent.com/grass-cs/AABkmLdH5Ktkx_Dw3iqNRpafPbLYNIbb7mJq0M8v_sN2p2qAT7_46mhrvuKnB6SCeE_MZSuK0WFF9fhziGGxFhLcLZHGIV-4v79RXnjY8CsbDQk5Xp3R3…"
          ],
          "ext": {
            "dateText": "4 months ago",
            "source": "Google",
            "url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pOYVN6aHVhblppV0hNdFltTjRZWEZoVFdkRE1GRRAB!2m1!1s0x0:0x1f1a903bbb66839!3m…",
            "authorUrl": "https://www.google.com/maps/contrib/102913306226507508797?hl=en-US",
            "authorImage": "https://lh3.googleusercontent.com/a/ACg8ocK5EThT9DL2VwXLsgfvtdMFUTBc3PuaIs7oflgrtRY-u1ICqNA=s120-c-rp-mo-ba12-br100",
            "reviewerId": "102913306226507508797",
            "authorReviewCount": 81,
            "authorPhotoCount": 71,
            "authorBadge": "Local Guide · 81 reviews",
            "answers": [{"question": "Price per person", "answer": "$1–10"}]
          }
        }
      ]
    },
    "lang": "en",
    "photoCount": 838,
    "statusText": "Open 24 hours",
    "neighborhood": "North Loop",
    "reviewsUrl": "https://search.google.com/local/reviews?placeid=ChIJG-gJw2vKRIYROWi2uwOp8QE&authuser=0&hl=en&gl=US"
  }
}
```

## Errors

| Status | Code | Meaning |
|---|---|---|
| 400 | `INVALID_PARAMS` | A parameter is missing, unknown or out of range, or the engine does not take it. The message names it. |
| 401 | `UNAUTHORIZED` | The `x-api-key` header is missing, or the key is revoked or unknown. |
| 402 | `INSUFFICIENT_BALANCE` | The balance does not cover this call. Top up in the dashboard. |
| 404 | `NOT_FOUND` | The place does not exist. |
| 429 | `MARKETPLACE_SATURATED` | Too many concurrent calls. Retry after the `Retry-After` seconds. |
| 502 | `UPSTREAM_ERROR` | The engine answered with something unusable. Retry with backoff. |
| 503 | `SERVICE_UNAVAILABLE` | A temporary failure. Retry with backoff. |

Every code is listed in [Errors](/docs/errors). Failed calls are not billed.

## Pricing

**Price** $0.0012 per call. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day.

## Notes

- Pass `id` from `places`, or the place's map link as `url`.