API Spotify Трек

Промпт для ИИ

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

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

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

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

Примеры кода

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": "track",
  "params": {
    "url": "https://open.spotify.com/track/0BeoYJ8te2AtohPr7I3SZD"
  }
}'

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

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

{
  "id": "req_…",
  "platform": "spotify",
  "action": "track",
  "results": {
    "id": "0BeoYJ8te2AtohPr7I3SZD",
    "url": "https://open.spotify.com/track/0BeoYJ8te2AtohPr7I3SZD",
    "name": "Almost Real",
    "artists": [
      "Anarekli"
    ],
    "album_name": "Almost Real",
    "duration_ms": 163926,
    "play_count": 6671478,
    "track_number": 1,
    "is_explicit": false,
    "release_date": "2026-04-10T00:00:00Z",
    "preview_url": "https://p.scdn.co/mp3-preview/d04815deef2e2f3d5f6daba6cd63ebe4081802f4",
    "image_url": "https://i.scdn.co/image/ab67616d0000b273eab6ddcdb5e835d8c962265d",
    "platform": "spotify",
    "album_id": "5nFzrSca3XC5kHbq2gyRiz",
    "album_type": "SINGLE",
    "content_rating": "NONE"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

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

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

401

Ключ отсутствует или недействителен.

402

Недостаточно средств на балансе. Сначала пополните баланс.

422

Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.

429

Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.

503

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

200 (пусто)

Нет данных. Без списания.

Ошибки

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

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

• Spotify: сам по себе ID не указывает тип ресурса ↗

  Официальная документация отмечает, что сам по себе ID Spotify без контекста вызова не указывает тип ресурса, тогда как URI содержит информацию о типе. Выбранное действие, путь URL и тип целевого ID должны соответствовать друг другу: строковый ID не преобразуется автоматически из одного типа ресурса в другой.

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

• Spotify: треки, родительские альбомы и границы использования контента ↗

  Официальная документация Spotify по трекам разделяет объекты `track` и `album` и описывает ограничения на указание авторства, скачивание и обучение моделей. Запрос метаданных через этот эндпоинт не даёт ни скачивания полного аудио, ни права на обучение ИИ; официальные поля платформы и параметры `market` не входят в этот эндпоинт автоматически.

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