Документация API v2. Версия заморожена и продолжает работать; актуальная — на главной. Что изменилось: переход с v2 на v3.

Где взять ссылку

Доступ для AI:

Для добавления объекта в систему необходимо скопировать ссылку с нужной площадки. Копируйте адрес страницы целиком, ничего не обрезая: площадку мы определим сами и приведём ссылку к нужному формату.

Ниже примеры со снимками для каждой площадки. На снимках обведено то, что нужно скопировать: А – адрес из строки браузера, Б – короткая ссылка из кнопки «Поделиться» там, где она есть.

Карты

Отели и бронирование

Медицина

Услуги и специалисты

Справочники

Не нашли нужную площадку? на добавление.

Форматы ссылок

Шаблон адреса и рабочий пример для каждой площадки. {…} – переменная часть.

Карты

source_idПлощадкаФормат ссылкиПример
1Яндекс.Картыyandex.ru/maps/-/{код}
yandex.ru/maps/org/{название}/{org_id}
yandex.ru/profile/{org_id}		https://yandex.ru/maps/org/areal/1262964858
https://yandex.ru/profile/7958059620
2Google Reviewsmaps.app.goo.gl/{код}
google.com/maps/place/{название}/@{координаты}/data=…		https://maps.app.goo.gl/dSiPVi4F8MBLvG4w8
32ГИС / Otellogo.2gis.com/{код}
2gis.ru/{город}/firm/{id}
2gis.ru/{город}/geo/{id}
otello.ru/hotel/{id}		https://go.2gis.com/BQ8Og
https://2gis.ru/moscow/firm/70000001079615757

Отели и путешествия

source_idПлощадкаФормат ссылкиПример
100Alean.rualean.ru/hotels/{страна}/{регион}/{город}/{отель}https://www.alean.ru/hotels/rossiya/moskva/borodino_gostinitsa
101OneTwoTriponetwotrip.com/ru/hotels/hotel/{название}-{id}https://www.onetwotrip.com/ru/hotels/hotel/safmar-tverskaia-moskva-296002
103Tvil.rutvil.ru/city/{город}/hotels/{id}https://tvil.ru/city/adler/hotels/427565
104Яндекс.Путешествияtravel.yandex.ru/hotels/{регион}/{отель}https://travel.yandex.ru/hotels/moscow/borodino-kongress-otel
105101Hotels101hotels.com/main/cities/{город}/{отель}.htmlhttps://101hotels.com/main/cities/moskva/gostinitsa_borodino.html
106Ostrovokostrovok.ru/hotel/{страна}/{город}/mid{id}/{отель}https://ostrovok.ru/hotel/russia/moscow/mid7599836/borodino_hotel
107Суточно.руsutochno.ru/front/searchapp/detail/{id}https://sutochno.ru/front/searchapp/detail/2212277
108TopHotels.rutophotels.ru/hotel/al{id}https://tophotels.ru/hotel/al125379
109TripAdvisortripadvisor.com/{Тип}_Review-g{гео}-d{id}-Reviews-{Название}.htmlhttps://www.tripadvisor.com/Hotel_Review-g298484-d671754-Reviews-Borodino_Alliance_Hotel-Moscow_Central_Russia.html
110Airbnbairbnb.com/rooms/{id}https://www.airbnb.com/rooms/1187653134175293144
111Booking.combooking.com/hotel/{код страны}/{отель}.htmlhttps://www.booking.com/hotel/th/the-royal-p-phuket.ru.html
112Trip.comtrip.com/hotels/detail/?hotelId={id}https://ru.trip.com/hotels/detail/?hotelId=1530754
113Agodaagoda.com/{отель}/hotel/{город}-{код страны}.htmlhttps://www.agoda.com/ru-ru/berlin-marriott-hotel_3/hotel/berlin-de.html

Медицина

source_idПлощадкаФормат ссылкиПример
300DocDoc.rudocdoc.ru/clinic/{клиника}
docdoc.ru/doctor/{врач}		https://docdoc.ru/clinic/klinika_temed_na_tehnoparke
301НаПоправкуnapopravku.ru/{город}/clinics/{клиника}
napopravku.ru/doctor-profile/{врач}		https://napopravku.ru/moskva/clinics/klinika-1-v-lyublino-mnogoprofilnyy-meditsinskiy-tsentr/
302Doctu.rudoctu.ru/{город}/doctor/{врач}
doctu.ru/{город}/clinic/{клиника}		https://doctu.ru/msk/doctor/zabelina-valerija-dmitrievna
303ПроДокторовprodoctorov.ru/{город}/lpu/{id}-{клиника}
prodoctorov.ru/{город}/vrach/{id}-{врач}		https://prodoctorov.ru/zelenograd/lpu/39192-nikor-med
305Яндекс.Медицинаyandex.ru/medicine/clinic/{название}_{id}
yandex.ru/medicine/doctor/{название}_{id}		https://yandex.ru/medicine/clinic/opeka_13445109767

Услуги и специалисты

