List artists
Every credited illustrator with a card count, searchable by name.
Request
- Base URL: https://api.pokemontcgapi.com
- URL: https://api.pokemontcgapi.com/v1/artists
- Auth: API key in header X-Api-Key
Query parameters
Accent-insensitive substring match on the name, so arita finds Mitsuhiro Arita.
slug, name or card_count. Tiebreaker is slug.
Accepted snake_case spelling of orderBy; the same sort keys and cursor rules apply.
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.
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
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
Changes
No recorded changes to this operation across all 1 revision of this API.