# Spotify API

检索 Spotify 曲目、艺人、专辑、歌单与播客，区分发行物、歌单创建者和节目单集，整理公开元数据及可得的听众、曲目指标，不涉及播放控制。

- Domain: social · 7 data actions
- Canonical page: https://everyinfra.com/spotify-api
- Failures and empty results never form a final charge.

## Actions

### profile — 主页或对象详情
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: id, url, name, type, release_date, label, artists, image_url, track_count, tracks, platform

### search — 关键词搜索
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: keyword

- Optional: content_type
- Allowed values: content_type (albums/artists/playlists/tracks)

- Returns fields: id, url, type, name, text, artists, album_name, owner_name, publisher, image_url, duration_ms, play_count, follower_count, monthly_listener_count, track_count, episode_count, release_date, is_explicit, preview_url, rank, platform

### artist — 艺人或创作者资料
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: id, url, name, bio, monthly_listener_count, follower_count, world_rank, genres, image_url, header_image_url, album_count, single_count, compilation_count, top_cities, top_tracks, related_artists, platform

### track — 单曲详情
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: id, url, name, artists, album_name, duration_ms, play_count, track_number, disc_number, is_explicit, release_date, preview_url, image_url, added_at, platform, album_id, album_type, label, content_rating

### album — 专辑
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: id, url, name, album_type, artists, release_date, label, copyright, track_count, image_url, tracks, platform

### playlist — 播放列表
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: id, url, name, text, owner_name, save_count, follower_count, track_count, image_url, tracks, platform

### podcast — 播客
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: keyword

- Optional: content_type
- Allowed values: content_type (podcast_episodes_individual_episodes/podcasts_shows)

- Returns fields: id, url, type, name, text, artists, album_name, owner_name, publisher, image_url, duration_ms, play_count, follower_count, monthly_listener_count, track_count, episode_count, release_date, is_explicit, preview_url, rank, platform

## Also

- Machine catalog (no key): https://everyinfra.com/openapi.json · GET /api/v1/social/catalog
- Agents guide: https://everyinfra.com/agents.md