ActionList API

Будь в курсе!

API позволяет работать с данными сервиса ActionList.ru. Вы сможете получать самую полную, оперативную и структурированную информацию о концертах, клубах и музыкальных исполнителях. ActionList API - это автоматизированный доступ к самой полной концертной афише и информации о концертах Москвы, Киева и других городов. API работает по протоколу HTTP через GET-запросы, ответ возвращается в формате XML.

Доступ к ActionList API это:

  • Более 500 концертов в Москве каждый месяц.
  • Информация о 4000 музыкальных исполнителей.
  • Информация о 150 клубах Москвы.
  • Ежедневные обновления.


Текущая версия ActionList API: 2.0

Для получения доступа к API необходимо отправить заявку по адресу info@actionlist.ru.

Все запросы к API необходимо отправлять по адресу https://api.actionList.ru/v2/.

Для доступа к API Вы получите авторизационный ключ, который необходимо включать в каждый запрос к API(переменная auth). Запросы от неавторизованных пользователей будут отклонены. Сессия назначается для всего приложения и является постоянной.

Для получения доступа к API необходимо написать запрос по адресу info@actionlist.ru.

В текущей версии ActionList API доступны следующие запросы:

GetEventsВозвращает описание всех предстоящих мероприятий.
GetEventInfoВозвращает описание конкретного мероприятия.
GetArtistInfoВозвращает описание конкретного исполнителя.
GetSimilarArtistsВозвращает список похожих по репертуару музыкальных исполнителей.
SearchArtistВозвращает список исполнителей с учетом названия или музыкального жанра.
GetClubsВозвращает описание всех клубов.
GetClubInfoВозвращает описание конкретного клуба.
GetGenresВозвращает список всех музыкальных жанров.

С планами развития ActionList API можно ознакомиться в разделе RoadMap. API может быть доработано под требования заказчика.

Запрос c параметром all возвращает XML структуру с описанием всех предстоящих мероприятиях, упорядоченных по времени.

Пример запроса:
https://api.actionlist.ru/v2/?GetEvents=all&auth=%token% - возвращает список всех предстоящих концертов.


Существует возможность фильтровать список мероприятия. Для этого необходимо воспользоваться запросом с параметром part и дополнительными фильтрами. Фильтры можно использовать как по отдельности, так и вместе:
https://api.actionlist.ru/v2/?GetEvents=part&club_id=12&min_date=20.12.2012&max_date=30.12.2012&auth=%token%

Дополнительные фильтры:

club_idВывести концерты, проходящие в определенном клубе.
dayВывести концерты проходящие в конкретный день(формат дд.мм.гггг).
min_dateОграничение снизу на дату концерта(формат дд.мм.гггг).
max_dateОграничение сверху на дату концерта(формат дд.мм.гггг).

Пример XML-ответа:

<events>
	<event>
		<id>560</id>
		<title>Ария</title>
		<date>13.04.2013 20:00</date>
		<timestamp>1365868800</timestamp>
		<club>
			<club_id>11</club_id>
			<club_name>Arena Moscow</club_name>
			<club_adress>Ленинградский проспект 31 стр.4</club_adress>
			<club_geo>55.784765:37.560043</club_geo>
			<club_phone>+7 (495) 940 67 55</club_phone>
			<club_logo>http://actionlist.ru/img/club/11.jpg</club_logo>
			<club_url>http://actionlist.ru/clubs/club/16_tons</club_url>
		</club>
		<images>
			<afisha>http://actionlist.ru/img/event/560.jpg</afisha>
			<afisha_small>http://actionlist.ru/img/event/560_sm.jpg</afisha_small>
		</images>
		<genres>
			<genre>heavy metal</genre>
			<genre>metal</genre>
			<genre>rock</genre>
			<genre>russian</genre>
		</genres>
		<ticket>http://ponominalu.ru/event/id/472953?promote=actionlist</ticket>
		<description>13 апреля в Москве, в клубе «Arena Moscow» состоится большой сольный концерт «Ария» - главной «тяжелой» группы страны. Теперь и московские поклонники получат возможность услышать новую программу коллектива, с которой коллектив уже активно гастролирует по стране. Предстоящий концерт «Ария» в Москве в рамках тура «Феникс» будет посвящен новому периоду в творческой жизни группы, а в частности выходу одноименной пластинки.    </description>
		<cancellation>0</cancellation>
		<url>http://actionlist.ru/events/event/aria_13.04</url>
	</event>
		...
</events>

Запрос возвращает XML структуру с описанием конкретного концерта.

Пример запроса:
https://api.actionlist.ru/v2/?GetEventInfo&id=4199&auth=%token% - возвращает описание концерта с ID 4199.


Параметры:

idID концерта в системе.

Запрос возвращает XML структуру с описанием конкретного музыкального исполнителя.

Пример запроса по ID:
https://api.actionlist.ru/v2/?GetArtistInfo&id=112&auth=%token% - возвращает описание исполнителя с ID 112.


Пример запроса по имени:
https://api.actionlist.ru/v2/?GetArtistInfo&name=2pac&auth=%token% - возвращает описание исполнителя 2pac.


Параметры:

idID исполнителя.
nameИмя исполнителя.

Пример XML-ответа:

