5. Рубрики

Метод API для получения данных по рубрикам:

https://experience.tripster.ru/api/partners/<partner_name>/citytags/

Параметры запроса

Фильтры
- updated_after - последнее обновление
- city фильтр по ID города
- city__iata фильтр по ATA коду города
- city__name_ru фильтр по названию города на русском
- city__name_en фильтр по названию города на английском
- city__slug фильтр по строковому идентификатору города
Стандартные параметры format и page_size. Рубрик в городе не бывает много, так что их можно всегда выгрузить одним запросом с page_size=100.
Сортировки
- experience_count по количеству экскурсий в рубрике
- popularity по популярности рубрики (поумолчанию -popularity)

Примеры запросов

Рубрики в Санкт-Петербурге.

Фильтр city:

https://experience.tripster.ru/api/partners/<partner_name>/citytags/?city=144

Фильтр city__name_ru:

https://experience.tripster.ru/api/partners/<partner_name>/citytags/?city__name_ru=Санкт-Петербург

Фильтр city__iata:

https://experience.tripster.ru/api/partners/<partner_name>/citytags/?city__iata=LED

Структура ответа

Пример ответа API

{

    "count": 1,

    "next": null,

    "previous": null,

    "results": [

        {

            "id": 913,

            "citytag_id": 20252,

            "name": "Коммуналки",

            "slug": "kommunalki",

            "url": " ",

            "is_hidden": true,

            "experience_count": 5,

            "review_count": 1959,

            "title": "Экскурсии по коммуналкам Санкт-Петербурга 2022: цены в июне",

            "header": "Экскурсии по коммуналкам Санкт-Петербурга",

            "extra_header": "Необычные экскурсии от местных жителей",

            "tag": {

                "id": 913,

                "name": "Коммуналки",

                "slug": "kommunalki",

                "is_common": false,

                "is_attraction": false,

                "is_auto": false,

                "is_hidden": false,

                "category": "Темы",

                "icon": null

            },

            "image": {

                "thumbnail": "https://554a875a-71dc-4f5f-b6bf-ae8967f137d5.selcdn.net/thumbs2/94696ec0-fbac-11ec-b3d5-12849d2fe5ff.384x289.jpeg",

                "medium": "https://554a875a-71dc-4f5f-b6bf-ae8967f137d5.selcdn.net/thumbs2/94e5547c-fbac-11ec-b3d5-12849d2fe5ff.800x600.jpeg"

            },

            "icon": null

        }

    ]

}

Описание ответа

Параметр	Описание	Тип
id	ID рубрики	Число
citytag_id	ID рубрики в городе	Число
name	Название рубрики на русском	Строка
slug	Строковый идентификатор рубрики	Строка
url	Ссылка на страницу рубрики на Трипстере (прочитайте про правила формирования ссылок)	Строка
experience_count	Число экскурсий в рубрике	Строка
review_count	Чило отзывов в рубрике	Число
title	Актуальный на текущий момент заголовок (включает фразу вида “цены в сентябре 2022”)	Строка
header	Заголовок	Строка
extra_header	Подзаголовок	Строка
tag	Объект служебной информации о рубрике	Объект
image.thumbnail	Ссылка на картнику-превью для рубрики размером 384х289	Строка
image.medium	Ссылка на картнику-превью для рубрики размером 800х600	Строка