Endpoint Playground

Try the PSA Price Guide set search API

Searches PSA Price Guide by set name (for example "1974 topps" or "super bowl") using PSA's own browse-by-category pages. It matches set names only: it does not search card or player names, and results carry no card items. Use psa-price-guide-search for card and player search while PSA's own search is available. Every word of the query must start a word of the set name; exact and leading matches rank first. Each result's category_path, set_path and set_id are the inputs to psa-price-guide-set. Set lists are cached for 12 hours, so a first call after a cold start can take longer. If a category's set list cannot be loaded, the other categories still answer and unavailable_categories names the missing ones.

What a live request returned

29 Oct 2026: 6 sets; 5 fields had a value in every checked item.

Observed request: GET /psa/price-guide/sets?query=1974+topps&page_size=20
Fields with a value in every checked item: set_id, set_name, category_name, category_path, set_path

Sample value profiles: set_name: 1974 Topps (4), 1974 Topps Deckle Edge (1), 1974 Topps Stamps (1); category_name: “Baseball Cards” and 3 other values; category_path: “baseball-card-values” and 3 other values.

Request: GET /psa/price-guide/sets
Cost: 3 credits/request
Auth: apiKey

PSA Price Guide set search API documentation PSA platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/psa/price-guide/sets?query=1974+topps&category_path=baseball-card-values' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	Yes	1974 topps	Set-name search term, e.g. 1974 topps
category_path	string	No	baseball-card-values	Restrict to one category. Allowed values: baseball-card-values, basketball-card-values, boxing-card-values, football-card-values, golf-card-values, hockey-card-values, soccer-card-values, non-sports-tcg-card-values, racing-card-values, sports-ticket-values, tennis-card-values, unopened-pack-values, presidential-autograph-values, sports-autograph-values, game-used-bat-values, graded-baseball-values. Default: every category.
page	integer	No		One-based result page, default 1
page_size	integer	No		Sets per page, default 50, max 100

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "1974 topps",
    "page": 1,
    "page_size": 50,
    "total_count": 6,
    "sets": [
      {
        "set_id": 1239,
        "set_name": "1974 Topps",
        "category_name": "Baseball Cards",
        "category_path": "baseball-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 1708,
        "set_name": "1974 Topps",
        "category_name": "Basketball Cards",
        "category_path": "basketball-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 694,
        "set_name": "1974 Topps",
        "category_name": "Football Cards",
        "category_path": "football-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 1576,
        "set_name": "1974 Topps",
        "category_name": "Hockey Cards",
        "category_path": "hockey-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 1240,
        "set_name": "1974 Topps Deckle Edge",
        "category_name": "Baseball Cards",
        "category_path": "baseball-card-values",
        "set_path": "1974-topps-deckle-edge"
      },
      {
        "set_id": 2491,
        "set_name": "1974 Topps Stamps",
        "category_name": "Baseball Cards",
        "category_path": "baseball-card-values",
        "set_path": "1974-topps-stamps"
      }
    ]
  }
}

More PSA endpoints

List PSA AutographFacts categories Get a PSA AutographFacts subject's exemplar image gallery Get a PSA AutographFacts subject's profile and price guide List PSA AutographFacts subjects in a category List PSA CardFacts categories Get a PSA CardFacts set's card checklist List PSA CardFacts sets in a category Verify a PSA certification number List PSA Price Guide categories Search PSA Price Guide Get a PSA Price Guide set's price table List PSA ProBatFacts categories All 20 PSA endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestpsa.priceGuideSetsResponseDocPSA

GET /psa/price-guide/sets

Search PSA Price Guide set names

Response behavior

