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 /api/v1/cards/live_search
Search the catalog
Sample results
-
Patrick Mahomes2017 Panini Prizm #269Base -
Patrick Mahomes2017 Panini Prizm #269Disco -
Patrick Mahomes2017 Panini Prizm #269Red White Blue -
Patrick Mahomes2017 Panini Prizm #269Green Scoop
Create an account to unlock 50 free searches after approval.
Sign up to try SearchGET /api/v1/stacks/:id
Sample export data
stack_id,title,card_number,variant
st_48213,2017 Panini Prizm Patrick Mahomes,269,Base
st_48213,2021 Donruss Optic Ja'Marr Chase,108,BasePOST /identify
Sample match
2017 Panini Prizm Patrick Mahomes #269Green Scoop
- Player
- Patrick Mahomes
- Sport
- Football
- League
- NFL
- Team
- Kansas City Chiefs
- Year
- 2017
- Set
- Panini Prizm
- Card number
- 269
- Variant
- Green Scoop
- Rookie
- Yes
API powered by Heystack
Find Your
API Use Case
Let collectors add cards the easy way.
Use Recognition to identify uploaded card photos and Search to help collectors find the right card in the catalog.
Expedite your intake processing.
Use Recognition and Search to build structured submissions, then use Export to move the matched records into your fulfillment workflow.
Bring matched cards into your repack workflow.
Use Export to pull commerce-ready images and titles from your finished stacks into your own systems.
Search API
Query Heystack’s card catalog from your own product, including consignment forms, grading submissions, and listing tools.
- Warnings First Emails at 75% and 90% of your daily limit, with an upgrade link.
- Daily Reset At your limit, calls return a 429 until midnight UTC.
- Upgrade Any Time Pay the difference. The higher limit applies right away.
- Downgrade Yourself Takes effect at your next renewal.
Try the Search preview
- Lifetime test calls
- 50
- Cards per search
- Up to 10
- Calls per minute
- 3
Search API referenceAuthentication and endpoints
Send your paid key in the X-API-Key header.
GET /api/v1/cards/live_search?q=2017+prizm+mahomes
Export API
Pull your finished stacks directly into your own platform and skip the CSV download and upload.
How it works
- HeystackFinished stack
- Export APIStructured data
- Your platformYour listings
Bring matched card titles, images, and listing data directly into your systems.
Export API referenceAuthentication and endpoints
Send your paid key in the X-API-Key header.
GET /api/v1/stacksGET /api/v1/stacks/:id
Recognition API
Send front and back card images and get ranked catalog matches for your users to review and confirm.
Sample match
2017 Panini Prizm Patrick Mahomes #269Green Scoop
- Player
- Patrick Mahomes
- Sport
- Football
- League
- NFL
- Team
- Kansas City Chiefs
- Year
- 2017
- Set
- Panini Prizm
- Card number
- 269
- Variant
- Green Scoop
- Rookie
- Yes