API KudaGo

API KudaGo - это бесплатная база событий и мест для разработчиков, вебмастеров и партнеров. Сервис по продвижению событий и мест KudaGo.com ежемесячно добавляет в свою базу от 3 до 5 тысяч событий, проходящих в крупнейших городах России, в Киеве и Нью-Йорке.

Мы публикуем концерты, спектакли, выставки, мастер-классы и курсы, события для детей и масштабные городские фестивали. У нас пользователи могут найти как долгожданные многотысячные события, проходящие раз в год, так и небольшие тематические события, аудитория которых составит всего несколько десятков человек.

На данный момент в нашей базе также находятся более 16 тысяч самых разных мест — кроме клубов, ресторанов, театров и музеев мы также собрали городские достопримечательности и различные неформатные места, которые стабильно пользуются огромным интересом у аудитории. Теперь мы готовы предоставлять свободный доступ к нашей базе с помощью API KudaGo. Это новый для рынка инструмент, позволяющий бесплатно заимствовать весь контент, публикуемый на KudaGo.

Лицензионное соглашение <открытая лицензия>

Настоящее Лицензионное соглашение (далее по тексту – «Соглашение») регламентирует порядок и условия использования третьими лицами (далее – «Пользователь», «Лицензиат») API и иных материалов (далее – «Данные»), содержащихся на сайте http://kudago.com, принадлежащих компании ООО «Реван» (место нахождения Россия, г. Санкт-Петербург, Каменноостровский пр-кт, д. 10, литера Б, офис 207, ОГРН 1127847097839, Revan LLC, далее – «Правообладатель», «Лицензиар»).

По настоящему Соглашению Пользователю (Лицензиату) передается простая (неисключительная) лицензия на объекты смежных прав, определенные в настоящем Соглашении, путем его заключения в упрощенном порядке.

Настоящее Соглашение является договором присоединения. Соглашение считается заключенным, а Пользователь считается ознакомленным со всеми условиями, содержащимися в настоящем Соглашении, с момента начала (первого) использования Данных Пользователем или авторизации на сайте http://docs.kudago.com/. С указанного момента Пользователь обязуется беспрекословно соблюдать условия настоящего Соглашения.

Настоящее Соглашение может быть изменено в одностороннем порядке в любое время по усмотрению Правообладателя без предупреждения Пользователя. С действующей редакцией Соглашения Пользователь может ознакомиться по адресу: http://docs.kudago.com/.

Соглашение считается заключенным на весь срок действия исключительного права Правообладателя или до одностороннего решения Правообладателя о запрете использования Данных или их частей (отзыв открытой лицензии).

Использование материалов допускается во всем мире, при условии соблюдения требований, ограничений, содержащихся в настоящем Соглашении.

В рамках настоящего Соглашения под материалами Правообладателя понимаются – тексты, анонсы, публикации, иной контент о мероприятиях, событиях, местах, заведениях, структура расположения данных и т.д., содержащиеся на сайте http://kudago.com/ (далее – «Материалы»).

Под API в рамках настоящего соглашения понимается – программное обеспечение, созданное Правообладателем, используемое для передачи Материалов с сайта http://kudago.com/ на сайт Пользователя, которое может быть свободно (без взимания платы) использовано Пользователем при условии соблюдения условий, установленных в настоящем документе.

Перечень Материалов, доступ к которым свободен, - определяется по усмотрению Правообладателя. Правообладатель вправе в любое время ограничить перечень Материалов или расширить его. Содержание Материалов определяется Правообладателем.

Правообладатель может в любое время изменить условия использования Данных, содержащихся на сайте http://kudago.com/.

Пользователь вправе использовать Данные по своему усмотрению – в коммерческих, личных, некоммерческих целях, при условии соблюдении требований и ограничений, указанных в настоящем Соглашении.

Пользователь вправе создавать новые произведения исходя из Данных при соблюдении следующего условия: все Данные и/или их части должны содержать прямые открытые для индексации ссылки (без параметров nofollow и noindex) на первоисточник (конкретный материал) с указанием непосредственного адреса на сайте http://kudago.com/. Указанное требование должно быть применимо при любом заимствовании, копировании, использовании Данных с сайта http://kudago.com/.

При нарушении условий настоящего Соглашения (отсутствие ссылок, передача Данных на коммерческой основе третьим лицам) - Пользователь теряет право на дальнейшее использование Данных, считается нарушившим настоящее Соглашение, и к нему могут быть применены правовые средства защиты, в том числе – предъявлены исковые заявления, требования о компенсации за нарушения исключительных прав Правообладателя и т.д.

Пользователь ознакомлен с тем, что некоторые из материалов, размещенных на сайте являются рекламными (имеется соответствующая маркировка). Использование рекламных материалов с токенами, которые были получены без участия Пользователя - недопустимо. Ответственность за соблюдение законодательства о рекламе лежит на Пользователе в случае использования указанных материалов.

В случае, если если Пользователь использует или переделывает любой материал, опубликованный на Сайте в рекламных целях - ответственность, как рекламораспространитель несет Пользователь в соответствии с законодательством РФ.

Настоящее Соглашение не распространяется на товарные знаки Правообладателя или третьих лиц, не допустимо использование в названиях/его частях (в том числе юридических, коммерческих наименованиях) Пользователей обозначения «kudago». Недопустимо введение третьих лиц в заблуждение относительно Правообладателя Данных.

Пользователь не вправе использовать Данные способами, нарушающими права третьих лиц, и/или являющимися незаконными в соответствии с применимым правом. Лицензиат самостоятельно проверяет законность своей деятельности и соблюдение им обязательных требований.

Пользователь не вправе продавать или получать иную выгоду от передачи материалов с сайта http://kudago.com/ третьим лицам.

Право собственности на Материалы, полученные Пользователем через открытый доступ к API, или иными способами - ни при каких обстоятельствах не передается Пользователю.

Правообладатель не несет ответственности в случае некорректности тех или иных Данных, а равно в случае неработоспособности API, проведения технических работ на сайте Правообладателя, временное ограничения доступа к сайту http://kudago.com/. Пользователь использует Данные добровольно под свою личную ответственность. Ни при каких условиях Правообладатель не возмещает Пользователю упущенную выгоду или иной ущерб, возникший вследствие использования Пользователем Данных или невозможности использования в связи с недоступностью сайта Правообладателя (в том числе, в случае его неработоспособности).

В случае осуществления Пользователем регистрации или авторизации на сайте http://kudago.com/, а равно в случае иного предоставления своих персональных данных Правообладателю, Пользователь соглашается на их сбор, хранение и переработку в объеме, предоставленном им, включая систематизацию, накопление, уточнение (обновление, изменение), распространение (в том числе передачу) и уничтожение, передачу органам местного самоуправления, государственным органам, а также иным организациям, в случаях, если такое требование предъявляется действующим законодательством. Правообладатель гарантирует отсутствие использования персональных данных Пользователей в целях, противоречащих действующему законодательству РФ.

К настоящему Соглашению применяются нормы законодательства РФ. В случае наличия споров, нарушения Пользователем настоящего Соглашения, Правообладатель вправе направить претензию пользователю в электронном виде по адресу, указанному в процессе авторизации на сайте. В случае отсутствия ответа в течение 7 (семи) календарных дней со дня отправления уведомления/ претензии, Правообладатель в праве обратиться в суд по месту нахождения Правообладателя в соответствии с порядком, установленным действующим на момент подачи заявления законодательством РФ.

При несогласии с условиями настоящего Соглашения, Пользователь не вправе использовать Данные.

Механизм использования Данных (техническая документация) устанавливается Правообладателем и располагается на сайте: http://docs.kudago.com/.

Настоящая редакция Соглашения действует с момента ее опубликования на сайте http://kudago.com/, и является обязательной для всех Пользователей сайта.

История изменений Начало

История изменений

02.02.2018

Версия API 1.4
В события дня теперь размещаются в том числе и фильмы, что привело к изменению формата ответа. Для версии 1.3 формат останется прежним, но отдаваться будут только события.
В событиях дня также отдается переопределение заголовка (начиная с версии 1.4)

18.12.2017

Для категорий мест и событий показывается идентификатор, что позволяет фильтровать по категориям места и события

21.11.2016

Добавлена возможность фильтрации объектов по слагам тэгов с помощью параметра tags

18.07.2016

Добавлен раздел Агенты
Добавлен раздел Роли
В сериализацию событий добавлено поле participants, содержащее список агентов события

12.07.2016

В /search/ параметр фильтрации объектов по типу переименован из type в ctype (по названию поля)
Версия API 1.3

01.07.2016

Добавлен фильтр actual_only для новостей, который выбирает только актуальные новости

27.05.2016

В сериализацию города было добавлено поле currency

12.04.2016

В сериализацию дат событий добавлен флаг use_place_schedule, означающий, что событие проводится по расписанию места

01.04.2016

В сериализацию мест добавлен флаг has_parking_lot, сигнализирующий о наличии парковки.

31.03.2016

В сериализацию событий, мест, подборок, новостей и фильмов добавлен флаг disable_comments, отмечающий, что для данного объекта выключены комментарии.

30.03.2016

В сериализации событий и событий дня поменялось представление дат и времени, что вызвало поднятие версии API до 1.2. В версии 1.1 у дат событий для полей start_date, end_date и у событий дня для поля date отдается число секунд от 01.01.1970 00:00, но при этом не в UTC, а в локальном часовом поясе города, в котором происходит событие. У событий для полей start_time и end_time отдавалось число секунд от полуночи. Вместо этого в версии 1.2 для всех перечисленных полей отдается строковое представление в формате ISO 8601

03.03.2016

В сериализацию объектов в поиске и элементов списка добавлено поле age_restriction

17.02.2016

В общую и расширенную сериализацию мест добавлено поле subway
Телефоны мест форматируются согласно E.123 International notation

15.02.2016

В сериализации событий, мест и фильмов возрастное ограничение теперь строка вида 18+ (раньше было число 18). Это вызвало поднятие версии API до 1.1, в версии 1 будет отдаваться число

08.02.2015

Добавлены события дня

27.01.2016

В сериализацию дат событий добавлены поля start_date, start_time, end_date, end_time, is_continuous, is_endless, is_startless, schedules

09.12.2015

В сериализацию изображений добавлено поле, указывающее авторство

08.12.2015

Добавлена возможность получать тексты совсем без тегов с помощью параметра text_format=text

07.12.2015

Добавлен флаг is_stub в расширенную сериализацию места для событий, новостей и показов

24.11.2015

Добавлена возможность выборки только фильмов с бесплатными показами
Добавлена возможность выборки только мест с бесплатными событиями
Более строгая интерпретация параметра is_free - принимаются только значения 1, 0, true, false, остальные варианты игнорируются

13.11.2015

Добавлено поле language в сериализацию города

11.11.2015

Добавлена возможность выключать категории мест и событий при запросе соответствующих коллекций

03.11.2015

Исправлено дублирование событий и мест при фильтрации по категориям
Добавлена возможность фильтрации мест, событий, новостей, подборок, фильмов и комментариев по id

31.10.2015

Добавлено поле coords в места внутри событий
Добавлена возможность фильтрации события по координатам

30.10.2015

Добавлено поле tags в сериализацию мест и событий

27.10.2015

Добавлен параметр text_format: если передано html, то тексты отдаются в формате HTML, если передано plain, то тексты отдаются без тэгов

14.10.2015

Добавлен параметр include_inactual: если передано 1, то в поисковую выдачу включаются неактуальные объекты (по умолчанию равно 0)

13.10.2015

Добавлена возможность фильтрации мест и событий по родительскому объекту
Добавлена возможность фильтрации мест и событий по месту

30.09.2015

Добавлено поле short_title в сериализацию мест и событий

Категории объектов Лицензионное соглашение <открытая лицензия>

Категории объектов

Для классификации событий и мест существуют различные категории. При фильтрации мест или событий используется слаг классификатора.

Категории событий

Список категорий событий

GET

/public-api/{version}/event-categories/{?lang,order_by,fields}

Пример запроса
GET https://kudago.com/public-api/v1.4/event-categories/?lang=&order_by=&fields=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
fields
string (необязательный) По умолчанию: id,slug,name
включить в выдачу только указанные поля, можно несколько через запятую
```
slug - слаг
name - название
```
order_by
string (необязательный) По умолчанию: slug
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id slug name

Запрос Cписок категорий событий с названиями на русском языкеПоказатьСкрыть

https://kudago.com/public-api/v1.2/event-categories/?lang=ru

Тело

[
    {
        "id": "1",
        "slug": "ball",
        "name": "Балы (Развлечения)"
    },
    {
        "id": "2",
        "slug": "business-events",
        "name": "События для бизнеса"
    },
    ...
]

Запрос Cписок категорий событий с другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/event-categories/?lang=ru&fields=slug

Тело

[
    {
        "slug": "ball",
    },
    {
        "slug": "business-events",
    },
    ...
]

Категории мест

Список категорий мест

GET

/public-api/{version}/place-categories/{?lang,order_by,fields}

Пример запроса
GET https://kudago.com/public-api/v1.4/place-categories/?lang=&order_by=&fields=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
fields
string (необязательный) По умолчанию: id,slug,name
включить в выдачу только указанные поля, можно несколько через запятую
```
slug - слаг
name - название
```
order_by
string (необязательный) По умолчанию: slug
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id slug name

Запрос Cписок категорий мест с названиями на русском языкеПоказатьСкрыть

https://kudago.com/public-api/v1.2/place-categories/?lang=ru

Тело

[
    {
        "id": "1",
        "slug": "academy-of-music",
        "name": "Музыкальные школы (Учебн завед)"
    },
    {
        "id": "2",
        "slug": "airports",
        "name": "Аэропорты"
    },
    ...
]

Запрос Cписок категорий мест с другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/place-categories/?lang=ru&fields=slug

Тело

[
    {
        "slug": "academy-of-music",
    },
    {
        "slug": "airports",
    },
    ...
]

Города История изменений

Города

Список городов, для которых компания собирает интересные события и мероприятия.

Список городов

Получение списка городов

GET

/public-api/{version}/locations/{?lang,fields,order_by}

Пример запроса
GET https://kudago.com/public-api/v1.4/locations/?lang=&fields=&order_by=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
fields
string (необязательный) По умолчанию: slug,name
включить в выдачу только указанные поля, можно несколько через запятую
```
slug - слаг
name - название
timezone - часовой пояс
coords - координаты
language - язык
```
order_by
string (необязательный) По умолчанию: slug
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: slug name timezone coords language currency

Запрос Cписок всех городов с названиями на русском языкеПоказатьСкрыть

https://kudago.com/public-api/v1.2/locations/?lang=ru

Тело

[
    {
        "slug": "ekb",
        "name": "Екатеринбург"
    },
    {
        "slug": "kev",
        "name": "Киев"
    },
    ...
]

Запрос Cписок всех городов c другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/locations/?lang=ru&fields=slug,timezone

Тело

[
    {
        "slug": "ekb",
        "timezone": "Asia/Yekaterinburg"
    },
    {
        "slug": "kev",
        "timezone": "Europe/Kiev"
    },
    ...
]

Детализация города

Получение детализации города

GET

/public-api/{version}/locations/{slug}/{?lang,fields}

