Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

EveryInfra
Поиск⌘K
Русский
ВойтиНачать бесплатно

API Spotify Сведения об исполнителе

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Получите описание исполнителя Spotify, жанры, число слушателей в месяц, подписчиков и мировую позицию, а также топ-треки, топ-города и похожих исполнителей. Передайте ссылку на исполнителя, URI spotify:artist: или просто ID. Цифры являются снимком на определённый момент, а не доходом или историей.

Spotify Artist details читает страницу одного исполнителя и возвращает имя, биографию, изображения, число ежемесячных слушателей, подписчиков, место в мировом рейтинге, жанры, число альбомов, синглов и сборников, города с наибольшим числом слушателей, популярные треки и похожих исполнителей. Используйте её, чтобы оценить исполнителя перед букингом, сделкой с брендом или подписанием контракта, планировать туры и продвижение с учётом того, где находится аудитория, или регулярно фиксировать охват исполнителя и следить за его изменением.

Передайте ссылку open.spotify.com/artist/, URI spotify:artist: или просто ID исполнителя. monthly_listener_count — основной показатель популярности исполнителя в Spotify, а follower_count считает людей, подписанных на исполнителя; null в нём означает, что значение скрыто, а не равно нулю. related_artists перечисляет исполнителей, которых Spotify рекомендует вместе с выбранным исполнителем. Это удобная отправная точка для поиска похожих исполнителей или составления списка конкурентов. genres содержит жанровые теги исполнителя.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Spotify Сведения об исполнителе (spotify/artist).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: spotify и action: artist, а параметры передайте в params.
- Обязательные параметры:
  - url: Ссылка open.spotify.com, URI spotify:type:ID или ID сущности, соответствующие выбранному действию (artist, track, album или playlist).
