PSA Price Guide set search API

Endpoint facts

Method

GET

API path

/psa/price-guide/sets

Auth

apiKey

Credits

3 credits/request

Charged on

Successful 2xx responses only

Platform

PSA

Response schema

#/definitions/psa.priceGuideSetsResponseDoc

How this endpoint behaves

Query parameters:

• query (required) — a set-name search term. Every word of the query must start a word of the set name (74 does not match 1974, 1974 top does match 1974 Topps). Case and punctuation are ignored.
• category_path (optional) — restrict the search to one category. Default: every 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. These are the path values psa-price-guide-categories returns. Any other value returns a 400.
• page (optional) — one-based result page, default 1.
• page_size (optional) — sets per page, default 50, max 100.

Notable 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):

{
  "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"
      }
    ]
  }
}

Sampled response

Request, 29 Oct 2026

GET /psa/price-guide/sets?query=1974+topps&page_size=20

Items in sets

6

Fields filled in every checked item

5

Shared guides

Related