source_idПлощадкаФормат ссылкиПример
304B17.rub17.ru/{ник специалиста}https://www.b17.ru/svetlana_guedova
400Profi.ruprofi.ru/profile/{ник}https://profi.ru/profile/SidorenkoSV3/
401Яндекс.Услугиuslugi.yandex.ru/profile/{ник}https://uslugi.yandex.ru/profile/DaniilR-152511
205Avitoадрес страницы продавца с ?sellerId={sellerId}https://www.avito.ru/brands/4390b5a759ee16a3f054904fe1d96187/all/transport?sellerId=96133ce69977bd69330485c589bf5451

Справочники

source_idПлощадкаФормат ссылкиПример
201Zoon.ruzoon.ru/{город}/{рубрика}/{название}https://zoon.ru/msk/medical/meditsinskij_tsentr_nikor-med_v_andreevke
207Flamp{город}.flamp.ru/firm/{название}-{id}https://moscow.flamp.ru/firm/aviator_sheremetevo_otel-4504127918577229
200Yell.ruyell.ru/{город}/com/{название}_{id}https://www.yell.ru/moscow/com/sauna-zabava_12088202
202Otzovikotzovik.com/reviews/{объект}https://otzovik.com/reviews/laboratoriya_invitro_russia
203iRecommend.ruirecommend.ru/content/{объект}https://irecommend.ru/content/gorod-sochi-rossiya
204Т-Банкtbank.ru/reviews/company/{компания}/{id}https://www.tbank.ru/reviews/company/kazanskaya-rivyera/105252
208ВКонтактеvk.ru/{имя сообщества}
vk.ru/club{id}
vk.ru/reviews-{id}		https://vk.ru/helix_lab
https://vk.ru/reviews-20155592

Что полезно знать

Площадку и формат мы определяем сами

  • Указывать площадку при добавлении не нужно – она определяется по адресу.
  • Адрес приводится к каноническому виду автоматически: лишние сегменты и параметры отбрасываются при сохранении. Например 2gis.ru/anapa/inside/104152…/firm/70000001088796893/37.30,44.94/tab/reviews сохранится как 2gis.ru/anapa/inside/104152…/firm/70000001088796893. Чистить адрес перед вставкой не нужно.

Одна площадка – одна ссылка в объекте

  • Вторая ссылка на ту же площадку внутри объекта вернёт ошибку Only one … link allowed per group. Несколько филиалов – это несколько объектов.
  • При добавлении списком каждая ссылка получает свой результат: неверная вернёт error с ожидаемым форматом, остальные добавятся.

Обязательные части адреса

  • Google – фрагмент data=…!1s0x…:0x…, это идентификатор места. Адреса maps.google.com/?cid=… и короткие адреса из строки поиска (/maps/place/Fresh, /maps/search/?q=…) его не содержат и отклоняются – в этом случае используйте кнопку «Поделиться».
  • Avito – ?sellerId= с 32-символьным идентификатором продавца. Без него продавца не определить.
  • Trip.com – ?hotelId=; языковой поддомен любой (ru., us., www.).
  • ВКонтакте – годится любая ссылка на сообщество: vk.ru/helix_lab, vk.ru/club29330414 или сама страница отзывов vk.ru/reviews-29330414. Личная страница не подойдёт – отзывы бывают только у сообществ.

Короткая ссылка «Поделиться» – тоже ссылка

  • Адреса maps.app.goo.gl/…, yandex.ru/maps/-/…, go.2gis.com/… принимаются как есть: система разворачивает их и сохраняет карточку, на которую они ведут.
  • Делитесь карточкой организации, а не точкой на карте: у ссылки на произвольную точку идентификатора места нет, и отзывы по ней собрать нельзя.

Зеркала и разные формы одного адреса

  • Страновые домены равнозначны: yandex.com.tr, yandex.kz, 2gis.kz, google.de ведут на ту же карточку, и дубли не создаются.
  • У 2ГИС /firm/ и /geo/, у Яндекса /maps/org/ и /profile/ – одно и то же место. Городские поддомены вроде spb.napopravku.ru работают наравне с основным доменом.
  • 2ГИС и Otello – одна площадка (source_id: 3): Otello это гостиничный раздел 2ГИС.

Если ссылку не приняли

  • Это не карточка объекта, а поиск, список или главная страница города.
  • Потеряна обязательная часть адреса – data= у Google, ?sellerId= у Avito, ?hotelId= у Trip.com.
  • Короткая ссылка «Поделиться» просрочена или площадка не ответила: откройте её в браузере и вставьте адрес карточки, на которую она ведёт.
  • Площадка не поддерживается – актуальный список отдаёт GET /v2/sources.
  • Причина другая – обязательно .

Все методы

Вся поверхность API одной страницей – 41 метод, сгруппированный по смыслу.

Ошибки

Единый формат ошибок, коды состояния и машиночитаемые коды.

On this page

КартыОтели и бронированиеМедицинаУслуги и специалистыСправочникиФорматы ссылокКартыОтели и путешествияМедицинаУслуги и специалистыСправочникиЧто полезно знатьПлощадку и формат мы определяем самиОдна площадка – одна ссылка в объектеОбязательные части адресаКороткая ссылка «Поделиться» – тоже ссылкаЗеркала и разные формы одного адресаЕсли ссылку не приняли