Changes

A list of breaking and non-breaking changes to the v2 API.

🚧

The artist.tools API is in BETA and subject to change

Although we work hard to avoid breaking changes, the v2 API is still in beta and may evolve as we continue working with developer, platform, and enterprise users.

As new use cases come up, we may expand or adjust the available endpoints, request parameters, response schemas, data models, and related API behavior. These changes are usually additive and are intended to improve the API without disrupting existing implementations.

To date, we have not introduced any breaking changes to the v2 API, and we are committed to keeping it that way whenever possible. New endpoints, fields, filters, or response data should not break existing integrations.

If a breaking change ever becomes necessary, we will notify affected users in advance, document the change clearly, and support backwards compatibility for as long as reasonably possible.

---

June 10th, 2026

Changes:

• Added excludeOwnerIds to /playlists/search endpoint, which supports excluding a list of Spotify User IDs.
• Added idsOwnerOperator to /playlists/search endpoint, which accepts and or or (defaults to and). This allows for defining how passing ids and ownerIds together behaves.

Breaking changes:

• None

May 29th, 2026

Changes:

• Added POST /keywords/multiple endpoint to bulk-fetch keywords. This is a read-only endpoint.
• Added GET /tracks/isrc/:isrc endpoint to fetch a track by ISRC.
• Added GET /tracks/isrc/:isrc/occurences endpoint to fetch all live duplicate releases by ISRC.
• Added GET /tracks/ai-content endpoint to fetch AI-content ratings against an ISRC or Spotify Track ID.
• Announced "in testing" set of Enterprise endpoints for platforms, labels, & distribution teams, like:
  • Sync playlist dataset: Keep our playlist dataset (fraud or all) in sync with your local collection.
  • Flagged playlists for artists: Return a full list of high-risk playlist appearances for up to 1,000 artists at once.
  • Flagged playlists for tracks: Return a full list of high-risk playlist appearances for up to 1,000 tracks at once.
  • Bulk-vet playlists by Spotify ID: Return a quality breakdown ("is this artificially grown? why?") for up to 1,000 playlists at once.

Breaking changes:

• None