Пример запроса
GET https://kudago.com/public-api/v1.4/locations/msk/?lang=&fields=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
slug
string (обязательный) Пример: msk
слаг города

fields
string (необязательный)
включить в выдачу только указанные поля, можно несколько через запятую
```
slug - слаг
name - название
timezone - часовой пояс
coords - координаты
language - язык
```

Запрос Детализация города на русском языкеПоказатьСкрыть

https://kudago.com/public-api/v1.2/locations/spb/?lang=ru

Тело

{
  "slug": "spb",
  "name": "Санкт-Петербург",
  "timezone": "GMT+03:00",
  "coords": {
    "lat": 59.939095,
    "lon": 30.315868
  },
  "language": "ru",
  "currency": "RUB"
}

Запрос Детализация города с другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/locations/spb/?lang=ru&fields=slug,coords

Тело

{
  "slug": "spb",
  "coords": {
    "lat": 59.939095,
    "lon": 30.315868
  }
}

Ответ 404ПоказатьСкрыть
Нет города с таким слагом или он скрыт

Поиск Категории объектов

Поиск

Получение результатов поиска

GET

/public-api/{version}/search/{?q,lang,expand,location,ctype,is_free,lat,lon,radius}

Пример запроса
GET https://kudago.com/public-api/v1.4/search/?q=выставка&lang=&expand=&location=msk&ctype=event&is_free=&lat=&lon=&radius=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: place dates
q
string (обязательный) Пример: выставка
поисковый запрос

location
string (необязательный) Пример: msk
место для поиска
```
spb - Санкт-Петербург
msk - Москва
nsk - Новосибирск
ekb - Екатеринбург
nnv - Нижний Новгород
kzn - Казань
vbg - Выборг
smr - Самара
krd - Краснодар
sochi - Сочи
ufa - Уфа
krasnoyarsk - Красноярск
kev - Киев
new-york - Нью-Йорк
```
ctype
string (необязательный) Пример: event
тип контента

Варианты: news event place list
is_free
number (необязательный)
выбрать бесплатные объекты

Варианты: 1 true
include_inactual
number (необязательный)
включить в выборку также и неактуальные объекты (прошедшие события, закрытые места, и т.д.)

Варианты: 1
lat
number (необязательный)
широта

lon
number (необязательный)
долгота

radius
number (необязательный)
радиус вокруг точки, в метрах

Запрос Поиск новостейПоказатьСкрыть

https://kudago.com/public-api/v1.3/search/?q=news&ctype=news

Тело

{
    "count": 29,
    "next": "https://kudago.com/public-api/v1.3/search/?page=2&q=news&ctype=news",
    "previous": null,
    "results":
        [
            {
                "id": 11402,
                "title": "вечер блюза подарят горожанам новосибирские коллективы",
                "favorites_count": 0,
                "comments_count": 0,
                "description": "На одной площадке соберутся сразу три группы: «Капитан Дик», Grinevich Blues Band и The News.",
                "ctype": "news",
                "place": null,
                "date": 1438951890
            },
            ...
        ]
}

Запрос Поиск событийПоказатьСкрыть

https://kudago.com/public-api/v1.3/search/?q=event&ctype=events

Тело

{
    "count": 1576,
    "next": "https://kudago.com/public-api/v1.3/search/?page=2&q=event&ctype=events",
    "previous": null,
    "results":
        [
            {
                "id": 97313,
                "title": "обучающий курс Freedom School «Как изобрести event?»",
                "favorites_count": 0,
                "comments_count": 0,
                "description": "<p>Научиться создавать яркие мероприятия можно уже начиная с этой недели. Приходите на занятия во Freedom School, набирайтесь опыта у продвинутых специалистов, вдохновляйтесь идеями и проводите события, которые запомнятся гостям надолго!</p>\n",
                "ctype": "event",
                "place": {
                    "id": 18550
                },
                "daterange": {
                    "start": 1444683600,
                    "end": 1448571600
                }
            },
            ...
        ]
}

Запрос Поиск местПоказатьСкрыть

https://kudago.com/public-api/v1.3/search/?q=place&ctype=place

Тело

{
    "count": 1413,
    "next": "https://kudago.com/public-api/v1.3/search/?ctype=place&page=2&q=place",
    "previous": null,
    "results":
        [
            {
                "id": 17985,
                "title": "Dixon Place",
                "favorites_count": 0,
                "comments_count": 0,
                "description": "A local haven for creativity as well as an international model for the open exploration of the process of creation. If you have work that would be appropriate for Dixon Place, please read our open submissions policy.",
                "ctype": "place",
                "address": "161 Chrystie Street, New York, NY 10002",
                "coords": {
                    "lat": 40.72061799999999,
                    "lon": -73.9929238
                },
                "is_closed": false,
                "is_stub": false
            },
            ...
        ]
}

Запрос Поиск подборокПоказатьСкрыть

kudago.com/public-api/v1.3/search/?q=list&ctype=list

Тело

{
    "count": 92,
    "next": "https://kudago.com/public-api/v1.3/search/?page=2&q=list&ctype=list",
    "previous": null,
    "results":
        [
            {
                "id": 4637,
                "title": "10 October Exhibitions You Must See",
                "favorites_count": 0,
                "comments_count": 0,
                "description": "New York City's art galleries and museums can't hold still. Paintings, drawings, photos, sculpture, and objects of all kinds. See what they have gathered this time, explore the list of best art on the view this October. Here are the 10 October exhibitions you simply must see.",
                "ctype": "list"
            },
            ...
        ]
}

События Города

События

События - это список мероприятий, по которым компанию предоставляет информацию.

Список событий

Получение списка событий

GET

/public-api/{version}/events/{?lang,fields,expand,order_by,text_format,ids,location,actual_since,actual_until,is_free,categories,lon,lat,radius}

Пример запроса
GET https://kudago.com/public-api/v1.4/events/?lang=&fields=&expand=&order_by=&text_format=&ids=&location=&actual_since=1444385206&actual_until=1444385405&is_free=&categories=kvn,-magic&lon=&lat=&radius=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный) По умолчанию: id,title,slug
включить в выдачу только указанные поля, можно несколько через запятую
```
id - идентификатор
publication_date - дата публикации
dates - даты проведения
title - название
short_title - короткое название
slug - слаг
place - место проведения
description - описание
body_text - полное описание
location - город проведения
categories - список категорий
tagline - тэглайн
age_restriction - возрастное ограничение
price - стоимость
is_free - бесплатное ли событие
images - картинки
favorites_count - сколько пользователей добавило событие в избранное
comments_count - число комментариев к событию
site_url - адрес события на сайте kudago.com
tags - тэги события
participants - агенты события
```
expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: images place location dates participants
order_by
string (необязательный) По умолчанию: -rank,-id
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id publication_date title slug place description body_text location tagline age_restriction price is_free favorites_count comments_count short_title
text_format
string (необязательный) По умолчанию: html
отдавать поля body_text и description в указанном формате
```
html - текст с тэгами
plain - текст без тегов, ссылки <a href=a_href>a_title</a> преобразуются в вид: a_title a_href
text - текст без тегов, от ссылок остается только название
```
ids
number (необязательный)
включить выдачу только события с указанными ID, можно несколько через запятую

location
string (необязательный)
включить в выдачу события только из указанного города
```
spb - Санкт-Петербург
msk - Москва
nsk - Новосибирск
ekb - Екатеринбург
nnv - Нижний Новгород
kzn - Казань
vbg - Выборг
smr - Самара
krd - Краснодар
sochi - Сочи
ufa - Уфа
krasnoyarsk - Красноярск
kev - Киев
new-york - Нью-Йорк
```
actual_since
number or string (необязательный) Пример: 1444385206
включить в выдачу только те события, которые начались после указанного момента времени (в формате UNIX timestamp или ISO 8601, в любом случае время считается в UTC)

actual_until
number or string (необязательный) Пример: 1444385405
включить в выдачу только те события, которые закончились до указанного момента времени (в формате UNIX timestamp или ISO 8601, в любом случае время считается в UTC)

place_id
number (необязательный) Пример: 1
включить в выдачу события только для указанного места

parent_id
number (необязательный) Пример: 1
включить в выдачу события, дочерние к указанному событию

is_free
number or string (необязательный)
включить в выдачу только бесплатные события

Варианты: 1 0 true false
categories
string (необязательный) Пример: kvn,-magic
включить в выдачу события из указанных категорий (см. Категории событий), можно несколько через запятую; если категория указана со знаком минус, то события с такой категорией будут выключены из выдачи

tags
string (необязательный)
включить выдачу только события с указанными слагами тэгов, можно несколько через запятую; если тэг указан со знаком минус, то события с таким тэгом будут выключены из выдачи

lon
number (необязательный)
lat
number (необязательный)
radius
number (необязательный)
lat, lon и radius вместе фильтруют события вокруг указанных координат; радиус указывается в метрах

Запрос Список событийПоказатьСкрыть

https://kudago.com/public-api/v1.2/events/

Тело

{
    "count": 82677,
    "next": "https://kudago.com/public-api/v1.2/events/?page=2",
    "previous": null,
    "results": [
        {
            "id": 13870,
            "title": "Deep Mode @Propaganda",
            "slug": "deep-mode"
        },
        ...
    ]
}

Запрос Список событий c другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/events/?fields=age_restriction,is_free

Тело

{
    "count": 82677,
    "next": "https://kudago.com/public-api/v1.2/events/?fields=age_restriction%2Cis_free&page=2",
    "previous": null,
    "results": [
        {
            "age_restriction": "18+",
            "is_free": false
        },
        ...
    ]
}

Запрос Список событий c фильтрамиПоказатьСкрыть

https://kudago.com/public-api/v1.2/events/?location=spb&actual_since=1384252440&actual_until=1384292440&is_free=1&categories=exhibition,concert

Тело

{
    "count": 32,
    "next": "https://kudago.com/public-api/v1.2/events/?actual_since=1384252440&actual_until=1384292440&categories=exhibition%2Cconcert&is_free=1&location=spb&page=2",
    "previous": null,
    "results": [
        {
            "id": 28511,
            "title": "выставка Максима Бойкова «Вепсский лес, или История одного дня»",
            "slug": "vystavka-maksim-bojkov-vepsskij-les-ili-istoriya-o"
        },
        ...
    ]
}

Запрос Список событий c детализацией места, города, дат и участниковПоказатьСкрыть

https://kudago.com/public-api/v1.2/events/?expand=place,location,dates,participants&fields=id,place,location,dates,participants

Тело

{
    "count": 96197,
    "next": "https://kudago.com/public-api/v1.2/events/?expand=place%2Clocation%2Cdates%2Cparticipants&fields=id%2Cplace%2Clocation%2Cdates%2Cparticipants&page=2",
    "previous": null,
    "results": [
        {
            "id": 125721,
            "dates": [
                {
                    "start_date": "2017-03-12",
                    "start_time": "13:00:00",
                    "start": 1489312800,
                    "end_date": null,
                    "end_time": null,
                    "end": 1489312800,
                    "is_continuous": false,
                    "is_endless": false,
                    "is_startless": false,
                    "schedules": [],
                    "use_place_schedule": false
                }
            ],
            "place": {
                "id": 745,
                "title": "Московский международный Дом музыки (ММДМ)",
                "slug": "mmdm",
                "address": "Космодамианская наб., 52, стр. 8",
                "phone": "+7 495 730-10-11",
                "is_stub": false,
                "site_url": "http://kudago.com/msk/place/mmdm/",
                "coords": {
                    "lat": 55.73324899999993,
                    "lon": 37.64659699999999
                },
                "subway": "Павелецкая",
                "is_closed": false,
                "location": "msk"
            },
            "location": {
                "slug": "msk",
                "name": "Moscow",
                "timezone": "GMT+03:00",
                "coords": {
                    "lat": 55.753676,
                    "lon": 37.619899
                },
                "language": "ru",
                "currency": "RUB"
            },
            "participants": [
                {
                    "role": {
                        "id": 9,
                        "name": "stage theatre",
                        "name_plural": "stage theatres"
                    },
                    "agent": {
                        "id": 6954,
                        "ctype": "agent",
                        "title": "Московский областной театр юного зрителя",
                        "slug": "moskovskij-oblastnoj-teatr-yunogo-zritelya",
                        "description": "",
                        "body_text": "",
                        "rank": 0.0,
                        "agent_type": "organization",
                        "images": [],
                        "favorites_count": 0,
                        "comments_count": 0,
                        "item_url": "https://kudago.com/follow/moskovskij-oblastnoj-teatr-yunogo-zritelya/",
                        "disable_comments": false
                    }
                }
            ]
        },
        ...
    ]
}

Ответ 400ПоказатьСкрыть
Неверная категория событий

Детализация события

Получение детализации события

GET

/public-api/{version}/events/{event_id}/{?lang,fields,expand}

Пример запроса
GET https://kudago.com/public-api/v1.4/events/60843/?lang=&fields=&expand=

Параметры

version

string (обязательный) Пример: v1.4

версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4

lang

string (необязательный) По умолчанию: ru

язык ответа

Варианты: ru en

event_id

number (обязательный) Пример: 60843

идентификатор события

fields

string (необязательный)

включить в выдачу только указанные поля, можно несколько через запятую

id - идентификатор
publication_date - дата публикации
dates - даты проведения
title - название
short_title - короткое название
slug - слаг
place - место проведения
description - описание
body_text - полное описание
location - город проведения
categories - список категорий
tagline - тэглайн
age_restriction - возрастное ограничение
price - стоимость
is_free - бесплатное ли событие
images - картинки
favorites_count - сколько пользователей добавило событие в избранное
comments_count - число комментариев к событию
site_url - адрес события на сайте kudago.com
tags - тэги события
participants - агенты события

expand

string (необязательный)

включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: images place location dates

Запрос Детализация событияПоказатьСкрыть

http://kudago.com/public-api/v1.3/events/125721/

Тело

{
  "id": 125721,
  "publication_date": 1467993495,
  "dates": [
    {
      "start": 1489312800,
      "end": 1489312800
    }
  ],
  "title": "спектакль «Дюймовочка»",
  "slug": "koncert-dyujmovochka",
  "place": {
    "id": 745
  },
  "description": "",
  "body_text": "",
  "location": {
    "slug": "msk"
  },
  "categories": [
    "theater"
  ],
  "tagline": "",
  "age_restriction": "6+",
  "price": "от 1200 до 2400 рублей в абонементе",
  "is_free": false,
  "images": [
    {
      "image": "http://kudago.com/media/images/event/51/f3/51f3297d400869bca0598b816433b06f.jpg",
      "source": {
        "link": "http://mogtyz.ru/spectacles/dyuymovochka/",
        "name": "mogtyz.ru"
      }
    }
  ],
  "favorites_count": 0,
  "comments_count": 0,
  "site_url": "http://kudago.com/msk/event/koncert-dyujmovochka/",
  "short_title": "Дюймовочка",
  "tags": [
    "play",
    "6+",
    "performances for children",
    "theater (plays, opera, ballet etc)"
  ],
  "disable_comments": false,
  "participants": [
    {
      "role": {
        "slug": "stage_theatre"
      },
      "agent": {
        "id": 6954,
        "title": "Московский областной театр юного зрителя",
        "slug": "moskovskij-oblastnoj-teatr-yunogo-zritelya",
        "agent_type": "organization",
        "images": [],
        "site_url": "https://kudago.com/follow/moskovskij-oblastnoj-teatr-yunogo-zritelya/"
      }
    }
  ]
}

