SocialPlatform secret

Spotify

spotify.com

Spotify Web API provider for catalog search and entity lookup.

Tier: 🥉 Bronze
Reward: ₩50,000
Auth: Platform secret
Operations: 3
Working now: 0 contributors
Status: Open

Scope

Search the Spotify catalog and look up tracks and artists by id over plain HTTP with client-credentials OAuth. Results expose catalog objects such as tracks.items, artists.items, album, duration_ms, and popularity.

Expected operations

search-catalogSearch catalogreadDifficulty: easy

Search Spotify catalog objects by query text and type, returning typed result blocks with stable totals and track metadata when present. Backed by the Spotify Web API search API.

Inputs

querystringrequired

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

typestringrequired

Comma-separated result types such as track, artist, album, or playlist.

track,artist

limitnumberoptional

Maximum number of items to return per type.

offsetnumberoptional

Pagination offset for result sets.

Outputs

tracksartistsalbumsplaylistsitemshreftotal

Acceptance

Returns typed result blocks for the requested content types and preserves total counts.
Includes track items with id, name, artists.name, album.name, duration_ms, and popularity when searching tracks.
Requires a valid OAuth token and both a query and a content type.

Auth required for this operation.

get-trackGet trackreadDifficulty: easy

Fetch a single Spotify track by id and return canonical track metadata, including album and artist information. Backed by the Spotify Web API track API.

Inputs

idstringrequired
Spotify track id.
11dFghVXANMlKmJXsNCbNl

Outputs

idnameartistsalbumduration_mspopularity

get-artistGet artistreadDifficulty: easy

Fetch one Spotify artist record by id and return canonical artist metadata rather than search snippets. Backed by the Spotify Web API artist API.

Inputs

idstringrequired
Spotify artist id.
1vCWHaC5f2uS3yhpwWbIA6

Outputs

idnamegenresfollowerspopularityimages

Acceptance

Returns the track record identified by id with a stable id field in the payload.
Includes nested artists entries with name values and an album object with its own name field.
Fails with an error when the id is missing or does not resolve to a track.

Auth required for this operation.

Acceptance

Returns a single artist record whose id matches the requested identifier.
Exposes followers and popularity fields when the artist record is available.
Requires a valid OAuth token and does not accept anonymous access.

Auth required for this operation.