- Use a result's `category_path`, `set_path` and `set_id` as the input to `psa-price-guide-set` to fetch that set's full price table. - Ranking: sets whose name equals the query come first, then names that start with the query, then the rest in PSA's own order. - `total_count` is every match across all pages. A query with no match returns `200` with `total_count` 0 and an empty `sets` list. - Each category's set list is cached for 12 hours, so the first call after a quiet period (or a restart) can be slower than later ones. The 16 categories hold about 2,900 sets; new sets appear after the cache refreshes. - If one category's set list cannot be loaded, the other categories still answer and `unavailable_categories` names the missing ones, so `sets` and `total_count` cover the remaining categories only. A request fails with `503` only when no category could be loaded. - `category_name` is the category's display name from `psa-price-guide-categories`, for example `Baseball Cards`. Example response (a live `query=1974 topps` result, checked 2026-10-25): ```json { "code": 200, "msg": "OK", "data": { "query": "1974 topps", "page": 1, "page_size": 50, "total_count": 6, "sets": [ { "set_id": 1239, "set_name": "1974 Topps", "category_name": "Baseball Cards", "category_path": "baseball-card-values", "set_path": "1974-topps" }, { "set_id": 1708, "set_name": "1974 Topps", "category_name": "Basketball Cards", "category_path": "basketball-card-values", "set_path": "1974-topps" }, { "set_id": 694, "set_name": "1974 Topps", "category_name": "Football Cards", "category_path": "football-card-values", "set_path": "1974-topps" }, { "set_id": 1576, "set_name": "1974 Topps", "category_name": "Hockey Cards", "category_path": "hockey-card-values", "set_path": "1974-topps" }, { "set_id": 1240, "set_name": "1974 Topps Deckle Edge", "category_name": "Baseball Cards", "category_path": "baseball-card-values", "set_path": "1974-topps-deckle-edge" }, { "set_id": 2491, "set_name": "1974 Topps Stamps", "category_name": "Baseball Cards", "category_path": "baseball-card-values", "set_path": "1974-topps-stamps" } ] } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

query

requiredstring

Set-name search term, e.g. 1974 topps

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "1974 topps",
    "page": 1,
    "page_size": 50,
    "total_count": 6,
    "sets": [
      {
        "set_id": 1239,
        "set_name": "1974 Topps",
        "category_name": "Baseball Cards",
        "category_path": "baseball-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 1708,
        "set_name": "1974 Topps",
        "category_name": "Basketball Cards",
        "category_path": "basketball-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 694,
        "set_name": "1974 Topps",
        "category_name": "Football Cards",
        "category_path": "football-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 1576,
        "set_name": "1974 Topps",
        "category_name": "Hockey Cards",
        "category_path": "hockey-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 1240,
        "set_name": "1974 Topps Deckle Edge",
        "category_name": "Baseball Cards",
        "category_path": "baseball-card-values",
        "set_path": "1974-topps-deckle-edge"
      },
      {
        "set_id": 2491,
        "set_name": "1974 Topps Stamps",
        "category_name": "Baseball Cards",
        "category_path": "baseball-card-values",
        "set_path": "1974-topps-stamps"
      }
    ]
  }
}

Try the PSA Price Guide set search API

What a live request returned

29 Oct 2026: 6 sets; 5 fields had a value in every checked item.

Observed request: GET /psa/price-guide/sets?query=1974+topps&page_size=20
Fields with a value in every checked item: set_id, set_name, category_name, category_path, set_path

Request: GET /psa/price-guide/sets
Cost: 3 credits/request
Auth: apiKey

PSA Price Guide set search API documentation PSA platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/psa/price-guide/sets?query=1974+topps&category_path=baseball-card-values' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	Yes	1974 topps	Set-name search term, e.g. 1974 topps
category_path	string	No	baseball-card-values	Restrict to one category. Allowed values: baseball-card-values, basketball-card-values, boxing-card-values, football-card-values, golf-card-values, hockey-card-values, soccer-card-values, non-sports-tcg-card-values, racing-card-values, sports-ticket-values, tennis-card-values, unopened-pack-values, presidential-autograph-values, sports-autograph-values, game-used-bat-values, graded-baseball-values. Default: every category.
page	integer	No		One-based result page, default 1
page_size	integer	No		Sets per page, default 50, max 100

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "1974 topps",
    "page": 1,
    "page_size": 50,
    "total_count": 6,
    "sets": [
      {
        "set_id": 1239,
        "set_name": "1974 Topps",
        "category_name": "Baseball Cards",
        "category_path": "baseball-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 1708,
        "set_name": "1974 Topps",
        "category_name": "Basketball Cards",
        "category_path": "basketball-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 694,
        "set_name": "1974 Topps",
        "category_name": "Football Cards",
        "category_path": "football-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 1576,
        "set_name": "1974 Topps",
        "category_name": "Hockey Cards",
        "category_path": "hockey-card-values",
        "set_path": "1974-topps"
      },
      {
        "set_id": 1240,
        "set_name": "1974 Topps Deckle Edge",
        "category_name": "Baseball Cards",
        "category_path": "baseball-card-values",
        "set_path": "1974-topps-deckle-edge"
      },
      {
        "set_id": 2491,
        "set_name": "1974 Topps Stamps",
        "category_name": "Baseball Cards",
        "category_path": "baseball-card-values",
        "set_path": "1974-topps-stamps"
      }
    ]
  }
}

Search PSA Price Guide set names

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "query": "1974 topps", "page": 1, "page_size": 50, "total_count": 6, "sets": [ { "set_id": 1239, "set_name": "1974 Topps", "category_name": "Baseball Cards", "category_path": "baseball-card-values", "set_path": "1974-topps" }, { "set_id": 1708, "set_name": "1974 Topps", "category_name": "Basketball Cards", "category_path": "basketball-card-values", "set_path": "1974-topps" }, { "set_id": 694, "set_name": "1974 Topps", "category_name": "Football Cards", "category_path": "football-card-values", "set_path": "1974-topps" }, { "set_id": 1576, "set_name": "1974 Topps", "category_name": "Hockey Cards", "category_path": "hockey-card-values", "set_path": "1974-topps" }, { "set_id": 1240, "set_name": "1974 Topps Deckle Edge", "category_name": "Baseball Cards", "category_path": "baseball-card-values", "set_path": "1974-topps-deckle-edge" }, { "set_id": 2491, "set_name": "1974 Topps Stamps", "category_name": "Baseball Cards", "category_path": "baseball-card-values", "set_path": "1974-topps-stamps" } ] } }