Запрос Детализация события c другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/events/13870/?fields=price,tagline

Тело

{
  "tagline": "Серия вечеринок посвященных всем оттенкам хауса",
  "price": ""
}

Запрос Детализация события c детализацией города, места, дат и участниковПоказатьСкрыть

http://kudago.com/public-api/v1.3/events/125721/?fields=id,participants,place,location,dates&expand=participants,place,location,dates

Тело

{
  "id": 125721,
  "dates": [
    {
      "start_date": "2017-03-12",
      "start_time": "13:00:00",
      "start": 1489312800,
      "end_date": null,
      "end_time": null,
      "end": 1489312800,
      "is_continuous": false,
      "is_endless": false,
      "is_startless": false,
      "schedules": [],
      "use_place_schedule": false
    }
  ],
  "place": {
    "id": 745,
    "title": "Московский международный Дом музыки (ММДМ)",
    "slug": "mmdm",
    "address": "Космодамианская наб., 52, стр. 8",
    "phone": "+7 495 730-10-11",
    "is_stub": false,
    "site_url": "http://kudago.com/msk/place/mmdm/",
    "coords": {
      "lat": 55.73324899999993,
      "lon": 37.64659699999999
    },
    "subway": "Павелецкая",
    "is_closed": false,
    "location": "msk"
  },
  "location": {
    "slug": "msk",
    "name": "Moscow",
    "timezone": "GMT+03:00",
    "coords": {
      "lat": 55.753676,
      "lon": 37.619899
    },
    "language": "ru",
    "currency": "RUB"
  },
  "participants": [
    {
      "role": {
        "id": 9,
        "name": "stage theatre",
        "name_plural": "stage theatres"
      },
      "agent": {
        "id": 6954,
        "ctype": "agent",
        "title": "Московский областной театр юного зрителя",
        "slug": "moskovskij-oblastnoj-teatr-yunogo-zritelya",
        "description": "",
        "body_text": "",
        "rank": 0,
        "agent_type": "organization",
        "images": [],
        "favorites_count": 0,
        "comments_count": 0,
        "item_url": "https://kudago.com/follow/moskovskij-oblastnoj-teatr-yunogo-zritelya/",
        "disable_comments": false
      }
    }
  ]
}

Ответ 404ПоказатьСкрыть
Нет объекта с таким id

Комментарии к событию

Получение комментариев к событию

GET

/public-api/{version}/events/{event_id}/comments/{?lang,fields,order_by,ids}

Пример запроса
GET https://kudago.com/public-api/v1.4/events/60843/comments/?lang=&fields=&order_by=&ids=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
event_id
number (обязательный) Пример: 60843
идентификатор события

page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный)
включить в выдачу только указанные поля, можно несколько через запятую

Варианты: id date_posted text user is_deleted replies_count thread reply_to
order_by
string (необязательный) По умолчанию: date_posted
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id date_posted text user is_deleted replies_count thread reply_to
ids
number (необязательный)
включить выдачу только комментарии с указанными ID, можно несколько через запятую

Запрос Список комментариев к событиюПоказатьСкрыть

https://kudago.com/public-api/v1.2/events/51836/comments/

Тело

{
    "count": 19,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 10822,
            "date_posted": 1419120197,
            "text": "Все супер! Понравилось просто все: начиная со встречи и заканчивая прощанием. Встретил сам организатор. Все рассказал, пояснил что к чему. Понравилось, что за ходом игры наблюдают и не дают долго тупить. Даются подсказки, но легкие наводящие. Единственный минус это то, что в один момент нам слишком рано дали подсказку. В остальном просто супер. Реквизита минимум, действий максимум, качественный антураж. Ждем новых квестов от этих организаторов. Спасибо за настроение.",
            "user": {
                "display_name": "some",
                "avatar": "http://kudago.com/media/images/user/fa/5c/fa5ca20e29c746aa52773444f5d90b47.jpg"
            },
            "is_deleted": false,
            "replies_count": 0,
            "thread": null,
            "reply_to": null
        },
        ...
    ]
}

Запрос Список комментариев к событию c другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/events/51836/comments/?fields=text,id

Тело

{
    "count": 19,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 11934,
            "text": "Первый квест от которого я оказался в восторге…"
        },
        {
            "id": 11943,
            "text": "ВОтрыв башки!"
        },
        ...
    ]
}

Ответ 404ПоказатьСкрыть
Нет объекта с таким id

События дня Поиск

События дня

Событие дня - мероприятие, которое редакция выбирает на отдельный день.

Список событий дня

Получение списка событий дня

GET

/public-api/{version}/events-of-the-day/{?lang,fields,expand,order_by,text_format,location,date}

Пример запроса
GET https://kudago.com/public-api/v1.4/events-of-the-day/?lang=&fields=&expand=&text_format=&location=&date=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный) По умолчанию: date,event,location
включить в выдачу только указанные поля, можно несколько через запятую
```
date - дата, на которую назначено событие дня
object - объект, на который ссылается событие дня
location - город, для которого назначено событие дня
title - переопределение заголовка события дня
```
expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: event
text_format
string (необязательный) По умолчанию: html
отдавать поля body_text и description в указанном формате
```
html - текст с тэгами
plain - текст без тегов, ссылки <a href=a_href>a_title</a> преобразуются в вид: a_title a_href
text - текст без тегов, от ссылок остается только название
```
location
string (необязательный)
включить в выдачу события только из указанного города
```
spb - Санкт-Петербург
msk - Москва
nsk - Новосибирск
ekb - Екатеринбург
nnv - Нижний Новгород
kzn - Казань
vbg - Выборг
smr - Самара
krd - Краснодар
sochi - Сочи
ufa - Уфа
krasnoyarsk - Красноярск
kev - Киев
new-york - Нью-Йорк
```
date
date (необязательный)
включить в выдачу только события, назначенные на указанную дату

Запрос Список событий дняПоказатьСкрыть

https://kudago.com/public-api/v1.4/events-of-the-day/

Тело

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "date": "2018-02-02",
      "location": "spb",
      "object": {
        "id": 3263,
        "ctype": "movie"
      },
      "title": ""
    }
  ]
}

Запрос Список событий дня c фильтрамиПоказатьСкрыть

https://kudago.com/public-api/v1.4/events-of-the-day/?date=2016-01-31&location=spb

Тело

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "date": "2016-01-31",
      "location": "spb",
      "object": {
        "id": 105802,
        "ctype": "event"
      },
      "title": ""
    }
  ]
}

Запрос Список событий дня с детализацией объектаПоказатьСкрыть

https://kudago.com/public-api/v1.4/events/?expand=object

Тело

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "date": "2018-02-02",
      "location": "spb",
      "object": {
        "id": 3263,
        "title": "Бегущий в лабиринте: Лекарство от смерти",
        "favorites_count": 0,
        "comments_count": 0,
        "description": "",
        "item_url": "https://kudago.com/movie/beguschij-v-labirinte-lekarstvo/",
        "disable_comments": false,
        "ctype": "movie",
        "country": "США",
        "year": 2018,
        "running_time": 90,
        "poster": {
          "image": "http://kudago.com/media/images/movie/poster/93/a9/93a90d3bbbb2ef2068487268a0f23ced_1.jpg",
          "source": {
            "link": "",
            "name": ""
          }
        },
        "genres": [
          {
            "id": 4,
            "name": "боевик",
            "slug": "action"
          },
          {
            "id": 5,
            "name": "триллер",
            "slug": "thriller"
          },
          {
            "id": 10,
            "name": "фантастика",
            "slug": "sci-fi"
          }
        ],
        "age_restriction": "16+"
      },
      "title": ""
    }
  ]
}

Новости События

Новости

В этом разделе отдаются новости, которые публикует компания.

Список новостей

Получение списка новостей

GET

/public-api/{version}/news/{?lang,fields,expand,order_by,text_format,ids,location,actual_only}

Пример запроса
GET https://kudago.com/public-api/v1.4/news/?lang=&fields=&expand=&order_by=&text_format=&ids=&location=&actual_only=true

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный) По умолчанию: id,title,slug,publication_date
включить в выдачу только указанные поля, можно несколько через запятую
```
id - идентификатор
publication_date - дата публикации
title - название
slug - слаг
place - место, имеющее отношение к новости
description - описание
body_text - полное описание
images - галерея картинок
site_url - адрес новости на сайте kudago.com
favorites_count - число пользователей, добавивших новость в избранное
comments_count - число комментариев
```
expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: images place
order_by
string (необязательный) По умолчанию: -publication_date
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id publication_date title slug place description body_text favorites_count comments_count
text_format
string (необязательный) По умолчанию: html
отдавать поля body_text и description в указанном формате
```
html - текст с тэгами
plain - текст без тегов, ссылки <a href=a_href>a_title</a> преобразуются в вид: a_title a_href
text - текст без тегов, от ссылок остается только название
```
ids
number (необязательный)
включить выдачу только новости с указанными ID, можно несколько через запятую

tags
string (необязательный)
включить выдачу только новости с указанными слагами тэгов, можно несколько через запятую; если тэг указан со знаком минус, то новости с таким тэгом будут выключены из выдачи

location
string (необязательный)
включить в выдачу новости из указанного города
```
spb - Санкт-Петербург
msk - Москва
nsk - Новосибирск
ekb - Екатеринбург
nnv - Нижний Новгород
kzn - Казань
vbg - Выборг
smr - Самара
krd - Краснодар
sochi - Сочи
ufa - Уфа
krasnoyarsk - Красноярск
kev - Киев
new-york - Нью-Йорк
```
place_id
number (необязательный) Пример: 1
включить в выдачу новости только для указанного места

actual_only
boolean (необязательный) Пример: true
включить в выдачу только актуальные новости

Варианты: true 1

Запрос Список новостейПоказатьСкрыть

https://kudago.com/public-api/v1.2/news/

Тело

{
    "count": 10541,
    "next": "https://kudago.com/public-api/v1.2/news/?page=2",
    "previous": null,
    "results": [
        {
            "id": 10961,
            "publication_date": 1437503435,
            "title": "В Москве проведут чемпионат мира по воркауту",
            "slug": "v-moskve-provedut-chempionat-mira-po-vorkautu221"
        },
        {
            "id": 10979,
            "publication_date": 1437502873,
            "title": "В Гатчине отменили фестиваль «Ночь света — 2015»",
            "slug": "v-gatchine-otmenili-festival-noch-sveta-2015"
        },
        ...
    ]
}

Запрос Список новостей c другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/news/?fields=publication_date,title

Тело

{
    "next": "https://kudago.com/public-api/v1.2/news/?fields=publication_date%2Ctitle&page=2",
    "previous": null,
    "results": [
        {
            "publication_date": 1437503435,
            "title": "В Москве проведут чемпионат мира по воркауту"
        },
        {
            "publication_date": 1437502873,
            "title": "В Гатчине отменили фестиваль «Ночь света — 2015»"
        },
        ...
    ]
}

Запрос Список новостей c фильтрамиПоказатьСкрыть

https://kudago.com/public-api/v1.2/news/?location=spb

Тело

{
    "count": 4341,
    "next": "https://kudago.com/public-api/v1.2/news/?location=spb&page=2",
    "previous": null,
    "results": [
        {
            "id": 10979,
            "publication_date": 1437502873,
            "title": "В Гатчине отменили фестиваль «Ночь света — 2015»",
            "slug": "v-gatchine-otmenili-festival-noch-sveta-2015"
        },
        {
            "id": 10977,
            "publication_date": 1437502417,
            "title": "В Каменноостровском дворце откроются курсы диджеинга",
            "slug": "v-peterburgskoj-akademii-talantov-otkroyutsya-k219"
        },
        ...
    ]
}

Детализация новости

Получение детализации новости

GET

/public-api/{version}/news/{news_id}/{?lang,fields,expand}

Пример запроса
GET https://kudago.com/public-api/v1.4/news/3730/?lang=&fields=&expand=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
news_id
number (обязательный) Пример: 3730
идентификатор новости

fields
string (необязательный)
включить в выдачу только указанные поля, можно несколько через запятую
```
id - идентификатор
publication_date - дата публикации
title - название
slug - слаг
place - место, имеющее отношение к новости
description - описание
body_text - полное описание
images - галерея картинок
site_url - адрес новости на сайте kudago.com
favorites_count - число пользователей, добавивших новость в избранное
comments_count - число комментариев
```
expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: images place

Запрос Детализация новостиПоказатьСкрыть

https://kudago.com/public-api/v1.2/news/10979/

Тело

{
  "id": 10979,
  "publication_date": 1437502873,
  "title": "В Гатчине отменили фестиваль «Ночь света — 2015»",
  "slug": "v-gatchine-otmenili-festival-noch-sveta-2015",
  "place": {
    "id": 17645
  },
  "description": "<p>Руководство музея-заповедника «Гатчина» сообщило о том, что праздника света в этом году не будет.</p>\n",
  "body_text": "<p>Анонсированная ранее <a href=\"http://kudago.com/spb/event/sveto-pirotehnicheskoe-shou-noch-sveta-v-gatchine/\">«Ночь света в Гатчине — 2015»</a> должна была стать грандиозным зрелищем. Были запланированы мультимедийное лазерное шоу, фейерверки, инсталляции и театрализованная программа. К сожалению, мероприятие отменили.</p>\n<p>В официальной группе руководство музея-заповедника дает следующее объяснение: «Мы решили взять паузу и лучше продумать формат. Надеемся вернуться с обновленным мероприятием в 2016 году».</p>\n<p>Информацию, появившуюся до этого в интернете, в музее прокомментировали так: «Обращаем ваше внимание на то, что все анонсы фестиваля этого года в сети Интернет размещены без согласования с музеем-заповедником \"Гатчина\"».</p>\n",
  "images": [
    {
      "image": "http://kudago.com/media/images/news/a9/0e/a90ed21e406357e0ff12e1128c775b9b.jpg"
    }
  ],
  "site_url": "http://kudago.com/spb/news/v-gatchine-otmenili-festival-noch-sveta-2015/",
  "favorites_count": 0,
  "comments_count": 0
}

Запрос Детализация новости c другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/news/10979/?fields=favorites_count,slug

Тело

{
  "slug": "v-gatchine-otmenili-festival-noch-sveta-2015",
  "favorites_count": 0
}

Запрос Детализация новости c детализацией места и картинокПоказатьСкрыть

https://kudago.com/public-api/v1.2/news/10979/?expand=place,images

Тело

