artists

List artists

Every credited illustrator with a card count, searchable by name.

get/v1/artists

Request

  • Base URL: https://api.pokemontcgapi.com
  • URL: https://api.pokemontcgapi.com/v1/artists
  • Auth: API key in header X-Api-Key

Query parameters

qstring

Accent-insensitive substring match on the name, so arita finds Mitsuhiro Arita.

orderBystring

slug, name or card_count. Tiebreaker is slug.

order_bystring

Accepted snake_case spelling of orderBy; the same sort keys and cursor rules apply.

limitinteger

Rows per page, 1 to 250. Card and sealed lists cost 1 credit per 50 rows requested, rounded up: 50 costs 1, 51 costs 2, 250 costs 5, so ask for multiples of 50. Above 250 you get LIMIT_EXCEEDED — follow links.next instead of raising it.

cursorstring

Opaque keyset cursor from links.next. Never construct one; it carries the sort order it was issued for and is rejected if orderBy changes mid-run.

Headers

If-None-Matchstring

Send back the ETag you stored. The API returns a strong ETag on every catalogue response, and a 304 is a header exchange: no body, no database row read.

Response

Success

object required

Changes

No recorded changes to this operation across all 1 revision of this API.