Developer API
Pick an API. Check out. Start building.
Three APIs, each sold on its own. Export finished stacks, search the Heystack catalog, or identify cards from photos.
- Choose a planSearch and Recognition require approval.
- Accept the terms and pay with StripeBilled to your company account.
- Get your keyOpen the Developer Console to get started.
GET /cards/live_search?q=2017+prizm+mahomes
Search the catalog
-
Patrick Mahomes2017 Panini Prizm #269Base -
Patrick Mahomes2017 Panini Prizm #269Disco -
Patrick Mahomes2017 Panini Prizm #269Red White Blue -
Patrick Mahomes2017 Panini Prizm #269Green Scope
Create an account to unlock 50 free searches after approval.
GET /stacks/st_48213?format=csv
stack_id,title,player,sport,league,team,year,set,insert,card_number,variant,serial,rookie,autograph,memorabilia,grade,market_movers,front_image,back_image,confirmed_by_user
st_48213,2017 Panini Prizm Patrick Mahomes #269 Base,Patrick Mahomes,Football,NFL,Kansas City Chiefs,2017,Panini Prizm,None,269,Base,None,Yes,No,No,Raw,$184,https://…,https://…,true
st_48213,2021 Donruss Optic Ja'Marr Chase #108,Ja'Marr Chase,Football,NFL,Cincinnati Bengals,2021,Donruss Optic,None,108,None,None,Yes,No,No,Raw,$71,https://…,https://…,true POST /identify
Match found · conf 0.97
2017 Panini Prizm Patrick Mahomes #269Green Scope
- Player
- Patrick Mahomes
- Sport
- Football
- League
- NFL
- Team
- Kansas City Chiefs
- Year
- 2017
- Set
- Panini Prizm
- Insert
- None
- Card #
- 269
- Variant
- Green Scope
- Serial
- None
- Rookie
- Yes
- Autograph
- No
- Memorabilia
- No
- Grade read
- Raw
- Market Movers
- $184
API powered by Heystack
Find Your
API Use Case
Let collectors add cards the easy way.
Incorporate our Recognition API into your interface so collectors can directly upload card images. Supplement our Recognition with our Search API so collectors can more quickly upload cards from our vast and expanding catalog.
Expedite your intake processing.
Ingesting consignment or grading submissions is an arduous process and a major drag on your business. Recognition and Search APIs allow your customers to build detailed, structured submissions to make processing much smoother at intake. Our Export API allows you to extract the data to assist with record keeping and post-process fulfillment.
Extract all the data you need.
Utilize our Export API to supercharge your repack-building backend process. Pull cropped, straightened, and rotated commerce-ready images and titles directly from your stacks into your systems.
Search API
Query Heystack's card catalog from your own product, like consignment forms, grading submissions, or listing tools. You build the interface, we provide the catalog.
-
Warnings FirstEmails at 75% and 90% of your daily limit, with an upgrade link.
-
Daily ResetAt your limit, calls return a 429 until midnight Eastern.
-
Upgrade Any TimePay the difference. The higher limit applies right away.
-
Downgrade YourselfTakes effect at your next renewal.
Billed through Stripe. Cancel any time.
This price is for the Search API only. Export and Recognition are priced separately.
PurchaseSearch API reference Authentication, endpoints, errors
Authentication
Send your API key in the X-API-Key header on every request. Keys are tied to your company account.
curl "https://admin.heystack.tech/api/v1/cards/live_search?q=2017+prizm+mahomes" \ -H "X-API-Key: $HEYSTACK_API_KEY"
Endpoints
GET /cards/live_search Search the catalog
| Parameter | Type | Description |
|---|---|---|
q | string, required | Search text, like player, year, set, or card number. |
limit | integer | Results to return. Default 10, max 50. |
category | string | Optional filter, like baseball, basketball, pokemon. |
{
"results": [
{ "card_id": "c_8812045", "player": "Patrick Mahomes", "year": "2017",
"set": "Panini Prizm", "number": "269", "parallel": "Base" }
],
"limit_remaining_today": 1358
}
Errors
| Code | Meaning |
|---|---|
401 | Missing or invalid API key. |
403 | This API isn't on your account. Subscribe to turn it on. |
429 | Daily limit reached, or too many calls per minute. Check the Retry-After header. Daily limits reset at midnight Eastern. |
Good practice
Cache popular searches on your side and debounce search-as-you-type input. Both keep you well inside your per-minute limit.
Export API
Pull your finished stacks into your own platform through the API, instead of downloading and re-uploading CSV files.
- HeystackFinished stack
- Export APIStructured data
- Your platformYour listings
- No CSV round trips. Pull stacks straight into your own systems.
- Per company account, so your whole team works from the same access.
- Commerce-ready images and titles, directly from your finished stacks.
Billed through Stripe. Cancel any time.
This price is for the Export API only. Search and Recognition are priced separately.
PurchaseExport API reference Authentication, endpoints, errors
Authentication
Send your API key in the X-API-Key header on every request. Keys are tied to your company account.
curl "https://admin.heystack.tech/api/v1/stacks?status=complete" \ -H "X-API-Key: $HEYSTACK_API_KEY"
Endpoints
GET /stacks List your stacks
| Parameter | Type | Description |
|---|---|---|
status | string | Filter by status, like complete. |
updated_since | ISO 8601 date | Only stacks changed after this time. |
page | integer | Page number. 50 stacks per page. |
{
"stacks": [
{ "stack_id": "st_48213", "name": "Oct show buys", "status": "complete",
"card_count": 250, "completed_at": "2026-10-18T21:04:11Z" }
],
"next_page": 2
}
GET /stacks/:id Get one stack with its cards
| Parameter | Type | Description |
|---|---|---|
id | string, required | The stack_id from the list endpoint. |
{
"stack_id": "st_48213",
"status": "complete",
"cards": [
{ "player": "Ja'Marr Chase", "year": "2021", "set": "Donruss Optic",
"number": "108", "confirmed_by_user": true,
"images": { "front": "https://…", "back": "https://…" } }
]
}
Errors
| Code | Meaning |
|---|---|
401 | Missing or invalid API key. |
403 | This API isn't on your account. Subscribe to turn it on. |
404 | No stack with that ID on your account. |
429 | Too many calls per minute. Check the Retry-After header. |
Recognition API
Send front and back card images and get back recommended matches, ranked, for your users to review and confirm. Tell us about your platform and how you'd use it, and our dev team will follow up.
POST /identify front.jpg + back.jpg
Match found · conf 0.97
2017 Panini Prizm Patrick Mahomes #269Green Scope
- Player
- Patrick Mahomes
- Sport
- Football
- League
- NFL
- Team
- Kansas City Chiefs
- Year
- 2017
- Set
- Panini Prizm
- Insert
- None
- Card #
- 269
- Variant
- Green Scope
- Serial
- None
- Rookie
- Yes
- Autograph
- No
- Memorabilia
- No
- Grade read
- Raw
- Market Movers
- $184
Reviewed before we switch it on.
- Front and back photo to a ranked match. Send two images, get recommended matches back.
- Credit based. Subscribe after your account is approved.
- A real person approves your use case first. Tell us what you are building.