Apinoa Docs

Place

Get one place's details from Google.

View raw .mdx
GET | POST /v1/google/place

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

Request

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

Parameters

ParameterTypeRequiredNotes
idstringThe place's id, as places returns it.
langstringInterface language.
urlstringA Google Maps place URL.

The same parameters, and every response type, are in the OpenAPI document.

Response

Returns Place in data. A real response, shortened: arrays keep their first entries and long text is cut.

{
  "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

StatusCodeMeaning
400INVALID_PARAMSA parameter is missing, unknown or out of range, or the engine does not take it. The message names it.
401UNAUTHORIZEDThe x-api-key header is missing, or the key is revoked or unknown.
402INSUFFICIENT_BALANCEThe balance does not cover this call. Top up in the dashboard.
404NOT_FOUNDThe place does not exist.
429MARKETPLACE_SATURATEDToo many concurrent calls. Retry after the Retry-After seconds.
502UPSTREAM_ERRORThe engine answered with something unusable. Retry with backoff.
503SERVICE_UNAVAILABLEA temporary failure. Retry with backoff.

Every code is listed in Errors. Failed calls are not billed.

Pricing

Price $0.0012 per call. List price; the rate steps down above 1,000 calls a day.

Notes

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

On this page