← pesni.ru

API для разработчиков

Бесплатный открытый доступ к текстам песен, аккордам, описаниям и данным об артистах. Без ключа API. Создавайте приложения, ботов и инструменты.

Базовый URL

https://pesni.ru/api/v1

Лимиты запросов

60 запросов в минуту с одного IP-адреса. Информация о лимите передаётся в заголовках ответа:

X-RateLimit-Limit: 60 X-RateLimit-Remaining: 59

Эндпоинты

GET/api/v1/artists

Список артистов с пагинацией.

ПараметрТипОписание
searchstringПоиск по имени
pageintegerНомер страницы
curl https://pesni.ru/api/v1/artists?search=Кино
GET/api/v1/artists/{slug}

Один артист со списком треков.

curl https://pesni.ru/api/v1/artists/kino
GET/api/v1/tracks

Список треков с пагинацией.

ПараметрТипОписание
searchstringПоиск по названию
artist_idintegerФильтр по артисту
pageintegerНомер страницы
curl https://pesni.ru/api/v1/tracks?search=Звезда
GET/api/v1/tracks/{slug}

Один трек с текстом, аккордами, описанием и фактами.

curl https://pesni.ru/api/v1/tracks/zvezda-po-imeni-solntse
GET/api/v1/search

Поиск по артистам и трекам.

ПараметрТипОписание
q*stringПоисковый запрос
typestring"all", "artists" или "tracks"
limitintegerМакс. результатов на тип (по умолчанию 10, макс. 50)
curl https://pesni.ru/api/v1/search?q=Цой&type=all

Формат ответа

Все ответы в формате JSON. Эндпоинты с пагинацией возвращают стандартную структуру Laravel:

{
  "data": [...],
  "current_page": 1,
  "last_page": 42,
  "per_page": 30,
  "total": 1250
}