{
  "id": 10979,
  "publication_date": 1437502873,
  "title": "В Гатчине отменили фестиваль «Ночь света — 2015»",
  "slug": "v-gatchine-otmenili-festival-noch-sveta-2015",
  "place": {
    "id": 17645,
    "title": "Музей-заповедник «Гатчина»",
    "slug": "muzej-zapovednik-gatchina",
    "address": "г. Гатчина, просп. Красноармейский, д.1",
    "site_url": "http://kudago.com/spb/place/muzej-zapovednik-gatchina/",
    "is_closed": false,
    "location": "spb"
  },
  "description": "<p>Руководство музея-заповедника «Гатчина» сообщило о том, что праздника света в этом году не будет.</p>\n",
  "body_text": "<p>Анонсированная ранее <a href=\"http://kudago.com/spb/event/sveto-pirotehnicheskoe-shou-noch-sveta-v-gatchine/\">«Ночь света в Гатчине — 2015»</a> должна была стать грандиозным зрелищем. Были запланированы мультимедийное лазерное шоу, фейерверки, инсталляции и театрализованная программа. К сожалению, мероприятие отменили.</p>\n<p>В официальной группе руководство музея-заповедника дает следующее объяснение: «Мы решили взять паузу и лучше продумать формат. Надеемся вернуться с обновленным мероприятием в 2016 году».</p>\n<p>Информацию, появившуюся до этого в интернете, в музее прокомментировали так: «Обращаем ваше внимание на то, что все анонсы фестиваля этого года в сети Интернет размещены без согласования с музеем-заповедником \"Гатчина\"».</p>\n",
  "images": [
    {
      "image": "http://kudago.com/media/images/news/a9/0e/a90ed21e406357e0ff12e1128c775b9b.jpg",
      "thumbnails": {
        "144x96": "http://kudago.com/media/thumbs/144x96/images/news/a9/0e/a90ed21e406357e0ff12e1128c775b9b.jpg",
        "640x384": "http://kudago.com/media/thumbs/640x384/images/news/a9/0e/a90ed21e406357e0ff12e1128c775b9b.jpg"
      }
    }
  ],
  "site_url": "http://kudago.com/spb/news/v-gatchine-otmenili-festival-noch-sveta-2015/",
  "favorites_count": 0,
  "comments_count": 0
}

Ответ 404ПоказатьСкрыть
Нет объекта с таким id

Комментарии к новости

Получение комментариев к новости

GET

/public-api/{version}/news/{news_id}/comments/{?lang,fields,order_by,ids}

Пример запроса
GET https://kudago.com/public-api/v1.4/news/3730/comments/?lang=&fields=&order_by=&ids=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
news_id
number (обязательный) Пример: 3730
идентификатор новости

page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный)
включить в выдачу только указанные поля, можно несколько через запятую

Варианты: id date_posted text user is_deleted replies_count thread reply_to
order_by
string (необязательный) По умолчанию: date_posted
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id date_posted text user is_deleted replies_count thread reply_to
ids
number (необязательный)
включить выдачу только комментарии с указанными ID, можно несколько через запятую

Запрос Список комментариев к новостиПоказатьСкрыть

https://kudago.com/public-api/v1.2/news/10942/comments/

Тело

{
    "count": 3,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 123,
            "date_posted": 1437475254,
            "text": "Когда планируется открытие?",
            "user": {
                "display_name": "some",
                "avatar": "http://kudago.com/media/images/user/46/69/4669.jpg"
            },
            "is_deleted": false,
            "replies_count": 1,
            "thread": null,
            "reply_to": null
        },
        ...
    ]
}

Запрос Список комментариев к новости c другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/news/10942/comments/?fields=text,id

Тело

{
    "count": 3,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 123,
            "text": "so text"
        },
        {
            "id": 321,
            "text": "very text"
        },
        ...
    ]
}

Ответ 404ПоказатьСкрыть
Нет объекта с таким id

Подборки События дня

Подборки

Подборки - это списки объектов, отобранных редакцией. Объекты могут быть самые разные - события, места, фильмы и т.д. Тип объекта и его идентификатор находятся в полях ctype и id соответственно.

Список подборок

Получение списка подборок

GET

/public-api/{version}/lists/{?lang,fields,expand,order_by,text_format,ids,location}

Пример запроса
GET https://kudago.com/public-api/v1.4/lists/?lang=&fields=&expand=&order_by=&text_format=&ids=&location=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный) По умолчанию: id,slug,title,publication_date,site_url
включить в выдачу только указанные поля, можно несколько через запятую
```
id - идентификатор
publication_date - дата публикации
title - название
slug - слаг
site_url - адрес подборки на сайте kudago.com
```
expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: images
order_by
string (необязательный) По умолчанию: -publication_date
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id publication_date title slug
text_format
string (необязательный) По умолчанию: html
отдавать поля body_text и description в указанном формате
```
html - текст с тэгами
plain - текст без тегов, ссылки <a href=a_href>a_title</a> преобразуются в вид: a_title a_href
text - текст без тегов, от ссылок остается только название
```
ids
number (необязательный)
включить выдачу только подборки с указанными ID, можно несколько через запятую

tags
string (необязательный)
включить выдачу только подборки с указанными слагами тэгов, можно несколько через запятую; если тэг указан со знаком минус, то подборки с таким тэгом будут выключены из выдачи

location
string (необязательный)
город подборки
```
spb - Санкт-Петербург
msk - Москва
nsk - Новосибирск
ekb - Екатеринбург
nnv - Нижний Новгород
kzn - Казань
vbg - Выборг
smr - Самара
krd - Краснодар
sochi - Сочи
ufa - Уфа
krasnoyarsk - Красноярск
kev - Киев
new-york - Нью-Йорк
```

Запрос Список подборокПоказатьСкрыть

https://kudago.com/public-api/v1.2/lists/

Тело

{
    "count": 1633,
    "next": "https://kudago.com/public-api/v1.2/lists/?page=2",
    "previous": null,
    "results": [
        {
            "id": 4768,
            "publication_date": 1447149364,
            "title": "Семь способов порадовать родителей",
            "slug": "sem-sposobov-poradovat-roditelej-nsk",
            "site_url": "http://kudago.com/spb/list/sem-sposobov-poradovat-roditelej-nsk/"
        },
        ...
    ]
}

Запрос Список подборок c другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/lists/?fields=publication_date,id

Тело

{
    "count": 3870,
    "next": "https://kudago.com/public-api/v1.2/lists/?fields=publication_date%2Cid&page=2",
    "previous": null,
    "results": [
        {
            "id": 4167,
            "publication_date": 1437494590
        },
        {
            "id": 4147,
            "publication_date": 1437493933
        },
        ...
    ]
}

Запрос Список подборок c фильтрамиПоказатьСкрыть

https://kudago.com/public-api/v1.2/lists/?location=spb

Тело

{
    "count": 328,
    "next": "https://kudago.com/public-api/v1.2/lists/?location=spb&page=2",
    "previous": null,
    "results": [
        {
            "id": 4768,
            "publication_date": 1447149364,
            "title": "Семь способов порадовать родителей",
            "slug": "sem-sposobov-poradovat-roditelej-nsk",
            "site_url": "http://kudago.com/spb/list/sem-sposobov-poradovat-roditelej-nsk/"
        },
        ...
    ]
}

Детализация подборки

Получение детализации подборки

GET

/public-api/{version}/lists/{list_id}/{?lang,fields,expand}

Пример запроса
GET https://kudago.com/public-api/v1.4/lists/1023/?lang=&fields=&expand=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
list_id
number (обязательный) Пример: 1023
идентификатор подборки

fields
string (необязательный)
включить в выдачу только указанные поля, можно несколько через запятую
```
id - идентификатор
publication_date - дата публикации
title - название
slug - слаг
site_url - адрес подборки на сайте kudago.com
```
expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: images

Запрос Детализация подборкиПоказатьСкрыть

https://kudago.com/public-api/v1.2/lists/4058/

Тело

{
    "id": 4058,
    "ctype": "list",
    "publication_date": 1436354951,
    "title": "Выходные от KudaGo: фестиваль «Усадьба Jazz-2015», выставка «Дали – Живые полотна» и ещё 18 главных событий!",
    "items": [
        {
            "id": 81156,
            "title": "фестиваль «Усадьба Jazz-2015»",
            "favorites_count": 32,
            "comments_count": 0,
            "description": "<p>В самой середине лета на <a href=\"http://kudago.com/spb/place/elagin-ostrov1/\">Елагином острове</a> в четвёртый раз пройдёт многоформатный праздник музыки и хорошего настроения.</p>\n",
            "ctype": "event",
            "place": {
                "id": 1398
            },
            "daterange": null
        },
        ...
    ],
    "favorites_count": 0,
    "comments_count": 0,
    "images": [
        {
            "image": "http://kudago.com/media/images/list/16/85/1685c607f7eee3f70647281c2f5ebc9a.jpg"
        },
        ...
    ],
    "description": "<p>Лето в самом разгаре — и в Санкт-Петербурге жизнь кипит! На город обрушатся супер-насыщенные выходные: никто не останется скучать в одиночестве. Будем слушать самый лучший и душевный джаз, весело обольём друг друга водой, продегустируем летние десерты, отдохнём не фестивале красок с королевским размахом, посмотрим милые короткометражки и от души посмеёмся над проделками неунывающих миньонов! Все лучшие события выходных смотрите в специальном дайджесте от KudaGo!</p>\n",
    "body_text": "",
    "site_url": "http://kudago.com/spb/list/vyhodnye-ot-kudago-10-11-12-iyulya-spb/"
}

Запрос Детализация подборки c другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/lists/4058/?fields=ctype,publication_date

Тело

{
  "slug": "v-gatchine-otmenili-festival-noch-sveta-2015",
  "favorites_count": 0
}

Запрос Детализация подборки c детализацией картинокПоказатьСкрыть

https://kudago.com/public-api/v1.2/lists/4058/?expand=images

Тело

{
    "id": 4058,
    "ctype": "list",
    "publication_date": 1436354951,
    "title": "Выходные от KudaGo: фестиваль «Усадьба Jazz-2015», выставка «Дали – Живые полотна» и ещё 18 главных событий!",
    "items": [
        {
            "id": 81156,
            "title": "фестиваль «Усадьба Jazz-2015»",
            "favorites_count": 32,
            "comments_count": 0,
            "description": "<p>В самой середине лета на <a href=\"http://kudago.com/spb/place/elagin-ostrov1/\">Елагином острове</a> в четвёртый раз пройдёт многоформатный праздник музыки и хорошего настроения.</p>\n",
            "ctype": "event",
            "place": {
                "id": 1398
            },
            "daterange": null
        },
        ...
    ],
    "favorites_count": 0,
    "comments_count": 0,
    "images": [
        {
            "image": "http://kudago.com/media/images/list/16/85/1685c607f7eee3f70647281c2f5ebc9a.jpg",
            "thumbnails": {
                "144x96": "http://kudago.com/media/thumbs/144x96/images/list/16/85/1685c607f7eee3f70647281c2f5ebc9a.jpg",
                "640x384": "http://kudago.com/media/thumbs/640x384/images/list/16/85/1685c607f7eee3f70647281c2f5ebc9a.jpg"
            }
        },
        ...
    ],
    "description": "<p>Лето в самом разгаре — и в Санкт-Петербурге жизнь кипит! На город обрушатся супер-насыщенные выходные: никто не останется скучать в одиночестве. Будем слушать самый лучший и душевный джаз, весело обольём друг друга водой, продегустируем летние десерты, отдохнём не фестивале красок с королевским размахом, посмотрим милые короткометражки и от души посмеёмся над проделками неунывающих миньонов! Все лучшие события выходных смотрите в специальном дайджесте от KudaGo!</p>\n",
    "body_text": "",
    "site_url": "http://kudago.com/spb/list/vyhodnye-ot-kudago-10-11-12-iyulya-spb/"
}

Ответ 404ПоказатьСкрыть
Нет объекта с таким id

Комментарии к подборке

Получение списка комментариев

GET

/public-api/{version}/lists/{list_id}/comments/{?lang,fields,order_by,ids}

Пример запроса
GET https://kudago.com/public-api/v1.4/lists/1023/comments/?lang=&fields=&order_by=&ids=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
list_id
number (обязательный) Пример: 1023
идентификатор подборки

page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный)
включить в выдачу только указанные поля, можно несколько через запятую

Варианты: id date_posted text user is_deleted replies_count thread reply_to
order_by
string (необязательный) По умолчанию: date_posted
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id date_posted text user is_deleted replies_count thread reply_to
ids
number (необязательный)
включить выдачу только комментарии с указанными ID, можно несколько через запятую

Запрос Список комментариев к подборкеПоказатьСкрыть

https://kudago.com/public-api/v1.2/lists/4103/comments/

Тело

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 20548,
      "date_posted": 1437468235,
      "text": "Фестиваль \"Морские дьяволы\" перенесен на 05 сентября, из-за жеребьевки по футболу на 2018 год",
      "user": {
        "display_name": "some name",
        "avatar": "http://kudago.com/media/images/user/c3/2c/c32c.jpg"
      },
      "is_deleted": false,
      "replies_count": 0,
      "thread": null,
      "reply_to": null
    }
  ]
}

Запрос Список комментариев к подборке c другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/lists/4103/comments/?fields=text,id

Тело

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 20548,
      "text": "Фестиваль \"Морские дьяволы\" перенесен на 05 сентября, из-за жеребьевки по футболу на 2018 год"
    }
  ]
}

Ответ 404ПоказатьСкрыть
Нет объекта с таким id

Места Новости

Места

Места - это список мест, для которых компания публикует информацию. Это могут быть музеи, клубы и т.д. Фильтр has_showings работает только со значением movie, зато позволяет использовать фильтры showing_since и showing_until Фильтры lon, lat и radius работают только вместе и позволяют устраивать фильтрацию по местам вокруг данной географической точки

Список мест

Получение списка мест

GET

/public-api/{version}/places/{?lang,fields,expand,order_by,text_format,ids,location,has_showings,showing_since,showing_until,categories,lon,lat,radius}

Пример запроса
GET https://kudago.com/public-api/v1.4/places/?lang=&fields=&expand=&order_by=&text_format=&ids=&location=&has_showings=&showing_since=1444385206&showing_until=1444385206&categories=airports,-anticafe&lon=&lat=&radius=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный) По умолчанию: id,title,slug,address,location,site_url,is_closed
включить в выдачу только указанные поля, можно несколько через запятую
```
id - идентификатор
title - название
short_title - короткое название
slug - слаг
address - адрес
location - город
timetable - расписание
phone - телефон
is_stub - является ли заглушкой
images - галерея места
description - описание
body_text - полное описание
site_url - адрес места на сайте kudago.com
foreign_url - сайт места
coords - координаты места
subway - метро рядом
favorites_count - число пользователей, добавивших место в избранное
comments_count - число комментариев
is_closed - закрыто ли место
categories - список категорий
tags - тэги места
```
expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: images
order_by
string (необязательный) По умолчанию: -rank,-id
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id title slug address phone is_stub body_text description foreign_url subway favorites_count comments_count is_closed short_title location
text_format
string (необязательный) По умолчанию: html
отдавать поля body_text и description в указанном формате
```
html - текст с тэгами
plain - текст без тегов, ссылки <a href=a_href>a_title</a> преобразуются в вид: a_title a_href
text - текст без тегов, от ссылок остается только название
```
ids
number (необязательный)
включить выдачу только места с указанными ID, можно несколько через запятую

