Skip to documentation
Developers
DOCUMENTATIONAPI referenceCatalogList sets
CATALOG / V1

List sets

List the sets within one product line, including catalog counts and slugs for narrowing searches.

GET/v1/categories/{category}/sets
Bearer key requiredJSON response
Example requestv1
curl --request GET \  --url 'https://pokepos-market-api.vercel.app/v1/categories/pokemon/sets' \  --header 'Authorization: Bearer YOUR_API_KEY'
Response illustrative JSON
{  "source": "tcgplayer-public-site",  "category": "pokemon",  "totalProducts": 1000,  "coveredBySets": 900,  "sets": [    {      "name": "30th Celebration",      "slug": "30th-celebration",      "count": 100    }  ]}
Example values can change with the source.
REQUEST

Parameters

Pass path parameters in the URL and query parameters after ?.

categorystringrequiredpath

Product line slug returned by the categories route, such as pokemon. Example: pokemon.

RESPONSE

Response object

Sets and source counts for the product line. The root schema is SetList.

sourcestring

Name of the market data source.

categorystring

Product line or category for this result.

totalProductsinteger

Number of products in the category.

coveredBySetsinteger

Products represented by the returned set list.

setsSet[]

Sets found within this product line.

SCHEMAS

Related objects

Expand a type to inspect its fields.

Set3 fields
namestring

Display name from the source catalog.

slugstring

URL-safe identifier for a category or set.

countinteger

Number of catalog products in the set.

HTTP

Status codes

200

Sets and source counts for the product line.

400

Invalid parameter or request body.

502

An upstream market source is unavailable.

Errors use the error.code and error.message shape. Keep the x-request-id response header for support and tracing.

PREVIOUSList product linesNEXTSearch products