<artistinfo>
	<id>112</id>
	<name>2Pac</name>
	<year>1990</year>
	<leader></leader>
	<country>США</country>
	<city>Нью-Йорк</city>
	<site>http://2pac.com</site>
	<download>http://rutracker.org/forum/viewtopic.php?t=3812451</download>
	<youtube>http://youtube.com/artist/2pac?feature=watch_video_title </youtube>
	<images>
		<main_photo>http://actionlist.ru/img/artist/112/0.jpg</main_photo>
		<main_photo_small>http://actionlist.ru/img/artist/112/0_sm.jpg</main_photo_small>
		<photo>http://actionlist.ru/img/artist/112/1.jpg</photo>
		<photo>http://actionlist.ru/img/artist/112/2.jpg</photo>
		<photo>http://actionlist.ru/img/artist/112/3.jpg</photo>
		<photo>http://actionlist.ru/img/artist/112/4.jpg</photo>
		<photo>http://actionlist.ru/img/artist/112/5.jpg</photo>
		<photo>http://actionlist.ru/img/artist/112/6.jpg</photo>
		<photo>http://actionlist.ru/img/artist/112/7.jpg</photo>
		<photo>http://actionlist.ru/img/artist/112/8.jpg</photo>
		<photo>http://actionlist.ru/img/artist/112/9.jpg</photo>
	</images>
	<genres>
		<genre>rap</genre>
	</genres>
	<description>Нельзя полностью рассказать о жизни Тупака.....</description>
	<url>http://actionlist.ru/artists/artist/2pac</url>
</artistinfo>

Запрос возвращает XML структуру со списком музыкальных исполнителей, которые соответствуют критерию.

Пример поиска по Имени:
https://api.actionlist.ru/v2/?SearchArtist&name=Band&auth=%token% - возвращает список исполнителей со словом "Band" в названии.


Пример поиска по Жанру:
https://api.actionlist.ru/v2/?SearchArtist&genre=1&auth=%token% - возвращает список исполнителей определенного жанра(жанр с ID 1).


Параметры:

nameИмя исполнителя.
genreID музыкального жанра.

Пример XML-ответа:

<searchartist>
	<artist>
		<id>2416</id>
		<name>Band of Horses</name>
	</artist>
	<artist>
		<id>2419</id>
		<name>Banda Bassotti</name>
	</artist>
	...
</searchartist>

Запрос возвращает XML структуру со списком исполнителей, музыкальный репертуар которых близок к репертуару указанного музыканта.

Параметры:

nameИмя исполнителя.
IDID исполнителя.

Пример поиска по Имени:
https://api.actionlist.ru/v2/?GetSimilarArtists&name=2pac&auth=%token% - возвращает список исполнителей похожих на 2pac.


Пример поиска по ID:
https://api.actionlist.ru/v2/?GetSimilarArtists&id=112&auth=%token% - возвращает список исполнителей похожих на исполнителя с ID 112.


Пример XML-ответа:

<similarartists>
	<artist>
		<id>23637</id>
		<name>Thug Life</name>
	</artist>
	<artist>
		<id>17001</id>
		<name>Outlawz</name>
	</artist>
	...
</similarartists>

Запрос возвращает XML структуру с описанием конкретного мероприятия.

Пример запроса:
https://api.actionlist.ru/v2/?GetClubs=all&auth=%token% - возвращает описание всех клубов.

Пример XML-ответа:

<clubs>
	<club>
		<id>1</id>
		<name>FM Club</name>
		<city>1</city>
		<adress>Земляной вал, д. 60/28</adress>
		<metro>Таганская</metro>
		<geo>55.752485:37.656234</geo>
		<site>http://fm-club.su/</site>
		<phone>+7(495) 502-99-21 </phone>
		<images>
			<club_logo>http://actionlist.ru/img/club/1.jpg</club_logo>
			<club_logo_small>http://actionlist.ru/img/club/1_sm.jpg</club_logo_small>
		</images>
		<description>First Music Club - музыкальный ночной клуб Москвы, который продолжает хорошую традицию клубов, созданных профессионалами для профессионалов.</description>
		<url>http://actionlist.ru/clubs/club/fm_club</url>
	</club>
	....
</clubs>

Запрос возвращает XML структуру с описанием конкретного клуба.

Пример запроса:
https://api.actionlist.ru/v2/?GetClubInfo&id=1&auth=%token% - возвращает описание клуба с ID 1.

Параметры:

IDID клуба.

Запрос возвращает XML структуру со списком музыкальных жанров.

Пример запроса:
https://api.actionlist.ru/v2/?GetGenres&auth=%token% - возвращает список всех музыкальных жанров.


Пример XML-ответа:

<genres>
	<genre>
		<id>1</id>
		<name>8 bit</name>
	</genre>
	<genre>
		<id>2</id>
		<name>acid</name>
	</genre>
	...
</genres>

29.05.2015 в запросы GetEvents и GetEventInfo добавлен тег ticket, который содержит ссылку на покупку билета на концерт.


ActionList API может быть доработан под требования конкретного заказчика.

В данный момент идет разработка следующего функционала для API:

  • Функция получения информации об альбомах исполнителей.
  • Функция получения Youtube-кодов клипов исполнителей.
  • JS-информеры о концертах для исполнителей и клубов.