location
string (необязательный)
включить в выдачу только места в указанном городе
```
spb - Санкт-Петербург
msk - Москва
nsk - Новосибирск
ekb - Екатеринбург
nnv - Нижний Новгород
kzn - Казань
vbg - Выборг
smr - Самара
krd - Краснодар
sochi - Сочи
ufa - Уфа
krasnoyarsk - Красноярск
kev - Киев
new-york - Нью-Йорк
```
has_showings
string (необязательный)
включить в выдачу только те места, в которых проходят показы указанного типа

Варианты: movie
showing_since
number or string (необязательный) Пример: 1444385206
включить в выдачу только те места, в которых проходили показы после указанного момента времени (в формате UNIX timestamp или ISO 8601, в любом случае время считается в UTC)

showing_until
number or string (необязательный) Пример: 1444385206
включить в выдачу только те места, в которых проходили показы до указанного момента времени (в формате UNIX timestamp или ISO 8601, в любом случае время считается в UTC)

is_free
number (необязательный)
включить в выдачу только места с бесплатными событиями

Варианты: 1 0 true false
categories
string (необязательный) Пример: airports,-anticafe
включить в выдачу только места, относящиеся к указанным категориям (см. Категории мест), можно несколько через запятую; если категория указана со знаком минус, то места с такой категорией будут выключены из выдачи

tags
string (необязательный)
включить выдачу только места с указанными слагами тэгов, можно несколько через запятую; если тэг указан со знаком минус, то места с таким тэгом будут выключены из выдачи

parent_id
number (необязательный) Пример: 1
включить в выдачу места, дочерние к указанному месту

lon
number (необязательный)
lat
number (необязательный)
radius
number (необязательный)
lat, lon и radius вместе фильтруют места вокруг указанных координат; радиус указывается в метрах

Запрос Список местПоказатьСкрыть

https://kudago.com/public-api/v1.2/places/

Тело

{
    "count": 16228,
    "next": "https://kudago.com/public-api/v1.2/places/?page=2",
    "previous": null,
    "results": [
        {
            "id": 531,
            "title": "музей-заповедник «Царицыно»",
            "slug": "caricyno",
            "address": "ул. Дольская, д. 1",
            "phone": "+7 499 725-72-87",
            "site_url": "https://kudago.com/msk/place/caricyno/",
            "subway": "Царицыно, Орехово",
            "is_closed": false,
            "location": "msk",
            "has_parking_lot": false
        },
        ...
    ]
}

Запрос Список мест с другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/places/?fields=id,slug

Тело

{
    "count": 14416,
    "next": "https://kudago.com/public-api/v1.2/places/?fields=id%2Cslug&page=2",
    "previous": null,
    "results": [
        {
            "id": 2215,
            "slug": "cleverclub"
        },
        ...
    ]
}

Запрос Список мест с фильтрамиПоказатьСкрыть

https://kudago.com/public-api/v1.2/places/?fields=id,categories,title&location=spb&categories=attract,cinema,museums&lon=37.6&lat=55.7&radius=900000&has_showings=movie&showing_since=1000000000&showing_until=2000000000

Тело

{
    "count": 25,
    "next": "https://kudago.com/public-api/v1.2/places/?categories=attract%2Ccinema%2Cmuseums&has_showings=movie&lat=55.7&location=spb&lon=37.6&page=2&radius=900000&showing_since=1000000000&showing_until=2000000000",
    "previous": null,
    "results": [
        {
            "id": 14936,
            "title": "кинотеатр «Kinostar Дыбенко»",
            "slug": "kinoteatr-kinostar-dybenko",
            "address": "Мурманское шоссе, 12-й км",
            "location": "spb",
            "site_url": "http://kudago.com/spb/place/kinoteatr-kinostar-dybenko/",
            "is_closed": false
        },
        ...
    ]
}

Ответ 400ПоказатьСкрыть

Тело

- _has_showings_ имеет значение, отличное от _movie_
- _categories_ имеет недопустимое значение (нет среди списка категорий мест)
- указана лишь часть параметров из тройки (_radius_, _lat_, _lon_)
- недопустимые значения в тройке (_radius_, _lat_, _lon_)

Детализация места

Получение детализации места

GET

/public-api/{version}/places/{place_id}/{?lang,fields,expand}

Пример запроса
GET https://kudago.com/public-api/v1.4/places/12271/?lang=&fields=&expand=

Параметры

version

string (обязательный) Пример: v1.4

версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4

lang

string (необязательный) По умолчанию: ru

язык ответа

Варианты: ru en

place_id

number (обязательный) Пример: 12271

идентификатор места

fields

string (необязательный)

включить в выдачу только указанные поля, можно несколько через запятую

id - идентификатор
title - название
short_title - короткое название
slug - слаг
address - адрес
location - город
timetable - расписание
phone - телефон
is_stub - является ли заглушкой
images - галерея места
description - описание
body_text - полное описание
site_url - адрес места на сайте kudago.com
foreign_url - сайт места
coords - координаты места
subway - метро рядом
favorites_count - число пользователей, добавивших место в избранное
comments_count - число комментариев
is_closed - закрыто ли место
categories - список категорий
tags - тэги места

expand

string (необязательный)

включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: images

Запрос Детализация местаПоказатьСкрыть

https://kudago.com/public-api/v1.2/places/531/

Тело

{
    "id": 531,
    "title": "музей-заповедник «Царицыно»",
    "slug": "caricyno",
    "address": "ул. Дольская, д. 1",
    "timetable": "вт–пт 11:00–18:00, сб 11:00–20:00, вс 11:00–19:00",
    "phone": "+7 499 725-72-87",
    "is_stub": false,
    "body_text": "<p>В восемнадцатом веке по указу императрицы Екатерины II был заложен <strong>парк Царицыно</strong>. Предполагалось, что это будет летняя императорская резиденция, которая заменит усадьбу Коломенское, порядком наскучившую императрице.</p>\n<p>Дворцовый комплекс строился много лет.  Первый дворец, построенный архитектором Василием Баженовым, не понравился Екатерине, поэтому был снесен. На его месте архитектор Матвей Казаков возвел новое здание, которое и сохранилось до наших дней.</p>\n<p>Дворцовый комплекс парка является образцом русской готики в архитектуре, он не имеет себе равных в России. Сам парк Царицыно расположен в холмистой местности, имеет каскад прудов. Для создания английских садов в императорской резиденции был выписан из Англии один из лучших садовников того времени Фрэнсис Рид.</p>\n<p>Но Екатерина II умерла раньше, чем закончились работы над созданием дворцов и садов Царицыно. Кроме неё некому было заниматься этой резиденцией. Сады стали быстро зарастать, дома ветшали. В девятнадцатом веке парк был открыт для гуляний, в оранжереях, которые были заложены еще при Екатерине, выращивали и продавали экзотические фрукты.</p>\n<p>С 1860 года парк и многие его постройки стали дачами. Там отдыхали многие известные писатели: Достоевский, Тютчев, Чехов, Плещеев, именно здесь Бунин познакомился со своей будущей женой. В свое время бывали здесь Чайковский, Тимирязев и многие другие видные деятели культуры и науки.\nС 1927 года в зданиях Царицыно располагались различные музеи, а в 1993 г. он получил статус музея-заповедника.</p>\n<p>Активно восстанавливать бывший императорский дворец начали только в 2004 году.</p>\n<p>Сегодня это большой парк, куда приезжают гулять не только жители окрестных районов Москвы. На входе на территорию музея-заповедника гостей встречает <strong>музыкальный фонтан</strong>, подойти к которому можно по двум изящным мостикам. При подъезде к дворцам появляются стилизованные крепостные ворота с башнями.\nВ Оперном доме, который строился как место проведения торжественных приемов и балов, теперь проходят концерты классической музыки, различные официальные мероприятия. На тропинках сегодня можно встретить белочек, которые охотно лакомятся орешками.</p>\n<p>Во дворце и на территории парка регулярно проходят экскурсии как для взрослых, так и для детей. Здесь можно познакомиться с особенностями быта и моды разных веков. Действует несколько постоянных экспозиций, посвященных истории Царицыно и правлению Екатерины II, проходят временные выставки, которые знакомят посетителей с современной живописью и декоративно-прикладным искусством.</p>\n<p>Также на территории парка располагается единственный в Москве оранжерейный комплекс, использующийся по назначению — здесь до сих пор выращивают растения тех же видов, что и в XVIII веке.</p>\n<p>Летом здесь можно покататься на сегвеях, совершить поездку на электромобиле, переплыть пруд на лодке и примерить исторические костюмы. В парке проходят различные квесты.</p>\n<p>Каждое третье воскресенье месяца все музеи Царицыно можно посещать бесплатно.</p>\n",
    "description": "<p>Царские дворцы в стиле русской готики, чистые пруды... Парк, так и не ставший императорской резиденцией, сегодня открыт для всех, кто хочет найти уголок спокойствия в шумной столице.</p>\n",
    "site_url": "https://kudago.com/msk/place/caricyno/",
    "foreign_url": "http://www.tsaritsyno-museum.ru/",
    "coords": {
        "lat": 55.61662499999999,
        "lon": 37.68393099999999
    },
    "subway": "Царицыно, Орехово",
    "favorites_count": 409,
    "images": [
        {
            "image": "https://kudago.com/media/images/place/41/3d/413d20fbf3a0cab1f8a99feedc893a9c.jpg",
            "source": {
                "link": "http://www.tsaritsyno-museum.ru/ru/progulki/boldvorec/",
                "name": "Музей-заповедник «Царицыно»"
            }
        },
        ..
    ],
    "comments_count": 0,
    "is_closed": false,
    "categories": [
        "palace",
        "kids",
        "museums"
    ],
    "short_title": "",
    "tags": [
        "дворцы",
        "юао",
        "музеи (раздел музеи, выставки)",
        "детские места (раздел детям)",
        "белки"
    ],
    "location": "msk",
    "age_restriction": "0+",
    "disable_comments": false,
    "has_parking_lot": false
}

Запрос Детализация места с другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/places/531/?fields=address,phone

Тело

{
  "address": "ул. Дольская, д. 1",
  "phone": "+7 499 725-72-87"
}

Запрос Детализация места с детализацией картинокПоказатьСкрыть

https://kudago.com/public-api/v1.2/places/531/?expand=images

Тело

{
    "id": 531,
    "title": "музей-заповедник «Царицыно»",
    "slug": "caricyno",
    "address": "ул. Дольская, д. 1",
    "timetable": "вт–пт 11:00–18:00, сб 11:00–20:00, вс 11:00–19:00",
    "phone": "+7 499 725-72-87",
    "is_stub": false,
    "body_text": "<p>В восемнадцатом веке по указу императрицы Екатерины II был заложен <strong>парк Царицыно</strong>. Предполагалось, что это будет летняя императорская резиденция, которая заменит усадьбу Коломенское, порядком наскучившую императрице.</p>\n<p>Дворцовый комплекс строился много лет.  Первый дворец, построенный архитектором Василием Баженовым, не понравился Екатерине, поэтому был снесен. На его месте архитектор Матвей Казаков возвел новое здание, которое и сохранилось до наших дней.</p>\n<p>Дворцовый комплекс парка является образцом русской готики в архитектуре, он не имеет себе равных в России. Сам парк Царицыно расположен в холмистой местности, имеет каскад прудов. Для создания английских садов в императорской резиденции был выписан из Англии один из лучших садовников того времени Фрэнсис Рид.</p>\n<p>Но Екатерина II умерла раньше, чем закончились работы над созданием дворцов и садов Царицыно. Кроме неё некому было заниматься этой резиденцией. Сады стали быстро зарастать, дома ветшали. В девятнадцатом веке парк был открыт для гуляний, в оранжереях, которые были заложены еще при Екатерине, выращивали и продавали экзотические фрукты.</p>\n<p>С 1860 года парк и многие его постройки стали дачами. Там отдыхали многие известные писатели: Достоевский, Тютчев, Чехов, Плещеев, именно здесь Бунин познакомился со своей будущей женой. В свое время бывали здесь Чайковский, Тимирязев и многие другие видные деятели культуры и науки.\nС 1927 года в зданиях Царицыно располагались различные музеи, а в 1993 г. он получил статус музея-заповедника.</p>\n<p>Активно восстанавливать бывший императорский дворец начали только в 2004 году.</p>\n<p>Сегодня это большой парк, куда приезжают гулять не только жители окрестных районов Москвы. На входе на территорию музея-заповедника гостей встречает <strong>музыкальный фонтан</strong>, подойти к которому можно по двум изящным мостикам. При подъезде к дворцам появляются стилизованные крепостные ворота с башнями.\nВ Оперном доме, который строился как место проведения торжественных приемов и балов, теперь проходят концерты классической музыки, различные официальные мероприятия. На тропинках сегодня можно встретить белочек, которые охотно лакомятся орешками.</p>\n<p>Во дворце и на территории парка регулярно проходят экскурсии как для взрослых, так и для детей. Здесь можно познакомиться с особенностями быта и моды разных веков. Действует несколько постоянных экспозиций, посвященных истории Царицыно и правлению Екатерины II, проходят временные выставки, которые знакомят посетителей с современной живописью и декоративно-прикладным искусством.</p>\n<p>Также на территории парка располагается единственный в Москве оранжерейный комплекс, использующийся по назначению — здесь до сих пор выращивают растения тех же видов, что и в XVIII веке.</p>\n<p>Летом здесь можно покататься на сегвеях, совершить поездку на электромобиле, переплыть пруд на лодке и примерить исторические костюмы. В парке проходят различные квесты.</p>\n<p>Каждое третье воскресенье месяца все музеи Царицыно можно посещать бесплатно.</p>\n",
    "description": "<p>Царские дворцы в стиле русской готики, чистые пруды... Парк, так и не ставший императорской резиденцией, сегодня открыт для всех, кто хочет найти уголок спокойствия в шумной столице.</p>\n",
    "site_url": "https://kudago.com/msk/place/caricyno/",
    "foreign_url": "http://www.tsaritsyno-museum.ru/",
    "coords": {
        "lat": 55.61662499999999,
        "lon": 37.68393099999999
    },
    "subway": "Царицыно, Орехово",
    "favorites_count": 409,
    "images": [
        {
            "image": "https://kudago.com/media/images/place/41/3d/413d20fbf3a0cab1f8a99feedc893a9c.jpg",
            "thumbnails": {
                "144x96": "https://kudago.com/media/thumbs/144x96/images/place/41/3d/413d20fbf3a0cab1f8a99feedc893a9c.jpg",
                "640x384": "https://kudago.com/media/thumbs/640x384/images/place/41/3d/413d20fbf3a0cab1f8a99feedc893a9c.jpg"
            },
            "source": {
                "link": "http://www.tsaritsyno-museum.ru/ru/progulki/boldvorec/",
                "name": "Музей-заповедник «Царицыно»"
            }
        },
        ...
    ],
    "comments_count": 0,
    "is_closed": false,
    "categories": [
        "palace",
        "kids",
        "museums"
    ],
    "short_title": "",
    "tags": [
        "дворцы",
        "юао",
        "музеи (раздел музеи, выставки)",
        "детские места (раздел детям)",
        "белки"
    ],
    "location": "msk",
    "age_restriction": "0+",
    "disable_comments": false,
    "has_parking_lot": false
}

Ответ 404ПоказатьСкрыть
Нет места с таким id

Комментарии к месту

Получение комментариев к месту

GET