- Возвращает один объект. Основные поля: id, url, name, bio, monthly_listener_count, follower_count, world_rank, genres, image_url, header_image_url, album_count, single_count; всего полей: 16, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=spotify.
- Пример тела запроса:
{
  "platform": "spotify",
  "action": "artist",
  "params": {
    "url": "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4"
  }
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

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

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

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаspotifyИдентификатор платформы, фиксированное значение.
actionbodystringДаartistИдентификатор возможности, фиксированное значение.
urlbody.paramsstringДа-Ссылка open.spotify.com, URI spotify:type:ID или ID сущности, соответствующие выбранному действию (artist, track, album или playlist). Тип входных данных должен соответствовать действию эндпоинта, подставлять один тип вместо другого нельзя. Устаревшие эндпоинты профиля принимают полные ссылки Spotify и возвращают метаданные альбомов и синглов, а не данные пользовательского аккаунта.

Примеры кода

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "spotify",
  "action": "artist",
  "params": {
    "url": "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

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

Реальный ответ

Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты). id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json
{
  "id": "req_…",
  "platform": "spotify",
  "action": "artist",
  "results": {
    "id": "3TVXtAsR1Inumwj472S9r4",
    "url": "https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4",
    "name": "Drake",
    "bio": "Canadian rapper and vocalist Drake has retained a bigger-than-life commercial presence shortly after he hit the scene in 2006, whether with his own chart-topping releases or with a long string of guest appearances on hits by the likes of Lil Wayne, Rihanna, and A$AP Rocky. Thanks…",
    "monthly_listener_count": 94742524,
    "follower_count": 117306577,
    "world_rank": 8,
    "image_url": "https://i.scdn.co/image/ab6761610000e5eb4293385d324db8558179afd9",
    "album_count": 21,
    "single_count": 65,
    "compilation_count": 0,
    "top_cities": [
      {
        "city": "London",
        "country": "GB",
        "region": "ENG",
        "listener_count": 1974592
      },
      {
        "city": "Los Angeles",
        "country": "US",
        "region": "CA",
        "listener_count": 1420388
      },
      {
        "city": "New York City",
        "country": "US",
        "region": "NY",
        "listener_count": 1385812
      }
    ],
    "top_tracks": [
      {
        "id": "514joG57v4yKTsfQmz7stz",
        "url": "https://open.spotify.com/track/514joG57v4yKTsfQmz7stz",
        "name": "Janice STFU",
        "duration_ms": 237344,
        "play_count": 342725993,
        "is_explicit": true,
        "platform": "spotify"
      },
      {
        "id": "1zi7xx7UVEFkmKfv06H8x0",
        "url": "https://open.spotify.com/track/1zi7xx7UVEFkmKfv06H8x0",
        "name": "One Dance",
        "duration_ms": 173986,
        "play_count": 4484479500,
        "is_explicit": false,
        "platform": "spotify"
      },
      {
        "id": "5mCPDVBb16L4XQwDdbRUpz",
        "url": "https://open.spotify.com/track/5mCPDVBb16L4XQwDdbRUpz",
        "name": "Passionfruit",
        "duration_ms": 298940,
        "play_count": 2391474845,
        "is_explicit": true,
        "platform": "spotify"
      }
    ],
    "related_artists": [
      {
        "id": "1RyvyyTE3xzB2ZywiAwp0i",
        "name": "Future",
        "url": "https://open.spotify.com/artist/1RyvyyTE3xzB2ZywiAwp0i",
        "image_url": "https://i.scdn.co/image/ab6761610000e5eb2c472c891062acb4f3068583"
      },
      {
        "id": "0Y5tJX1MQlPlqiwlOH1tJY",
        "name": "Travis Scott",
        "url": "https://open.spotify.com/artist/0Y5tJX1MQlPlqiwlOH1tJY",
        "image_url": "https://i.scdn.co/image/ab6761610000e5eb19c2790744c792d05570bb71"
      },
      {
        "id": "7c0XG5cIJTrrAgEC3ULPiq",
        "name": "Ty Dolla $ign",
        "url": "https://open.spotify.com/artist/7c0XG5cIJTrrAgEC3ULPiq",
        "image_url": "https://i.scdn.co/image/ab6761610000e5eb4ef6e245168c33922bc6df1a"
      }
    ],
    "platform": "spotify"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
urlСсылка на запись на платформе.
nameНазвание самого объекта для возможностей по аккаунтам, товарам и компаниям.
bioОписание профиля, написанное владельцем аккаунта; может содержать переносы строк и эмодзи.
monthly_listener_countТрактуется так же, как на самой платформе
follower_countПодписчики. null означает, что значение не раскрыто, а не 0.
world_rankТрактуется так же, как на самой платформе
genresТрактуется так же, как на самой платформе
image_urlСсылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls.
header_image_urlТрактуется так же, как на самой платформе
album_countТрактуется так же, как на самой платформе
single_countТрактуется так же, как на самой платформе
compilation_countТрактуется так же, как на самой платформе
top_citiesТрактуется так же, как на самой платформе
top_tracksТрактуется так же, как на самой платформе
related_artistsТрактуется так же, как на самой платформе
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

FAQ

Что можно передать в url?

Ссылку на исполнителя, например https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4, соответствующий URI spotify:artist: или просто ID исполнителя. Каждая возможность Spotify читает один тип объектов, поэтому ссылка на трек, альбом или плейлист здесь не вернёт исполнителя; для них используйте возможности Spotify Track, Album или Playlist.

Чем ежемесячные слушатели отличаются от подписчиков?

monthly_listener_count считает людей, которые слушали исполнителя в течение месяца, и это основной показатель популярности в Spotify. follower_count считает людей, которые решили подписаться на исполнителя. Эти числа могут сильно различаться, поэтому сравнивайте исполнителей по одному и тому же показателю и сохраняйте оба.

Где сосредоточены слушатели исполнителя?

top_cities содержит города, где у исполнителя больше всего слушателей. Используйте это поле, чтобы выбирать города для тура, нацеливать локальное продвижение или проверять, закрепился ли исполнитель на рынке, прежде чем вкладываться в него.

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • Spotify: чем «ежемесячные слушатели» отличаются от «ежемесячных активных слушателей» ↗

    Spotify определяет ежемесячных слушателей как уникальных слушателей за последние 28 дней с учётом как самостоятельных прослушиваний, так и алгоритмических рекомендаций. Метрика ежемесячных активных слушателей учитывает только самостоятельные прослушивания. Поле `monthly_listener_count` на этой странице нельзя считать числом ежемесячных активных слушателей, количеством прослушиваний или числом подписчиков.

    Проверено 2026-09-04