--- title: "Place" description: "从 Yandex 获取单个地点的详细信息。" --- > 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/yandex/place ``` 参数可以用 `GET` 的查询字符串发送，也可以用 `POST` 的 JSON 请求体发送，两者等价。 ## 请求 ```bash tab="cURL" curl "https://gateway.apinoa.com/v1/yandex/place?id=19464848293" \ -H "x-api-key: $APINOA_API_KEY" ``` ```js tab="JavaScript" const params = new URLSearchParams({ id: "19464848293" }); const res = await fetch(`https://gateway.apinoa.com/v1/yandex/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/yandex/place", params={"id": "19464848293"}, headers={"x-api-key": os.environ["APINOA_API_KEY"]}, ) body = res.json() ``` ## 参数 | Parameter | Type | Required | Notes | |---|---|---|---| | `id` | string | | The place's id, as `places` returns it. | | `url` | string | | A Yandex Maps organisation link. | The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json ## 响应 在 `data` 中返回 [`Place`](/docs/api-reference/serp/response-schema#place)。 真实响应的节选：数组只保留前几项，长文本已截断。 ```json { "success": true, "data": { "id": "19464848293", "name": "Ryba moya", "url": "https://yandex.com/maps/org/ryba_moya/19464848293/", "address": { "full": "Moscow, Slavyanskaya Square, 2", "street": "Slavyanskaya Square, 2", "city": "Moscow", "postalCode": "109012", "country": "Russian Federation" }, "coordinates": {"lat": 55.753391, "lng": 37.633956}, "categories": ["Restaurant"], "rating": 4.9, "reviewCount": 2744, "priceLevel": "Avg. bill: from 3000 ₽", "phone": "+7 (495) 784-68-58", "website": "https://rybamoya.ru/", "hours": [{"day": "daily", "hours": "12:00 PM–12:00 AM"}], "photos": ["https://avatars.mds.yandex.net/get-altay/5517598/2a0000017ebeb4da3c875…"], "attributes": [{"group": "Prices", "label": "average bill", "value": "3000–3500 ₽"}], "status": "closed", "lang": "en", "ext": { "subtitle": "Moscow, Slavyanskaya Square, 2", "ratingCount": 6132, "openNow": "Closed until 12:00 PM", "metro": [{"name": "Kitay-Gorod", "distance": "35 m", "type": "metro", "color": "#8647b2"}], "stops": [{"name": "Метро Китай-город", "distance": "41 m", "type": "common"}], "ad": true, "socialLinks": [ { "type": "telegram", "href": "https://t.me/perelmanrestaurants", "readableHref": "@perelmanrestaurants" } ], "price": {"item": "Avg. bill", "from": 3000, "to": 3500, "currency": "₽"}, "aspects": [ { "text": "Meal", "count": 2275, "positive": 2002, "neutral": 58, "negative": 215, "photos": ["https://avatars.mds.yandex.net/get-altay/11244149/2a0000018c54982d3cc0…"] } ], "popularTimes": { "monday": [0], "tuesday": [0], "wednesday": [0], "thursday": [0], "friday": [0], "saturday": [0], "sunday": [0] }, "menu": { "items": [ { "title": "Сашими из лосося", "description": "Тонко нарезанное филе подаём с маринованным имбирём. Дополняем соевым…", "price": 1190, "currency": "₽", "volume": "85 g", "image": "https://avatars.mds.yandex.net/get-eda/17780111/9bed7a6d1dc748758ccd6b…", "url": "https://eda.yandex/restaurant/ryba_moya_slavyanskaya_ploshhad_2", "category": "popular" } ], "total": 49, "kind": "food", "source": "Yango Deli", "updated": "2026-10-04T09:23:14Z" }, "advert": { "advertiser": "ООО \"СЫТОСТЬ\"", "advertiserTin": "7702407463", "products": [ { "title": "Рулетики из форели", "price": "1 690 р.", "priceValue": 1690, "currency": "RUB", "image": "https://avatars.mds.yandex.net/get-tycoon/18984817/2a0000019eab71c29be…", "url": "https://rybamoya.ru/?utm_source=yandex_business&utm_medium=branding_pr…" } ] }, "additionalAddress": "Рыба моя, этаж -1", "utcOffset": "+03:00", "entrances": [{"lat": 55.75341237, "lng": 37.63391087, "azimuth": 307.640383403427}], "panorama": "https://static-pano.maps.yandex.ru/v1/?panoid=1298236030_673226614_23_…", "goodPlaceYear": 2026, "unusualHours": ["2026-11-04"], "accessibilityPhotos": [ { "url": "https://avatars.mds.yandex.net/get-altay/4544819/2a00000178da7958d7963…", "tags": ["Entrance"], "width": 960, "height": 1280, "author": "Яндекс", "date": "2021-04-14T19:19:29Z" } ], "sources": [{"name": "Яндекс", "url": "ya.ru"}], "reviews": [ { "id": "BNGlcaXPdYB7jJ_dUUZoOqYNlJVzIy", "author": "mark hewstone", "authorId": "hq1p0pnw1zedpgb6jwvdazhgxg", "rating": 5, "body": "A chain of fish restaurants in Moscow. Don't let that put you off thou…", "date": "2025-01-22T19:06:20.329Z", "helpfulCount": 1, "images": ["https://avatars.mds.yandex.net/get-altay/13947802/2a000001948f68975ae7…"], "language": "en", "reply": {"body": "Благодарим за высокую оценку!", "date": "2025-01-27T13:11:08.395Z"}, "ext": { "authorLevel": "Level 12 Local Expert", "translations": { "ru": "Сеть рыбных ресторанов в Москве. Пусть это вас не смущает. Интересный…", "tr": "Moskova'da bir balık restoranları zinciri. Bunun seni ertelemesine izi…" } } } ] }, "photoCount": 499, "logo": "https://avatars.mds.yandex.net/get-altay/9720991/2a0000018853197f7fb60…", "verifiedOwner": true } } ``` ## 错误 | 状态 | 代码 | 含义 | |---|---|---| | 400 | `INVALID_PARAMS` | 参数缺失、未知、超出范围，或该引擎不接受。消息中会指出是哪一个。 | | 401 | `UNAUTHORIZED` | 缺少 `x-api-key` 请求头，或密钥已吊销或未知。 | | 402 | `INSUFFICIENT_BALANCE` | 余额不足以支付本次调用。请在控制台充值。 | | 404 | `NOT_FOUND` | 该地点不存在。 | | 429 | `MARKETPLACE_SATURATED` | 并发调用过多。请等待 `Retry-After` 秒后重试。 | | 502 | `UPSTREAM_ERROR` | 引擎返回了无法使用的内容。请退避后重试。 | | 503 | `SERVICE_UNAVAILABLE` | 临时故障。请退避后重试。 | 全部错误代码见 [Errors](/docs/errors)。失败的调用不计费。 ## 价格 **Price** $0.0012 per call. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day. ## 说明 - 传入 `places` 返回的 `id`，或把地点的地图链接作为 `url` 传入。