# Partita

> Free, keyless artist-resolution API. Give it any artist URL (Spotify, Apple Music, YouTube, Instagram, TikTok, X/Twitter, SoundCloud, Amazon Music, Wikipedia) and get back a canonical artist identity — a permanent `art_` ID — plus the artist's full cross-platform link graph, followers, popularity, genres and images. Catalog of 2.6M+ artists. One GET request, JSON in and out, open CORS, no auth.

Base URL: `https://api.partita.io/v1`
OpenAPI spec: https://api.partita.io/v1/openapi.json
Rate limit: 60 requests/minute per IP (429 `{"error":"rate_limited"}` with Retry-After when exceeded).
Errors are always JSON with a machine-readable `error` code: `invalid_request`, `invalid_url`, `unsupported_platform`, `not_found`, `rate_limited`, `internal_error`.
Stability: `art_` IDs are permanent and never recycled; within /v1, response fields are only added, never removed.

## Endpoints

- GET /v1/resolve?url={artist_url}: Resolve any supported artist URL to the canonical artist. Returns `{ match: { platform, externalId, url, verified }, artist }`. On 404/unsupported platforms, returns name-based `suggestions`.
  Example: `curl "https://api.partita.io/v1/resolve?url=https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02"`
- GET /v1/artists/{id}: Fetch an artist by its permanent `art_` ID. Pure cached read.
  Example: `curl "https://api.partita.io/v1/artists/art_2Fw8XoYb3kQpVZC"`

## Artist object

`{ id, name, genres: string[], imageUrl, images: [{ url, width, height }], links: [{ platform, url, verified }], spotify: { followers, popularity, monthlyListeners, worldRank, updatedAt } | null, updatedAt }` — `links` covers 40+ detected platform types (instagram, tiktok, youtube, bandcamp, deezer, tidal, facebook, discogs, …) and works as a schema.org `sameAs` graph. Timestamps are ISO 8601; `verified` is a boolean (true = editorially verified, false = scraped).

## Docs

- [API reference](https://partita.io/docs): Human-readable docs with copy-pasteable curl for every endpoint, response shapes, error codes, rate limits and the stability promise.
- [OpenAPI 3.1 spec](https://api.partita.io/v1/openapi.json): Machine-readable spec of every endpoint and schema.