/public-api/{version}/places/{place_id}/comments/{?lang,fields,order_by,ids}

Пример запроса
GET https://kudago.com/public-api/v1.4/places/12271/comments/?lang=&fields=&order_by=&ids=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
place_id
number (обязательный) Пример: 12271
идентификатор места

page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный)
включить в выдачу только указанные поля, можно несколько через запятую

Варианты: id date_posted text user is_deleted replies_count thread reply_to
order_by
string (необязательный) По умолчанию: date_posted
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id date_posted text user is_deleted replies_count thread reply_to
ids
number (необязательный)
включить выдачу только комментарии с указанными ID, можно несколько через запятую

Запрос Список комментариев к местуПоказатьСкрыть

https://kudago.com/public-api/v1.2/places/2215/comments/

Тело

{
    "count": 19,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 6913,
            "date_posted": 1410258492,
            "text": "Офигенное место, очень приятная атмосфера и држелюбный персонал. А во многих Антикафешках была, но тут как-то по-другому. Особенно хорошо. И есть много интересных фишек, которых нет в других местах.НапримерррррррЫ:\r\n- Ночью в антикафе, приходишь на всю ночь и отдыхааешь с компанией.Обычно кафешки ночью спят\r\n- Можно зарядить свой мобильный ООО. Это вообще волшебно и особенно актуально\r\n- Не знаю как правильно называется  шлем виртуальности кажется. Вот это вообще вещь, пока не попробуешь не поймешь!\r\n- Можно распечатать нужный документ\r\n- и Офигенный просто КОФЕ))))",
            "user": {
                "display_name": "some name",
                "avatar": "http://kudago.com/media/images/user/98/bb/98bbd.jpg"
            },
            "is_deleted": false,
            "replies_count": 0,
            "thread": null,
            "reply_to": null
        },
        ...
    ]
}

Запрос Список комментариев к месту с другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/places/2215/comments/?fields=text,id

Тело

{
    "count": 19,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 6913,
            "text": "Офигенное место, очень приятная атмосфера и држелюбный персонал. А во многих Антикафешках была, но тут как-то по-другому. Особенно хорошо. И есть много интересных фишек, которых нет в других местах.НапримерррррррЫ:\r\n- Ночью в антикафе, приходишь на всю ночь и отдыхааешь с компанией.Обычно кафешки ночью спят\r\n- Можно зарядить свой мобильный ООО. Это вообще волшебно и особенно актуально\r\n- Не знаю как правильно называется  шлем виртуальности кажется. Вот это вообще вещь, пока не попробуешь не поймешь!\r\n- Можно распечатать нужный документ\r\n- и Офигенный просто КОФЕ))))"
        },
        ...
    ]
}

Ответ 404ПоказатьСкрыть
Нет места с таким id

Фильмы Подборки

Фильмы

Список фильмов, о которых компания публикует информацию.

Список фильмов

Получение списка фильмов

GET

/public-api/{version}/movies/{?lang,fields,expand,order_by,text_format,ids,location,premiering_in_location,place,actual_since,actual_until}

Пример запроса
GET https://kudago.com/public-api/v1.4/movies/?lang=&fields=&expand=&order_by=&text_format=&ids=&location=&premiering_in_location=&actual_since=1444385206&actual_until=1444385406

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный) По умолчанию: id,title,poster
включить в выдачу только указанные поля, можно несколько через запятую
```
id - идентификатор
site_url - адрес фильма на сайте kudago.com
publication_date - дата публикации
slug - слаг
title - название
description - описание
body_text - полное описание
is_editors_choice - является ли выбоором редакции
favorites_count - число пользователей, добавивших фильм в избранное
genres - список жанров
comments_count - число комментариев
original_title - оригинальное название
locale - язык оригинала
country - страна оригинала
year - год выпуска
language - язык оригинала
running_time - продолжительность
budget_currency - бюджет (валюта)
budget - бюджет
mpaa_rating - рейтинг MPAA
age_restriction - возрастное ограничение
stars - актеры
director - режиссер
writer - сценарист
awards - награды
trailer - трейлер
images - галерея картинок
poster - постер
url - сайт фильма
imdb_url - ссылка на страницу фильма на imdb.com
imdb_rating - рейтинг фильма на сайте imdb.com
```
expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: images poster
order_by
string (необязательный) По умолчанию: -rank,-id
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id publication_date slug title description body_text is_editors_choice favorites_count genres comments_count original_title locale country year language running_time budget_currency budget mpaa_rating age_restriction stars director writer awards trailer url imdb_url imdb_rating trailer
text_format
string (необязательный) По умолчанию: html
отдавать поля body_text и description в указанном формате
```
html - текст с тэгами
plain - текст без тегов, ссылки <a href=a_href>a_title</a> преобразуются в вид: a_title a_href
text - текст без тегов, от ссылок остается только название
```
ids
number (необязательный)
включить выдачу только фильмы с указанными ID, можно несколько через запятую

tags
string (необязательный)
включить выдачу только фильмы с указанными слагами тэгов, можно несколько через запятую; если тэг указан со знаком минус, то фильмы с таким тэгом будут выключены из выдачи

location
string (необязательный)
включить в выдачу только те фильмы, у которых есть показы в указанном городе
```
spb - Санкт-Петербург
msk - Москва
nsk - Новосибирск
ekb - Екатеринбург
nnv - Нижний Новгород
kzn - Казань
vbg - Выборг
smr - Самара
krd - Краснодар
sochi - Сочи
ufa - Уфа
krasnoyarsk - Красноярск
kev - Киев
new-york - Нью-Йорк
```
premiering_in_location
string (необязательный)
включить в выдачу только те фильмы, у которых была премьера в указанном городе
```
spb - Санкт-Петербург
msk - Москва
nsk - Новосибирск
ekb - Екатеринбург
nnv - Нижний Новгород
kzn - Казань
vbg - Выборг
smr - Самара
krd - Краснодар
sochi - Сочи
ufa - Уфа
krasnoyarsk - Красноярск
kev - Киев
new-york - Нью-Йорк
```
is_free
number (необязательный)
включить в выдачу только фильмы с бесплатными показами

Варианты: 1 0 true false
place_id
number (необязательный)
включить в выдачу только те фильмы, у которых есть показы в указанном месте

actual_since
number or string (необязательный) Пример: 1444385206
включить в выдачу только те фильмы, у которых есть показы после указанного момента времени (в формате UNIX timestamp или ISO 8601, в любом случае время считается в UTC)

actual_until
number or string (необязательный) Пример: 1444385406
включить в выдачу только те фильмы, у которых есть показы до указанного момента времени (в формате UNIX timestamp или ISO 8601, в любом случае время считается в UTC)

Запрос Список фильмовПоказатьСкрыть

https://kudago.com/public-api/v1.2/movies/

Тело

{
    "count": 1327,
    "next": "https://kudago.com/public-api/v1.2/movies/?page=2",
    "previous": null,
    "results": [
        {
            "id": 1652,
            "title": "007: СПЕКТР",
            "poster": {
                "image": "http://kudago.com/media/images/movie/poster/07/1a/071aa66c94b3ed03434871e11aac593e.jpg"
            }
        },
        ...
    ]
}

Запрос Список фильмов с другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.2/movies/?fields=status,slug

Тело

{
    "count": 1125,
    "next": "https://kudago.com/public-api/v1.2/movies/?fields=status%2Cslug&page=2",
    "previous": null,
    "results": [
        {
            "status": 9,
            "slug": "Uskorenie"
        },
        ...
    ]
}

Запрос Список фильмов с фильтрамиПоказатьСкрыть

https://kudago.com/public-api/v1.2/movies/?location=spb&premiering_in_location=spb&actual_since=1000000000&actual_until=2000000000&place=15361

Тело

{
    "count": 5,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 1442,
            "title": "Ускорение",
            "poster": {
                "image": "http://kudago.com/media/images/movie/poster/c7/27/c7276899f386f5989dc43afa7b18a589.jpg",
            }
        },
        ...
    ]
}

Детализация фильма

Получение детализации фильма

GET

/public-api/{version}/movies/{movie_id}/{?lang,fields,expand}

Пример запроса
GET https://kudago.com/public-api/v1.4/movies/1323/?lang=&fields=&expand=

Параметры

version

string (обязательный) Пример: v1.4

версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4

lang

string (необязательный) По умолчанию: ru

язык ответа

Варианты: ru en

movie_id

number (обязательный) Пример: 1323

идентификатор фильма

fields

string (необязательный)

включить в выдачу только указанные поля, можно несколько через запятую

id - идентификатор
site_url - адрес фильма на сайте kudago.com
publication_date - дата публикации
slug - слаг
title - название
description - описание
body_text - полное описание
is_editors_choice - является ли выбоором редакции
favorites_count - число пользователей, добавивших фильм в избранное
genres - список жанров
comments_count - число комментариев
original_title - оригинальное название
locale - язык оригинала
country - страна оригинала
year - год выпуска
language - язык оригинала
running_time - продолжительность
budget_currency - бюджет (валюта)
budget - бюджет
mpaa_rating - рейтинг MPAA
age_restriction - возрастное ограничение
stars - актеры
director - режиссер
writer - сценарист
awards - награды
trailer - трейлер
images - галерея картинок
poster - постер
url - сайт фильма
imdb_url - ссылка на страницу фильма на imdb.com
imdb_rating - рейтинг фильма на сайте imdb.com

expand

string (необязательный)

включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: images poster

Запрос Детализация фильмаПоказатьСкрыть

https://kudago.com/public-api/v1.2/movies/1441/

Тело

{
    "id": 1441,
    "site_url": "http://kudago.com/movie/bumazhnie-goroda/",
    "publication_date": 1436773492,
    "slug": "bumazhnie-goroda",
    "title": "Бумажные города",
    "description": "",
    "body_text": "<p>Детективная мелодрама режиссера Джейка Шрейера, снятая по мотивам одноименного подроского романа-бестселлера Джона Грина. Сюжет повествует о юноше по имени Кью Джейкобсен, который с ранних лет беззаветно влюблен в свою симпатичную одноклассницу Марго. Когда девушка бесследно исчезает при загадочных обстоятельствах, герой отправляется на ее поиски. Главную роль в фильме исполнила английская топ-модель Кара Делевинь.</p>\n",
    "is_editors_choice": false,
    "favorites_count": 15,
    "genres": [
        {
            "id": 14,
            "name": "детектив",
            "slug": "crime"
        },
        ...
    ],
    "comments_count": 0,
    "original_title": "Paper Towns",
    "locale": "ru",
    "country": "США",
    "year": 2015,
    "language": "английский",
    "running_time": 105,
    "budget_currency": "RUB",
    "budget": 0.0,
    "mpaa_rating": "pg13",
    "age_restriction": "12+",
    "stars": "Кара Делевинь, Нат Вулфф, Халстон Сейдж, Кара Буоно, Кейтлин Карвер, Остин Абрамс, Гриффин Фриман, Джастис Смит, Мег Кросби, Том Хиллманн, Роберт Крейтон, Дрю Мэттьюс",
    "director": "Джейк Шрейер",
    "writer": "Джон Грин, Скотт Нейстадтер, Майкл Х. Уэбер",
    "awards": "",
    "trailer": "http://www.youtube.com/watch?v=yv0Rm7IH3vU",
    "images": [
        {
            "image": "http://kudago.com/media/images/movie/5c/7a/5c7af2a99287e9fafc1ec5a93de832ed.jpg"
        },
        ...
    ],
    "poster": {
        "image": "http://kudago.com/media/images/movie/poster/16/21/16216afa69b2111b66a07549b476cd00.jpg"
    },
    "url": "http://papertownsmovie.com",
    "imdb_url": "http://www.imdb.com/title/tt3622592/",
    "imdb_rating": 6.5
}

Запрос Детализация фильма с другими полямиПоказатьСкрыть

https://kudago.com/public-api/v1.2/movies/1441/?fields=age_restriction,writer

Тело

{
  "age_restriction": "12+",
  "writer": "Джон Грин, Скотт Нейстадтер, Майкл Х. Уэбер"
}

Запрос Детализация фильма с детализацией картинок и постераПоказатьСкрыть

https://kudago.com/public-api/v1.2/movies/1441/?expand=images,poster

Тело

{
    "id": 1441,
    "site_url": "http://kudago.com/movie/bumazhnie-goroda/",
    "publication_date": 1436773492,
    "slug": "bumazhnie-goroda",
    "title": "Бумажные города",
    "description": "",
    "body_text": "<p>Детективная мелодрама режиссера Джейка Шрейера, снятая по мотивам одноименного подроского романа-бестселлера Джона Грина. Сюжет повествует о юноше по имени Кью Джейкобсен, который с ранних лет беззаветно влюблен в свою симпатичную одноклассницу Марго. Когда девушка бесследно исчезает при загадочных обстоятельствах, герой отправляется на ее поиски. Главную роль в фильме исполнила английская топ-модель Кара Делевинь.</p>\n",
    "is_editors_choice": false,
    "favorites_count": 15,
    "genres": [
        {
            "id": 14,
            "name": "детектив",
            "slug": "crime"
        },
        ...
    ],
    "comments_count": 0,
    "original_title": "Paper Towns",
    "locale": "ru",
    "country": "США",
    "year": 2015,
    "language": "английский",
    "running_time": 105,
    "budget_currency": "RUB",
    "budget": 0.0,
    "mpaa_rating": "pg13",
    "age_restriction": "12+",
    "stars": "Кара Делевинь, Нат Вулфф, Халстон Сейдж, Кара Буоно, Кейтлин Карвер, Остин Абрамс, Гриффин Фриман, Джастис Смит, Мег Кросби, Том Хиллманн, Роберт Крейтон, Дрю Мэттьюс",
    "director": "Джейк Шрейер",
    "writer": "Джон Грин, Скотт Нейстадтер, Майкл Х. Уэбер",
    "awards": "",
    "trailer": "http://www.youtube.com/watch?v=yv0Rm7IH3vU",
    "images": [
        {
            "image": "http://kudago.com/media/images/movie/5c/7a/5c7af2a99287e9fafc1ec5a93de832ed.jpg",
            "thumbnails": {
                "144x96": "http://kudago.com/media/thumbs/144x96/images/movie/5c/7a/5c7af2a99287e9fafc1ec5a93de832ed.jpg",
                "640x384": "http://kudago.com/media/thumbs/640x384/images/movie/5c/7a/5c7af2a99287e9fafc1ec5a93de832ed.jpg"
            }
        },
        ...
    ],
    "poster": {
        "image": "http://kudago.com/media/images/movie/poster/16/21/16216afa69b2111b66a07549b476cd00.jpg",
        "thumbnails": {
            "144x96": "http://kudago.com/media/thumbs/144x96/images/movie/poster/16/21/16216afa69b2111b66a07549b476cd00.jpg",
            "640x384": "http://kudago.com/media/thumbs/640x384/images/movie/poster/16/21/16216afa69b2111b66a07549b476cd00.jpg"
        }
    },
    "url": "http://papertownsmovie.com",
    "imdb_url": "http://www.imdb.com/title/tt3622592/",
    "imdb_rating": 6.5
}

Ответ 404ПоказатьСкрыть
Нет объекта с таким id

Список показов фильма

