Search sets

Search for one or many sets given a search query.

HTTP Request#

GET https://api.pokemontcg.io/v2/sets

URL Parameters#

None

Body Parameters#

None

Query Parameters#

All query parameters are optional.

Parameter	Description	Default Value
q	The search query. Examples can be found below.
page	The page of data to access.	1
pageSize	The maximum amount of cards to return.	250 (max of 250)
orderBy	The field(s) to order the results by. Examples can be found below.
select	A comma delimited list of fields to return in the response (ex. ?select=id,name). By default, all fields are returned if this query parameter is not used.

Look at the /cards endpoint for more details on the advanced query syntax.

Code Samples#

Python
Ruby
Javascript
cURL

# Get all sets
sets = Set.all()

# Filter sets
sets = Set.where(q='legailities.standard:legal')

# Get a specific page of data
sets = Set.where(page=2, pageSize=10)

Sample Response#

{
  "data": [
    {
      "id": "base1",
      "name": "Base",
      "series": "Base",
      "printedTotal": 102,
      "total": 102,
      "legalities": {
        "unlimited": "Legal"
      },
      "ptcgoCode": "BS",
      "releaseDate": "1999/01/09",
      "updatedAt": "2020/08/14 09:35:00",
      "images": {
        "symbol": "https://images.pokemontcg.io/base1/symbol.png",
        "logo": "https://images.pokemontcg.io/base1/logo.png"
      }
    },
    {...},
    {...}
  ],
  "page": 1,
  "pageSize": 250,
  "count": 123,
  "totalCount": 123
}