---
title: "Search PSA Price Guide"
method: GET
path: "/psa/price-guide/search"
tags: ["PSA"]
---

# Search PSA Price Guide

`GET /psa/price-guide/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/psa/price-guide/search`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `query` string, required
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

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

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)
