Market Data

Search Cards with 90-Day Average Prices

Full-text card search with 90-day average prices attached to each result.

Runs a full-text, relevance-ranked search, then merges each matched card's 90-day average price for the requested grade. Results are returned in relevance order. Cards without price data for the specified grade are included with null price fields.

To browse or paginate all cards at a grade instead of searching, see 90day-prices-by-grade.

Parameters:

  • search: Required. Search query (e.g., 'Mike Trout 2011 Topps Update')
  • grade: Required. Card grade (e.g., 'PSA 10', 'SGC 10', 'BGS 9.5')
  • page: Page number for pagination (default: 1)
  • page_size: Number of results per page (1-100, default: 50)

Paging covers the first 10,000 results of a query: found is always the full match count, pages counts only the reachable pages, and a page beyond that window returns an empty cards list.

Example curl:

curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "search": "Mike Trout 2011 Topps Update",
       "grade": "PSA 10"
     }' \
     "https://api.cardhedger.com/v1/cards/90day-prices-by-grade-search"

Returns cards in relevance order with 90-day average price and sales count.

post/v1/cards/90day-prices-by-grade-search

Request

  • Base URL
    https://api.cardhedger.com
  • Auth
    API key in header X-API-Key

Request body

searchstring required

Search query

gradestring required

Card grade (e.g., 'PSA 10')

pageinteger

Page number for pagination

page_sizeinteger

Number of results per page (max 100)

Response

Successful Response

pageinteger required

Current page number

pagesinteger required

Total pages of results

foundinteger required

Total matching cards

search_time_msinteger required

Search time in milliseconds

Changes

No recorded changes to this operation across all 14 revisions of this API.