Docs menu

PSA API endpoint

PSA Price Guide search API

Searches PSA Price Guide by free text (a player/subject name or set name), matching PSA's own site search box. Each result is a matching set with the query's matching cards/items inside it; 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.

GETapiKey3 credits/requestPSApsa.priceGuideSearchResponseDoc/psa/price-guide/search

Endpoint facts

Method: GET
API path: /psa/price-guide/search
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: PSA
Response schema: #/definitions/psa.priceGuideSearchResponseDoc

PSA Scraper API Try PSA Price Guide search API in Playground PSA API documentation

How this endpoint behaves

Query parameters:

query (required) — a free-text search term, e.g. a player/subject name or set name, e.g. griffey.
page (optional) — one-based result page, default 1.
page_size (optional) — results (matching sets) per page, default 50, max 100.

Notable response behavior:

If this endpoint returns a 503 because PSA's own search is unavailable, use psa-price-guide-sets to find a set by name instead; it does not match card or player names.
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.
items lists only the cards within that set that matched the query, not the set's full checklist — call psa-price-guide-set for the complete set.

Live monitoring

Monitored request: GET /psa/price-guide/search?query=griffey
Checks passed, 7 days to 14 Oct 2026: 99.9%
Median response time: 5.60 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /psa/price-guide/search?query=griffey&page_size=20
Items in results: 20
Fields filled in every checked item: 6

Field	Filled in, of 20 checked	Values in the sample
set_id	20
set_name	20	“1974 Topps” and 19 other values
category_name	20	Baseball Card Values in all 20
category_path	20	baseball-card-values in all 20
set_path	20	“1974-topps” and 19 other values
items	20	median 1 entry

Request parameters

Parameter	Type	Required	Description	Example
query	string	Yes	Free-text search term, e.g. a player/subject name or set name	griffey
page	integer	No	One-based result page, default 1
page_size	integer	No	Results per page, default 50, max 100
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/psa/price-guide/search?query=griffey&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "griffey",
    "page": 1,
    "page_size": 10,
    "total_count": 55,
    "results": [
      {
        "set_id": 1239,
        "set_name": "1974 Topps",
        "category_name": "Baseball Card Values",
        "category_path": "baseball-card-values",
        "set_path": "1974-topps",
        "items": [
          {
            "item_id": 47874,
            "name": "Ken Griffey, Sr. (R)"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/psa.priceGuideSearchResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	psa.PriceGuideSearchResponse	No
data.page	integer	No
data.page_size	integer	No
data.query	string	No
data.results	array	No
data.results[].category_name	string	No		CategoryName is PSA's own category display name for this set, e.g. "Baseball Card Values".
data.results[].category_path	string	No		CategoryPath is the category's URL path segment -- pass as category_path to psa-price-guide-set.
data.results[].items	array	No		Items are the matching cards/items within this set.
data.results[].items[].item_id	integer	No		ItemID is PSA's own numeric item id.
data.results[].items[].name	string	No		Name is the card/item's own descriptive name, e.g. "Ken Griffey, Sr. (R)".
data.results[].set_id	integer	No		SetID is PSA's own numeric set id -- pass as set_id to psa-price-guide-set along with CategoryPath and SetPath.
data.results[].set_name	string	No		SetName is the set's display name, e.g. "1974 Topps".
data.results[].set_path	string	No		SetPath is the set's own URL path segment -- pass as set_path to psa-price-guide-set.
data.total_count	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/psa/price-guide/search?query=griffey&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More PSA endpoint docs PSA Scraper API PSA AutographFacts categories API documentation PSA AutographFacts Gallery API documentation PSA AutographFacts Profile API documentation PSA AutographFacts subjects API documentation PSA CardFacts categories API documentation PSA CardFacts checklist API documentation

Open in Playground Back to group

Docs menu

PSA API endpoint

PSA Price Guide search API

GETapiKey3 credits/requestPSApsa.priceGuideSearchResponseDoc/psa/price-guide/search

Endpoint facts

Method: GET
API path: /psa/price-guide/search
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: PSA
Response schema: #/definitions/psa.priceGuideSearchResponseDoc

PSA Scraper API Try PSA Price Guide search API in Playground PSA API documentation

How this endpoint behaves

Query parameters:

query (required) — a free-text search term, e.g. a player/subject name or set name, e.g. griffey.
page (optional) — one-based result page, default 1.
page_size (optional) — results (matching sets) per page, default 50, max 100.

Notable response behavior:

If this endpoint returns a 503 because PSA's own search is unavailable, use psa-price-guide-sets to find a set by name instead; it does not match card or player names.
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.
items lists only the cards within that set that matched the query, not the set's full checklist — call psa-price-guide-set for the complete set.

Live monitoring

Monitored request: GET /psa/price-guide/search?query=griffey
Checks passed, 7 days to 14 Oct 2026: 99.9%
Median response time: 5.60 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /psa/price-guide/search?query=griffey&page_size=20
Items in results: 20
Fields filled in every checked item: 6

Field	Filled in, of 20 checked	Values in the sample
set_id	20
set_name	20	“1974 Topps” and 19 other values
category_name	20	Baseball Card Values in all 20
category_path	20	baseball-card-values in all 20
set_path	20	“1974-topps” and 19 other values
items	20	median 1 entry

Request parameters

Parameter	Type	Required	Description	Example
query	string	Yes	Free-text search term, e.g. a player/subject name or set name	griffey
page	integer	No	One-based result page, default 1
page_size	integer	No	Results per page, default 50, max 100
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/psa/price-guide/search?query=griffey&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "griffey",
    "page": 1,
    "page_size": 10,
    "total_count": 55,
    "results": [
      {
        "set_id": 1239,
        "set_name": "1974 Topps",
        "category_name": "Baseball Card Values",
        "category_path": "baseball-card-values",
        "set_path": "1974-topps",
        "items": [
          {
            "item_id": 47874,
            "name": "Ken Griffey, Sr. (R)"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/psa.priceGuideSearchResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	psa.PriceGuideSearchResponse	No
data.page	integer	No
data.page_size	integer	No
data.query	string	No
data.results	array	No
data.results[].category_name	string	No		CategoryName is PSA's own category display name for this set, e.g. "Baseball Card Values".
data.results[].category_path	string	No		CategoryPath is the category's URL path segment -- pass as category_path to psa-price-guide-set.
data.results[].items	array	No		Items are the matching cards/items within this set.
data.results[].items[].item_id	integer	No		ItemID is PSA's own numeric item id.
data.results[].items[].name	string	No		Name is the card/item's own descriptive name, e.g. "Ken Griffey, Sr. (R)".
data.results[].set_id	integer	No		SetID is PSA's own numeric set id -- pass as set_id to psa-price-guide-set along with CategoryPath and SetPath.
data.results[].set_name	string	No		SetName is the set's display name, e.g. "1974 Topps".
data.results[].set_path	string	No		SetPath is the set's own URL path segment -- pass as set_path to psa-price-guide-set.
data.total_count	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/psa/price-guide/search?query=griffey&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

PSA Price Guide search API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

PSA Price Guide search API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related