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

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

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

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

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

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

Настоящее Лицензионное соглашение (далее по тексту – «Соглашение») регламентирует порядок и условия использования третьими лицами (далее – «Пользователь», «Лицензиат») API и иных материалов (далее – «Данные»), содержащихся на сайте http://kudago.com, принадлежащих компании ООО «Реван» (место нахождения Россия, г. Санкт-Петербург, площадь Карла Фаберже, дом 8, литер Б, офис 403, ОГРН 1127841097839, 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/, и является обязательной для всех Пользователей сайта.

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

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

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 в сериализацию мест и событий
Категории объектов  Лицензионное соглашение <открытая лицензия>

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

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

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

Список категорий событий
/public-api/{version}/event-categories/{?lang,order_by,fields}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/event-categories/?lang=&order_by=&fields=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

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

    язык ответа

    Варианты: ru en

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

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

    slug - слаг
    name - название
    order_by
    string (необязательный) По умолчанию: slug 

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

    Варианты: slug name

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

Список категорий мест
/public-api/{version}/place-categories/{?lang,order_by,fields}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/place-categories/?lang=&order_by=&fields=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

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

    язык ответа

    Варианты: ru en

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

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

    slug - слаг
    name - название
    order_by
    string (необязательный) По умолчанию: slug 

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

    Варианты: slug name

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

Города 

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

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

Получение списка городов
/public-api/{version}/locations/{?lang,fields,order_by}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/locations/?lang=&fields=&order_by=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

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

    язык ответа

    Варианты: ru en

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

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

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

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

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

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

Получение детализации города
/public-api/{version}/locations/{slug}/{?lang,fields}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/locations/msk/?lang=&fields=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

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

    язык ответа

    Варианты: ru en

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

    слаг города

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

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

    slug - слаг
    name - название
    timezone - часовой пояс
    coords - координаты
    language - язык
Поиск  Категории объектов

Поиск 

Поиск 

Получение результатов поиска
/public-api/{version}/search/{?q,lang,expand,location,ctype,is_free,lat,lon,radius}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/search/?q=выставка&lang=&expand=&location=msk&ctype=event&is_free=&lat=&lon=&radius=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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 (необязательный) 

    радиус вокруг точки, в метрах

  • Запрос  Поиск новостей
  • Тело
    {
        "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
                },
                ...
            ]
    }
  • Запрос  Поиск событий
  • Тело
    {
        "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
                    }
                },
                ...
            ]
    }
  • Запрос  Поиск мест
  • Тело
    {
        "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
                },
                ...
            ]
    }
  • Запрос  Поиск подборок
  • Тело
    {
        "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"
                },
                ...
            ]
    }
События  Города

События 

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

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