Получение списка показов фильма

GET

/public-api/{version}/movies/{movie_id}/showings/{?lang,fields,expand,order_by,location,actual_since,actual_until,place,is_free}

Пример запроса
GET https://kudago.com/public-api/v1.4/movies/1705/showings/?lang=&fields=&expand=&order_by=&location=&actual_since=1444385206&actual_until=1455495406&place=&is_free=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

movie_id
number (обязательный) Пример: 1705
идентификатор фильма

fields
string (необязательный) По умолчанию: id,place,datetime,three_d,imax,four_dx,original_language,price
включить в выдачу только указанные поля, можно несколько через запятую

Варианты: id movie place datetime three_d imax four_dx original_language price
expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: movie place
order_by
string (необязательный)
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id movie place datetime three_d imax four_dx original_language price
location
string (необязательный)
включить в выдачу только показы в указанном городе
```
spb - Санкт-Петербург
msk - Москва
nsk - Новосибирск
ekb - Екатеринбург
nnv - Нижний Новгород
kzn - Казань
vbg - Выборг
smr - Самара
krd - Краснодар
sochi - Сочи
ufa - Уфа
krasnoyarsk - Красноярск
kev - Киев
new-york - Нью-Йорк
```
actual_since
number (необязательный) Пример: 1444385206
включить в выдачу только показы после указанного момента времени

actual_until
number (необязательный) Пример: 1455495406
включить в выдачу только показы до указанного момента времени

place
number (необязательный)
включить в выдачу только показы в указанном месте

is_free
number (необязательный)
включить в выдач только бесплатные показы

Варианты: 1 0 true false

Запрос Список показов фильмаПоказатьСкрыть

https://kudago.com/public-api/v1.2/movies/1441/showings/

Тело

{
    "count": 1376,
    "next": "https://kudago.com/public-api/v1.2/movies/1441/showings/?page=2",
    "previous": null,
    "results": [
        {
            "id": 1624991,
            "place": {
                "id": 2637
            },
            "datetime": 1437624000,
            "three_d": false,
            "imax": false,
            "four_dx": false,
            "original_language": false,
            "price": "70–120 руб."
        },
        ...
    ]
}

Запрос Список показов фильма с другими полямиПоказатьСкрыть

https://kudago.com/public-api/v1.2/movies/1441/showings/?fields=id,imax

Тело

{
    "count": 1376,
    "next": "https://kudago.com/public-api/v1.2/movies/1441/showings/?fields=id%2Cimax&page=2",
    "previous": null,
    "results": [
        {
            "id": 1624991,
            "imax": false
        },
        ...
    ]
}

Ответ 404ПоказатьСкрыть
Нет объекта с таким id

Комментарии к фильму

Получение комментариев к фильму

GET

/public-api/{version}/movies/{movie_id}/comments/{?lang,fields,order_by,ids}

Пример запроса
GET https://kudago.com/public-api/v1.4/movies/1323/comments/?lang=&fields=&order_by=&ids=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
movie_id
number (обязательный) Пример: 1323
идентификатор фильма

page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный)
включить в выдачу только указанные поля, можно несколько через запятую

Варианты: id date_posted text user is_deleted replies_count thread reply_to
order_by
string (необязательный) По умолчанию: date_posted
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id date_posted text user is_deleted replies_count thread reply_to
ids
number (необязательный)
включить выдачу только комментарии с указанными ID, можно несколько через запятую

Запрос Комментарии к фильмуПоказатьСкрыть

https://kudago.com/public-api/v1.2/movies/1441/comments/

Тело

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 20576,
      "date_posted": 1437490081,
      "text": "",
      "user": {
        "display_name": "some name",
        "avatar": ""
      },
      "is_deleted": false,
      "replies_count": 0,
      "thread": null,
      "reply_to": null
    }
  ]
}

Запрос Комментарии к фильму с другими полямиПоказатьСкрыть

https://kudago.com/public-api/v1.2/movies/1441/comments/?fields=text,id

Тело

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 20576,
      "text": ""
    }
  ]
}

Ответ 404ПоказатьСкрыть
Нет объекта с таким id

Показы Места

Показы

Список показов фильмов.

Список показов

Получение списка показов

GET

/public-api/{version}/movie-showings/{?lang,fields,expand,ids,location,actual_since,actual_until,place_id,order_by}

Пример запроса
GET https://kudago.com/public-api/v1.4/movie-showings/?lang=&fields=&expand=&ids=&location=&actual_since=1444385206&actual_until=1444385206&place_id=&order_by=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
page
number (необязательный) По умолчанию: 1
выдать указанную страницу пагинатора

page_size
number (необязательный) По умолчанию: 20
число отдаваемых объектов на странице. Максимальное значение - 100

fields
string (необязательный) По умолчанию: id,place,datetime,three_d,imax,four_dx,original_language,price
включить в выдачу только указанные поля, можно несколько через запятую

expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: movie place
order_by
string (необязательный) По умолчанию: datetime
сортировать выдачу по указанным полям, можно несколько через запятую; если поле указано со знаком минус, то происходит сортировка по убыванию

Варианты: id movie place datetime three_d imax four_dx original_language price
ids
number (необязательный)
включить выдачу только показы с указанными ID, можно несколько через запятую

location
string (необязательный)
выключить в выдачу только показы в указанном месте
```
spb - Санкт-Петербург
msk - Москва
nsk - Новосибирск
ekb - Екатеринбург
nnv - Нижний Новгород
kzn - Казань
vbg - Выборг
smr - Самара
krd - Краснодар
sochi - Сочи
ufa - Уфа
krasnoyarsk - Красноярск
kev - Киев
new-york - Нью-Йорк
```
actual_since
number or string (необязательный) Пример: 1444385206
выключить в выдачу только показы после указанного момента времени (в формате UNIX timestamp или ISO 8601, в любом случае время считается в UTC)

actual_until
number or string (необязательный) Пример: 1444385206
выключить в выдачу только показы до указанного момента времени (в формате UNIX timestamp или ISO 8601, в любом случае время считается в UTC)

place_id
number (необязательный)
выключить в выдачу только показы в указанном месте

is_free
number (необязательный)
выключить в выдачу только бесплатные показы

Варианты: 1 0 true false

Запрос Список показов фильмовПоказатьСкрыть

https://kudago.com/public-api/v1.2/movie-showings/

Тело

{
    "count": 29509,
    "next": "https://kudago.com/public-api/v1.2/movie-showings/?page=2",
    "previous": null,
    "results": [
        {
            "id": 1606806,
            "movie": {
                "id": 1437
            },
            "place": {
                "id": 19757
            },
            "datetime": 1437444000,
            "three_d": true,
            "imax": false,
            "four_dx": false,
            "original_language": false,
            "price": "100–400 руб."
        },
        ...
    ]
}

Запрос Список показов фильмов c детализацией места и фильмаПоказатьСкрыть

https://kudago.com/public-api/v1.2/movie-showings/?expand=movie,place

Тело

{
    "count": 29509,
    "next": "https://kudago.com/public-api/v1.2/movie-showings/?expand=movie%2Cplace&page=2",
    "previous": null,
    "results": [
        {
            "id": 1606806,
            "movie": {
                "id": 1437,
                "title": "Человек-муравей",
                "poster": {
                    "image": "http://kudago.com/media/images/movie/poster/36/32/363286a20313d36a729c22c4d9415dac.jpg"
                }
            },
            "place": {
                "id": 19757,
                "title": "Эпицентр",
                "slug": "ramblerkassa14149",
                "address": "просп. им. Газеты «Красноярский Рабочий», 173б",
                "images": [
                    {
                        "image": "http://kudago.com/media/images/place/7f/0b/7f0be2e4461147a1d79fab5300864eec.jpg"
                    }
                ],
                "site_url": "http://kudago.com/krasnoyarsk/place/ramblerkassa14149/",
                "is_closed": false
            },
            "datetime": 1437444000,
            "three_d": true,
            "imax": false,
            "four_dx": false,
            "original_language": false,
            "price": "100–400 руб."
        },
        ...
    ]
}

Запрос Список показов фильмов с другими полямиПоказатьСкрыть

https://kudago.com/public-api/v1.2/movie-showings/?fields=imax,id

Тело

{
    "count": 29509,
    "next": "https://kudago.com/public-api/v1.2/movie-showings/?fields=imax%2Cid&page=2",
    "previous": null,
    "results": [
        {
            "id": 1606806,
            "imax": false
        },
        ...
    ]
}

Запрос Список показов фильмов с фильтрамиПоказатьСкрыть

https://kudago.com/public-api/v1.2/movie-showings/?location=spb&place=14918&actual_since=1000000000&actual_until=2000000000

Тело

{
    "count": 125,
    "next": "https://kudago.com/public-api/v1.2/movie-showings/?actual_since=1000000000&actual_until=2000000000&location=spb&page=2&place=14918",
    "previous": null,
    "results": [
        {
            "id": 1597849,
            "movie": {
                "id": 1437
            },
            "place": {
                "id": 14918
            },
            "datetime": 1437462000,
            "three_d": false,
            "imax": false,
            "four_dx": false,
            "original_language": false,
            "price": "160 руб."
        },
        ...
    ]
}

Ответ 400ПоказатьСкрыть
Неверное значение параметра place_id

Детализация показа

Получение детализации показа

GET

/public-api/{version}/movie-showings/{showing_id}/{?lang,fields,expand}

Пример запроса
GET https://kudago.com/public-api/v1.4/movie-showings/2355754/?lang=&fields=&expand=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
showing_id
number (обязательный) Пример: 2355754
идентификатор показа

fields
string (необязательный)
включить в выдачу только указанные поля, можно несколько через запятую

Варианты: id movie place datetime three_d imax four_dx original_language price
expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: movie place

Запрос Детализация показа фильмаПоказатьСкрыть

https://kudago.com/public-api/v1.2/movie-showings/1629938/

Тело

{
  "id": 1629938,
  "movie": {
    "id": 1405
  },
  "place": {
    "id": 14918
  },
  "datetime": 1438076100,
  "three_d": false,
  "imax": false,
  "four_dx": false,
  "original_language": false,
  "price": null
}

Запрос Детализация показа фильма с другими полямиПоказатьСкрыть
https://kudago.com/public-api/v1.2/movie-showings/1629938/?fields=id,imax

Тело
```
{
  "id": 1629938,
  "imax": false
}
```
Запрос Детализация показа фильма с детализацией места и фильмаПоказатьСкрыть

https://kudago.com/public-api/v1.2/movie-showings/1629938/?expand=movie,place,poster,images

Тело

{
    "id": 1629938,
    "movie": {
        "id": 1405,
        "title": "Миньоны",
        "poster": {
            "image": "http://kudago.com/media/images/movie/poster/a5/d1/a5d157d487c3b5456e9957a27dac8448.jpg",
            "thumbnails": {
                "144x96": "http://kudago.com/media/thumbs/144x96/images/movie/poster/a5/d1/a5d157d487c3b5456e9957a27dac8448.jpg",
                "640x384": "http://kudago.com/media/thumbs/640x384/images/movie/poster/a5/d1/a5d157d487c3b5456e9957a27dac8448.jpg"
            }
        }
    },
    "place": {
        "id": 14918,
        "title": "кинотеатр «Формула Кино Нео»",
        "slug": "kinoteatr-formula-kino-neo",
        "address": "Большой пр. В.О., 68, ТК Балтийский, 1 этаж",
        "images": [
            {
                "id": 174541,
                "image": "http://kudago.com/media/images/place/01/47/01473d04e0c7190e3825a6ad5206e246.jpg",
                "thumbnails": {
                    "144x96": "http://kudago.com/media/thumbs/144x96/images/place/01/47/01473d04e0c7190e3825a6ad5206e246.jpg",
                    "640x384": "http://kudago.com/media/thumbs/640x384/images/place/01/47/01473d04e0c7190e3825a6ad5206e246.jpg"
                }
            },
            ...
        ],
        "site_url": "http://kudago.com/spb/place/kinoteatr-formula-kino-neo/",
        "is_closed": false
    },
    "datetime": 1438076100,
    "three_d": false,
    "imax": false,
    "four_dx": false,
    "original_language": false,
    "price": null
}

Ответ 404ПоказатьСкрыть
Нет объекта с таким id

Агенты Фильмы

Агенты

Список агентов

Получение списка агентов

GET

/public-api/{version}/agents/{?lang,text_format,ids,fields,agent_type}

Пример запроса
GET https://kudago.com/public-api/v1.4/agents/?lang=&text_format=&ids=&fields=&agent_type=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
text_format
string (необязательный) По умолчанию: html
отдавать поля body_text и description в указанном формате
```
html - текст с тэгами
plain - текст без тегов, ссылки <a href=a_href>a_title</a> преобразуются в вид: a_title a_href
text - текст без тегов, от ссылок остается только название
```
fields
string (необязательный) По умолчанию: id,title,slug
включить в выдачу только указанные поля, можно несколько через запятую
```
id - идентификатор
title - название
slug - слаг
favorites_count - сколько пользователей добавило событие в избранное
comments_count - число комментариев к событию
description - описание
body_text - полное описание
site_url - адрес события на сайте kudago.com
disable_comments - выключены ли комментарии
ctype - тип объекта
images - картинки объекта
agent_type - тип агента
rank - рейтинг объекта
participations - список участий агента
```
expand
string (необязательный)
включить в выдачу более подробную информацию для указанных полей, можно несколько через запятую

Варианты: participations
agent_type
string (необязательный)
включить в выдачу только агентов с указанным типом

Варианты: person organization
ids
number (необязательный)
включить выдачу только агентов с указанными ID, можно несколько через запятую

tags
string (необязательный)
включить выдачу только агентов с указанными слагами тэгов, можно несколько через запятую; если тэг указан со знаком минус, то агенты с таким тэгом будут выключены из выдачи

Возвращает список агентов, отсортированный по ранку. Если пользователь залогинен, то поле favorite_id содержит id лайка

Запрос Список агентовПоказатьСкрыть

https://kudago.com/public-api/v1.3/agents/?agent_type=person

Тело

{
  "count": 4,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 10171,
      "title": "L'One",
      "slug": "lone"
    },
    {
      "id": 10133,
      "title": "Макс Корж",
      "slug": "maks-korzh"
    },
    {
      "id": 10132,
      "title": "Ёлка",
      "slug": "yolka"
    },
    {
      "id": 9738,
      "title": "Баста",
      "slug": "basta"
    }
  ]
}

Запрос Список агентов с другим набором полейПоказатьСкрыть

https://kudago.com/public-api/v1.3/agents/?agent_type=person&fields=description

Тело

{
  "count": 4,
  "next": null,
  "previous": null,
  "results": [
    {
      "description": "<p>Самая известная песня L'One и, возможно, одна из самых популярных молодежных композиций последних лет — «Все танцуют локтями».</p>\n"
    },
    {
      "description": "<p>Молодой белорусский рэпер, чьи концерты собирают стадионы не только в Минске, но и в Москве.</p>\n"
    },
    {
      "description": "<p>У этой исполнительницы получилось стать любимицей и критиков, и огромной аудитории слушателей.</p>\n"
    },
    {
      "description": "<p>Один из самых популярных <a href=\"http://kudago.com/all/list/5-samyh-populyarnyh-russkih-reperov/\">российских рэперов.</a></p>\n"
    }
  ]
}

