Beckett APImarketplace.beckett.com ↗
Search Beckett Marketplace trading card listings and retrieve multi-dealer pricing, conditions, and seller details via two structured endpoints.
What is the Beckett API?
The Beckett Marketplace API provides 2 endpoints for querying trading card listings and dealer pricing data from marketplace.beckett.com. The search_listings endpoint accepts a keyword term and optional sport and sort filters, returning paginated results with price ranges, conditions, and item IDs. The get_listing_details endpoint takes an item ID and returns every seller currently offering that card, including individual prices, dealer ratings, and shipping information.
curl -X GET 'https://api.parse.bot/scraper/caee2a49-e4a2-4e18-92c1-b5a34b9b20a6/search_listings?page=1&sort=sort_key&term=Michael+Jordan&sport=Basketball' \ -H 'X-API-Key: $PARSE_API_KEY'
Search the Beckett Marketplace for trading card listings by keyword. Returns paginated results with price ranges, conditions, and dealer information. Each result represents a unique card item which may have multiple sellers. Use the item_id from results to fetch all sellers via get_listing_details. Results are paginated at 50 per page; pass page to navigate.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination (1-based). |
| sort | string | Sort order for results. Omitted uses default relevance order. |
| termrequired | string | Search term for card listings (player name, card title, set name, etc.). |
| sport | string | Sport category filter. Omitted returns all sports. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"listings": "array of card listing objects with title, item_id, listing_id, team, image_url, attributes, condition, price_low, price_high, num_sellers, quantity, dealer_name, dealer_rating",
"per_page": "integer results per page (50)",
"total_records": "integer total number of matching records"
},
"sample": {
"data": {
"page": 1,
"listings": [
{
"team": "Chicago Bulls",
"title": "2008 Upper Deck Goudey Hit Parade of Champions #HPC21 Michael Jordan",
"item_id": "",
"quantity": "1",
"condition": "Near Mint/Mint",
"image_url": "https://img.beckett.com/images/no-image-new.jpg",
"price_low": 7.95,
"attributes": [],
"listing_id": "106072906",
"price_high": null,
"dealer_name": "Rich 'N Deals",
"num_sellers": 1,
"dealer_rating": 4.99
}
],
"per_page": 50,
"total_records": 3505
},
"status": "success"
}
}About the Beckett API
Search Listings
The search_listings endpoint accepts a required term parameter — player name, set name, card title, or any keyword — alongside optional sport, sort, and page parameters. Results are paginated at 50 records per page, with total_records indicating the full match count. Each listing object in the listings array includes title, item_id, listing_id, team, image_url, attributes, condition, price_low, and price_high. The price_low and price_high fields reflect the range across all active sellers for that card, letting you gauge market spread before fetching granular detail.
Listing Details and Seller Data
The get_listing_details endpoint takes a single required item_id — sourced from search_listings results — and returns every active seller for that card. The sellers array contains individual dealer records with listing_url, dealer_name, dealer_rating, price, condition, quantity, and a free_ prefix field covering free shipping eligibility. The total_sellers count indicates how many dealers are currently offering the item. This two-step pattern (search, then drill into sellers) mirrors how multi-dealer marketplaces expose competitive pricing.
Coverage and Scope
The API covers trading cards listed on the Beckett Marketplace across multiple sports. The sport filter on search_listings lets you narrow results to a specific sport category, while omitting it returns listings across all sports. Card attributes and condition grades follow Beckett's grading conventions and appear in each listing object.
The Beckett API is a managed, monitored endpoint for marketplace.beckett.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when marketplace.beckett.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official marketplace.beckett.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track price ranges for specific player cards using
price_lowandprice_highfrom search results - Compare dealer prices for the same card by pulling all sellers via
get_listing_details - Filter trading card inventory by sport category to build sport-specific price feeds
- Monitor
total_sellersover time to gauge how supply for a card changes - Aggregate
dealer_ratingdata across sellers to identify top-rated sources for a given card - Build card condition filters by extracting
conditionfields across paginatedsearch_listingsresults - Compile image URLs and card attributes for a trading card catalog or reference database
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Beckett have an official developer API?+
What does `get_listing_details` return beyond what `search_listings` already shows?+
search_listings returns aggregate price ranges (price_low, price_high) across all sellers for a card. get_listing_details breaks those down into individual seller records, each with its own dealer_name, dealer_rating, price, condition, quantity, listing_url, and free shipping flag. It also returns total_sellers, so you know exactly how many dealers are competing on that item.Does the API expose historical sold prices or price history for cards?+
search_listings and get_listing_details. Historical transaction or sale price data is not included. You can fork this API on Parse and revise it to add an endpoint targeting historical pricing if that data becomes accessible.Are there limitations on pagination depth or result freshness?+
page numbering, with total_records telling you the full count. Listing data reflects current marketplace inventory, so cards sell out or prices change between requests. There is no built-in caching layer exposed through the API.Does the API return seller contact details or buyer transaction history?+
dealer_name, dealer_rating, listing_url, and transactional listing fields like price and quantity — but not direct contact information, full seller profiles, or buyer history. You can fork this API on Parse and revise it to add a seller-detail endpoint if that data is accessible on the marketplace.