Получение списка событий
/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.3/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.3

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

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

    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 вместе фильтруют события вокруг указанных координат; радиус указывается в метрах

  • Запрос  Список событий
  • Тело
    {
        "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 другим набором полей
  • Тело
    {
        "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 фильтрами
  • Тело
    {
        "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 детализацией места, города, дат и участников
  • Тело
    {
        "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
  • Неверная категория событий

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

Получение детализации события
/public-api/{version}/events/{event_id}/{?lang,fields,expand}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/events/60843/?lang=&fields=&expand=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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

  • Запрос  Детализация события
  • Тело
    {
      "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 другим набором полей
  • Тело
    {
      "tagline": "Серия вечеринок посвященных всем оттенкам хауса",
      "price": ""
    }
  • Запрос  Детализация события c детализацией города, места, дат и участников
  • Тело
    {
      "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

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

Получение комментариев к событию
/public-api/{version}/events/{event_id}/comments/{?lang,fields,order_by,ids}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/events/60843/comments/?lang=&fields=&order_by=&ids=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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, можно несколько через запятую

  • Запрос  Список комментариев к событию
  • Тело
    {
        "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 другим набором полей
  • Тело
    {
        "count": 19,
        "next": null,
        "previous": null,
        "results": [
            {
                "id": 11934,
                "text": "Первый квест от которого я оказался в восторге…"
            },
            {
                "id": 11943,
                "text": "ВОтрыв башки!"
            },
            ...
        ]
    }
  • Ответ  404
  • Нет объекта с таким id

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

События дня 

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

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

Получение списка событий дня
/public-api/{version}/events-of-the-day/{?lang,fields,expand,order_by,text_format,location,date}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/events-of-the-day/?lang=&fields=&expand=&text_format=&location=&date=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

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

    язык ответа

    Варианты: ru en

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

    выдать указанную страницу пагинатора

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

    число отдаваемых объектов на странице. Максимальное значение - 100

    fields
    string (необязательный) По умолчанию: date,event,location 

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

    date - дата, на которую назначено событие дня
    event - событие
    location - город, для которого назначено событие дня
    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 (необязательный) 

    включить в выдачу только события, назначенные на указанную дату

  • Запрос  Список событий дня
  • Тело
    {
        "count": 3,
        "next": null,
        "previous": null,
        "results": [
            {
                "date": "2016-04-05",
                "location": "spb",
                "event": {
                    "id": 113659
                }
            },
            ...
        ]
    }
  • Запрос  Список событий дня c фильтрами
  • Тело
    {
      "count": 1,
      "next": null,
      "previous": null,
      "results": [
        {
          "date": "2016-01-31",
          "location": "spb",
          "event": {
            "id": 105802
          }
        }
      ]
    }
  • Запрос  Список событий дня с детализацией события
  • Тело
    {
        "count": 3,
        "next": null,
        "previous": null,
        "results": [
            {
                "date": "2016-04-05",
                "location": "spb",
                "event": {
                    "id": 113659,
                    "title": "спектакль «День космонавтики» в Театре «Балтийский дом»",
                    "description": "<p>Премьера спектакля в постановке актера и режиссера Леонида Алимова.</p>\n",
                    "daterange": {
                        "start_date": "2016-04-05",
                        "start_time": "19:30:00",
                        "start": 1459873800,
                        "end_date": null,
                        "end_time": "21:30:00",
                        "end": 1459881000,
                        "is_continuous": false,
                        "is_endless": false,
                        "is_startless": false,
                        "schedules": []
                    },
                    "first_image": {
                        "image": "https://kudago.com/media/images/event/7e/60/7e6067a66a24792cfea551f5055f6dba.jpg",
                        "thumbnails": {
                            "144x96": "https://kudago.com/media/thumbs/144x96/images/event/7e/60/7e6067a66a24792cfea551f5055f6dba.jpg",
                            "640x384": "https://kudago.com/media/thumbs/640x384/images/event/7e/60/7e6067a66a24792cfea551f5055f6dba.jpg"
                        },
                        "source": {
                            "link": "",
                            "name": ""
                        }
                    }
                }
            },
            ...
        ]
    }
Новости  События

Новости 

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

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

Получение списка новостей
/public-api/{version}/news/{?lang,fields,expand,order_by,text_format,ids,location,actual_only}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/news/?lang=&fields=&expand=&order_by=&text_format=&ids=&location=&actual_only=true
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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

  • Запрос  Список новостей
  • Тело
    {
        "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 другим набором полей
  • Тело
    {
        "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 фильтрами
  • Тело
    {
        "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"
            },
            ...
        ]
    }

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

Получение детализации новости
/public-api/{version}/news/{news_id}/{?lang,fields,expand}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/news/3730/?lang=&fields=&expand=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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

  • Запрос  Детализация новости
  • Тело
    {
      "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 другим набором полей
  • Тело
    {
      "slug": "v-gatchine-otmenili-festival-noch-sveta-2015",
      "favorites_count": 0
    }
  • Запрос  Детализация новости c детализацией места и картинок
  • Тело
    {
      "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

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

Получение комментариев к новости
/public-api/{version}/news/{news_id}/comments/{?lang,fields,order_by,ids}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/news/3730/comments/?lang=&fields=&order_by=&ids=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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, можно несколько через запятую

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

Подборки 

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

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

Получение списка подборок
/public-api/{version}/lists/{?lang,fields,expand,order_by,text_format,ids,location}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/lists/?lang=&fields=&expand=&order_by=&text_format=&ids=&location=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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 - Нью-Йорк
  • Запрос  Список подборок
  • Тело
    {
        "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 другим набором полей
  • Тело
    {
        "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 фильтрами
  • Тело
    {
        "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/"
            },
            ...
        ]
    }

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

Получение детализации подборки
/public-api/{version}/lists/{list_id}/{?lang,fields,expand}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/lists/1023/?lang=&fields=&expand=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

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

    язык ответа

    Варианты: ru en

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

    идентификатор подборки

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

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

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

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

    Варианты: 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"
            },
            ...
        ],
        "description": "<p>Лето в самом разгаре — и в Санкт-Петербурге жизнь кипит! На город обрушатся супер-насыщенные выходные: никто не останется скучать в одиночестве. Будем слушать самый лучший и душевный джаз, весело обольём друг друга водой, продегустируем летние десерты, отдохнём не фестивале красок с королевским размахом, посмотрим милые короткометражки и от души посмеёмся над проделками неунывающих миньонов! Все лучшие события выходных смотрите в специальном дайджесте от KudaGo!</p>\n",
        "body_text": "",
        "site_url": "http://kudago.com/spb/list/vyhodnye-ot-kudago-10-11-12-iyulya-spb/"
    }
  • Запрос  Детализация подборки c другим набором полей
  • Тело
    {
      "slug": "v-gatchine-otmenili-festival-noch-sveta-2015",
      "favorites_count": 0
    }
  • Запрос  Детализация подборки c детализацией картинок
  • Тело
    {
        "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

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

Получение списка комментариев
/public-api/{version}/lists/{list_id}/comments/{?lang,fields,order_by,ids}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/lists/1023/comments/?lang=&fields=&order_by=&ids=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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, можно несколько через запятую

  • Запрос  Список комментариев к подборке
  • Тело
    {
      "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 другим набором полей
  • Тело
    {
      "count": 1,
      "next": null,
      "previous": null,
      "results": [
        {
          "id": 20548,
          "text": "Фестиваль \"Морские дьяволы\" перенесен на 05 сентября, из-за жеребьевки по футболу на 2018 год"
        }
      ]
    }
  • Ответ  404
  • Нет объекта с таким id

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

Места 

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

Список мест 

Получение списка мест
/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.3/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.3

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

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

    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 вместе фильтруют места вокруг указанных координат; радиус указывается в метрах

  • Запрос  Список мест
  • Тело
    {
        "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
            },
            ...
        ]
    }
  • Запрос  Список мест с другим набором полей
  • Тело
    {
        "count": 14416,
        "next": "https://kudago.com/public-api/v1.2/places/?fields=id%2Cslug&page=2",
        "previous": null,
        "results": [
            {
                "id": 2215,
                "slug": "cleverclub"
            },
            ...
        ]
    }
  • Запрос  Список мест с фильтрами
  • Тело
    {
        "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_)
    

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

Получение детализации места
/public-api/{version}/places/{place_id}/{?lang,fields,expand}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/places/12271/?lang=&fields=&expand=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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

  • Запрос  Детализация места
  • Тело
    {
        "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
    }
  • Запрос  Детализация места с другим набором полей
  • Тело
    {
      "address": "ул. Дольская, д. 1",
      "phone": "+7 499 725-72-87"
    }
  • Запрос  Детализация места с детализацией картинок
  • Тело
    {
        "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

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

Получение комментариев к месту
/public-api/{version}/places/{place_id}/comments/{?lang,fields,order_by,ids}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/places/12271/comments/?lang=&fields=&order_by=&ids=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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, можно несколько через запятую

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

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

Фильмы 

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

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

Получение списка фильмов
/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.3/movies/?lang=&fields=&expand=&order_by=&text_format=&ids=&location=&premiering_in_location=&actual_since=1444385206&actual_until=1444385406
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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)

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

Получение детализации фильма
/public-api/{version}/movies/{movie_id}/{?lang,fields,expand}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/movies/1323/?lang=&fields=&expand=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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

  • Запрос  Детализация фильма
  • Тело
    {
        "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
    }
  • Запрос  Детализация фильма с другими полями
  • Тело
    {
      "age_restriction": "12+",
      "writer": "Джон Грин, Скотт Нейстадтер, Майкл Х. Уэбер"
    }
  • Запрос  Детализация фильма с детализацией картинок и постера
  • Тело
    {
        "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

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

Получение списка показов фильма
/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.3/movies/1705/showings/?lang=&fields=&expand=&order_by=&location=&actual_since=1444385206&actual_until=1455495406&place=&is_free=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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

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

Получение комментариев к фильму
/public-api/{version}/movies/{movie_id}/comments/{?lang,fields,order_by,ids}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/movies/1323/comments/?lang=&fields=&order_by=&ids=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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, можно несколько через запятую

Показы  Места

Показы 

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

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

Получение списка показов
/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.3/movie-showings/?lang=&fields=&expand=&ids=&location=&actual_since=1444385206&actual_until=1444385206&place_id=&order_by=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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

  • Запрос  Список показов фильмов
  • Тело
    {
        "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 детализацией места и фильма
  • Тело
    {
        "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 руб."
            },
            ...
        ]
    }
  • Запрос  Список показов фильмов с другими полями
  • Тело
    {
        "count": 29509,
        "next": "https://kudago.com/public-api/v1.2/movie-showings/?fields=imax%2Cid&page=2",
        "previous": null,
        "results": [
            {
                "id": 1606806,
                "imax": false
            },
            ...
        ]
    }
  • Запрос  Список показов фильмов с фильтрами
  • Тело
    {
        "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

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

Получение детализации показа
/public-api/{version}/movie-showings/{showing_id}/{?lang,fields,expand}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/movie-showings/2355754/?lang=&fields=&expand=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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

  • Запрос  Детализация показа фильма
  • Тело
    {
      "id": 1629938,
      "movie": {
        "id": 1405
      },
      "place": {
        "id": 14918
      },
      "datetime": 1438076100,
      "three_d": false,
      "imax": false,
      "four_dx": false,
      "original_language": false,
      "price": null
    }
  • Запрос  Детализация показа фильма с другими полями
  • Тело
    {
      "id": 1629938,
      "imax": false
    }
  • Запрос  Детализация показа фильма с детализацией места и фильма
  • Тело
    {
        "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

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

Агенты 

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

Получение списка агентов
/public-api/{version}/agents/{?lang,text_format,ids,fields,agent_type}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/agents/?lang=&text_format=&ids=&fields=&agent_type=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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 лайка

  • Запрос  Список агентов
  • Тело
    {
      "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"
        }
      ]
    }
  • Запрос  Список агентов с другим набором полей
  • Тело
    {
      "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"
        }
      ]
    }
  • Запрос  Список агентов с детализацией участий
  • Тело
    {
        "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+"
                        }
                    },
                    ...
                ]
            }
        ]
    }

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

Получение детализации агента
/public-api/{version}/agents/{agent_id}/{?text_format}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/agents/agent_id/?text_format=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

    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 (обязательный) 

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

  • Запрос  Детализация агента
  • Тело
    {
        "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"
                }
            },
            ...
        ]
    }
  • Запрос  Детализация агента с детализацией участий
  • Тело
    {
        "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+"
                }
            },
            ...
        ]
    }
Роли  Показы

Роли 

Список ролей 

Получение списка ролей
/public-api/{version}/agent-roles/{?lang,fields}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/agent-roles/?lang=&fields=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

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

    язык ответа

    Варианты: ru en

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

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

    id - идентификатор
    name - название роли
    name_plural - название роли во множественном числе

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

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

Получение детализации роли
/public-api/{version}/agent-roles/{role_id}/{?lang}
  • Пример запроса
  • GET https://kudago.com/public-api/v1.3/agent-roles/role_id/?lang=
  • Параметры
  • version
    string (обязательный) Пример: v1.3

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

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

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

    язык ответа

    Варианты: ru en

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

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

    id - идентификатор
    name - название роли
    name_plural - название роли во множественном числе
    role_id
    number (обязательный) 

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

 Агенты

Generated by aglio on 21 Sep 2017