Запрос Список агентов с детализацией участийПоказатьСкрыть

http://kudago.com/public-api/v1.3/agents/?fields=participations&expand=participations

Тело

{
    "count": 11,
    "next": null,
    "previous": null,
    "results": [
        {
            "participations": [
                {
                    "role": {
                        "id": 5,
                        "slug": "musician",
                        "name": "musician",
                        "name_plural": "musicians"
                    },
                    "item": {
                        "id": 119029,
                        "title": "концерт Басты",
                        "favorites_count": 0,
                        "comments_count": 0,
                        "description": "",
                        "item_url": "https://kudago.com/msk/event/koncert-gruppy-basta16/",
                        "disable_comments": false,
                        "ctype": "event",
                        "place": {
                            "id": 10620
                        },
                        "daterange": {
                            "start_date": "2016-12-10",
                            "start_time": "20:00:00",
                            "start": 1481389200,
                            "end_date": null,
                            "end_time": null,
                            "end": 1481389200,
                            "is_continuous": false,
                            "is_endless": false,
                            "is_startless": false,
                            "schedules": [],
                            "use_place_schedule": false
                        },
                        "first_image": {
                            "image": "http://kudago.com/media/images/event/0b/a4/0ba4f7add2ff2fda073196605e0fc0c2.jpg",
                            "thumbnails": {
                                "144x96": "http://kudago.com/media/thumbs/144x96/images/event/0b/a4/0ba4f7add2ff2fda073196605e0fc0c2.jpg",
                                "640x384": "http://kudago.com/media/thumbs/640x384/images/event/0b/a4/0ba4f7add2ff2fda073196605e0fc0c2.jpg"
                            },
                            "source": {
                                "link": "http://www.maximonline.ru/tags/basta/",
                                "name": "maximonline.ru"
                            }
                        },
                        "age_restriction": "16+"
                    }
                },
                ...
            ]
        }
    ]
}

Детализация агента

Получение детализации агента

GET

/public-api/{version}/agents/{agent_id}/{?text_format}

Пример запроса
GET https://kudago.com/public-api/v1.4/agents/agent_id/?text_format=

Параметры

version

string (обязательный) Пример: v1.4

версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4

lang

string (необязательный) По умолчанию: ru

язык ответа

Варианты: ru en

text_format

string (необязательный) По умолчанию: html

отдавать поля body_text и description в указанном формате

html - текст с тэгами
plain - текст без тегов, ссылки <a href=a_href>a_title</a> преобразуются в вид: a_title a_href
text - текст без тегов, от ссылок остается только название

fields

string (необязательный)

включить в выдачу только указанные поля, можно несколько через запятую

id - идентификатор
title - название
slug - слаг
favorites_count - сколько пользователей добавило событие в избранное
comments_count - число комментариев к событию
description - описание
body_text - полное описание
site_url - адрес события на сайте kudago.com
disable_comments - выключены ли комментарии
ctype - тип объекта
images - картинки объекта
agent_type - тип агента
rank - рейтинг объекта
participations - список участий агента

agent_id

number (обязательный)

идентификатор агента

Запрос Детализация агентаПоказатьСкрыть

http://kudago.com/public-api/v1.3/agents/9738/

Тело

{
    "id": 9738,
    "title": "Баста",
    "slug": "basta",
    "description": "<p>Один из самых популярных <a href=\"http://kudago.com/all/list/5-samyh-populyarnyh-russkih-reperov/\">российских рэперов.</a></p>\n",
    "body_text": "<p>Имя Басты можно встретить фактически в каждом рейтинге и опросе на тему самого влиятельного рэпера в России. Каждый из его многочисленных проектов вызывает ажиотаж, а сам Баста находится в постоянном поиске новых средств для самовыражения. Настоящее имя звезды — Василий Вакуленко. Уроженец Ростова-на-Дону, он учился в музыкальной школе, но его с юности привлекал мир хип-хопа. Первый шаг в блестящей карьере будущего основателя лейбла Gazgolder — участие в группе «Психолирик» (будущая «Каста»). От гастролей по побережью Чёрного моря Баста вскоре перешёл к аншлагам в самых престижных залах по всей стране: стоило только перебраться в Москву и передать демо-запись Богдану Титомиру. Ныне Баста является не только успешным рэпером, который собрал впечатляющий урожай премий, но и актёром, ведущим на радио и телевидении, сценаристом, режиссёром и продюсером. Баста успел даже попробовать себя в роди наставника в шоу «Голос». Его образная и честная лирика выходит под именами Ноггано, N1NT3ND0 и Bratia Stereo, а ведомый Бастой лейбл Gazgolder служит кузницей молодых талантов и подлинным законодателем мод на российской <a href=\"http://kudago.com/msk/concerts/hip-hop/\">рэп</a>-сцене.</p>\n",
    "rank": 0.0,
    "agent_type": "person",
    "images": [
        {
            "image": "http://kudago.com/media/images/agent/19/d1/19d170f390f102f2bfea80e543be281f.jpg",
            "thumbnails": {
                "144x96": "http://kudago.com/media/thumbs/144x96/images/agent/19/d1/19d170f390f102f2bfea80e543be281f.jpg",
                "640x384": "http://kudago.com/media/thumbs/640x384/images/agent/19/d1/19d170f390f102f2bfea80e543be281f.jpg"
            },
            "source": {
                "link": "http://chameleon.fm/music/zakon-1-763-article",
                "name": "chameleon.fm"
            }
        }
    ],
    "favorites_count": 4,
    "comments_count": 0,
    "site_url": "https://kudago.com/follow/basta/",
    "disable_comments": false,
    "participations": [
        {
            "role": {
                "slug": "musician"
            },
            "item": {
                "id": 119029,
                "title": "концерт Басты",
                "ctype": "event"
            }
        },
        ...
    ]
}

Запрос Детализация агента с детализацией участийПоказатьСкрыть

http://kudago.com/public-api/v1.3/agents/9738/?expand=participations

Тело

{
    "id": 9738,
    "title": "Баста",
    "slug": "basta",
    "description": "<p>Один из самых популярных <a href=\"http://kudago.com/all/list/5-samyh-populyarnyh-russkih-reperov/\">российских рэперов.</a></p>\n",
    "body_text": "<p>Имя Басты можно встретить фактически в каждом рейтинге и опросе на тему самого влиятельного рэпера в России. Каждый из его многочисленных проектов вызывает ажиотаж, а сам Баста находится в постоянном поиске новых средств для самовыражения. Настоящее имя звезды — Василий Вакуленко. Уроженец Ростова-на-Дону, он учился в музыкальной школе, но его с юности привлекал мир хип-хопа. Первый шаг в блестящей карьере будущего основателя лейбла Gazgolder — участие в группе «Психолирик» (будущая «Каста»). От гастролей по побережью Чёрного моря Баста вскоре перешёл к аншлагам в самых престижных залах по всей стране: стоило только перебраться в Москву и передать демо-запись Богдану Титомиру. Ныне Баста является не только успешным рэпером, который собрал впечатляющий урожай премий, но и актёром, ведущим на радио и телевидении, сценаристом, режиссёром и продюсером. Баста успел даже попробовать себя в роди наставника в шоу «Голос». Его образная и честная лирика выходит под именами Ноггано, N1NT3ND0 и Bratia Stereo, а ведомый Бастой лейбл Gazgolder служит кузницей молодых талантов и подлинным законодателем мод на российской <a href=\"http://kudago.com/msk/concerts/hip-hop/\">рэп</a>-сцене.</p>\n",
    "rank": 0.0,
    "agent_type": "person",
    "images": [
        {
            "image": "http://kudago.com/media/images/agent/19/d1/19d170f390f102f2bfea80e543be281f.jpg",
            "thumbnails": {
                "144x96": "http://kudago.com/media/thumbs/144x96/images/agent/19/d1/19d170f390f102f2bfea80e543be281f.jpg",
                "640x384": "http://kudago.com/media/thumbs/640x384/images/agent/19/d1/19d170f390f102f2bfea80e543be281f.jpg"
            },
            "source": {
                "link": "http://chameleon.fm/music/zakon-1-763-article",
                "name": "chameleon.fm"
            }
        }
    ],
    "favorites_count": 4,
    "comments_count": 0,
    "site_url": "https://kudago.com/follow/basta/",
    "disable_comments": false,
    "participations": [
        {
            "role": {
                "id": 5,
                "name": "musician",
                "name_plural": "musicians"
            },
            "event": {
                "id": 119029,
                "title": "концерт Басты",
                "favorites_count": 0,
                "comments_count": 0,
                "description": "",
                "item_url": "https://kudago.com/msk/event/koncert-gruppy-basta16/",
                "disable_comments": false,
                "ctype": "event",
                "place": {
                    "id": 10620
                },
                "daterange": {
                    "start_date": "2016-12-10",
                    "start_time": "20:00:00",
                    "start": 1481389200,
                    "end_date": null,
                    "end_time": null,
                    "end": 1481389200,
                    "is_continuous": false,
                    "is_endless": false,
                    "is_startless": false,
                    "schedules": [],
                    "use_place_schedule": false
                },
                "first_image": {
                    "image": "http://kudago.com/media/images/event/0b/a4/0ba4f7add2ff2fda073196605e0fc0c2.jpg",
                    "thumbnails": {
                        "144x96": "http://kudago.com/media/thumbs/144x96/images/event/0b/a4/0ba4f7add2ff2fda073196605e0fc0c2.jpg",
                        "640x384": "http://kudago.com/media/thumbs/640x384/images/event/0b/a4/0ba4f7add2ff2fda073196605e0fc0c2.jpg"
                    },
                    "source": {
                        "link": "http://www.maximonline.ru/tags/basta/",
                        "name": "maximonline.ru"
                    }
                },
                "age_restriction": "16+"
            }
        },
        ...
    ]
}

Роли Показы

Роли

Список ролей

Получение списка ролей

GET

/public-api/{version}/agent-roles/{?lang,fields}

Пример запроса
GET https://kudago.com/public-api/v1.4/agent-roles/?lang=&fields=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
fields
string (необязательный) По умолчанию: id,name
включить в выдачу только указанные поля, можно несколько через запятую
```
id - идентификатор
name - название роли
name_plural - название роли во множественном числе
```

Возвращает список ролей агентов.

Ответ 200ПоказатьСкрыть

https://kudago.com/public-api/v1.3/agent-roles/

Тело

{
    "count": 10,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 8,
            "name": "автор"
        },
        ...
    ]
}

Ответ 200ПоказатьСкрыть

https://kudago.com/public-api/v1.3/agent-roles/?fields=id,name_plural

Тело

{
    "count": 10,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 8,
            "name_plural": "авторы"
        },
        ...
    ]
}

Детализация роли

Получение детализации роли

GET

/public-api/{version}/agent-roles/{role_id}/{?lang}

Пример запроса
GET https://kudago.com/public-api/v1.4/agent-roles/role_id/?lang=

Параметры
version
string (обязательный) Пример: v1.4
версия API (подробнее об изменениях версий в Истории изменений)

Варианты: v1 v1.1 v1.2 v1.3 v1.4
lang
string (необязательный) По умолчанию: ru
язык ответа

Варианты: ru en
fields
string (необязательный)
включить в выдачу только указанные поля, можно несколько через запятую
```
id - идентификатор
name - название роли
name_plural - название роли во множественном числе
```
role_id
number (обязательный)
идентификатор роли

Ответ 200ПоказатьСкрыть

https://kudago.com/public-api/v1.3/agent-roles/8/

Тело

{
  "id": 8,
  "name": "автор",
  "name_plural": "авторы"
}

Агенты

Лицензионное соглашение <открытая лицензия>

ПРЕДМЕТ СОГЛАШЕНИЯ ¶

СРОК И ТЕРРИТОРИЯ ДЕЙСТВИЯ СОГЛАШЕНИЯ ¶

ОПРЕДЕЛЕНИЯ ¶

ПРАВА И ОБЯЗАННОСТИ СТОРОН. ЦЕЛИ И ПОРЯДОК ИСПОЛЬЗОВАНИЯ ДАННЫХ ¶

ОГРАНИЧЕНИЯ ¶

ОГРАНИЧЕННАЯ ОТВЕТСТВЕННОСТЬ ¶

ОТВЕТСТВЕННОСТЬ ПОЛЬЗОВАТЕЛЯ ¶

ПЕРСОНАЛЬНЫЕ ДАННЫЕ ¶

ПРИМЕНИМОЕ ПРАВО. РАЗРЕШЕНИЕ СПОРОВ ¶

ИНЫЕ УСЛОВИЯ ¶

История изменений

02.02.2018 ¶

18.12.2017 ¶

21.11.2016 ¶

18.07.2016 ¶

12.07.2016 ¶

01.07.2016 ¶

27.05.2016 ¶

12.04.2016 ¶

01.04.2016 ¶

31.03.2016 ¶

30.03.2016 ¶

03.03.2016 ¶

17.02.2016 ¶

15.02.2016 ¶

08.02.2015 ¶

27.01.2016 ¶

09.12.2015 ¶

08.12.2015 ¶

07.12.2015 ¶

24.11.2015 ¶

13.11.2015 ¶

11.11.2015 ¶

03.11.2015 ¶

31.10.2015 ¶

30.10.2015 ¶

27.10.2015 ¶

14.10.2015 ¶

13.10.2015 ¶

30.09.2015 ¶

Категории объектов

Категории событий

Тело

Тело

Категории мест

Тело

Тело

Города

Список городов

Тело

Тело

Детализация города

Тело

Тело

Поиск

Поиск

Тело

Тело

Тело

Тело

События

Список событий

Тело

Тело

Тело

Тело

Детализация события

Тело

Тело

Тело

Комментарии к событию

Тело

Тело

События дня

Список событий дня

Тело

Тело

Тело

Новости

ПРЕДМЕТ СОГЛАШЕНИЯ

СРОК И ТЕРРИТОРИЯ ДЕЙСТВИЯ СОГЛАШЕНИЯ

ОПРЕДЕЛЕНИЯ

ПРАВА И ОБЯЗАННОСТИ СТОРОН. ЦЕЛИ И ПОРЯДОК ИСПОЛЬЗОВАНИЯ ДАННЫХ

ОГРАНИЧЕНИЯ

ОГРАНИЧЕННАЯ ОТВЕТСТВЕННОСТЬ

ОТВЕТСТВЕННОСТЬ ПОЛЬЗОВАТЕЛЯ

ПЕРСОНАЛЬНЫЕ ДАННЫЕ

ПРИМЕНИМОЕ ПРАВО. РАЗРЕШЕНИЕ СПОРОВ

ИНЫЕ УСЛОВИЯ

02.02.2018

18.12.2017

21.11.2016

18.07.2016

12.07.2016

01.07.2016

27.05.2016

12.04.2016

01.04.2016

31.03.2016

30.03.2016

03.03.2016

17.02.2016

15.02.2016

08.02.2015

27.01.2016

09.12.2015

08.12.2015

07.12.2015

24.11.2015

13.11.2015

11.11.2015

03.11.2015

31.10.2015

30.10.2015

27.10.2015

14.10.2015

13.10.2015

30.09.2015