gosgc APIgosgc.com ↗
Look up SGC graded sports card details by certification code. Returns grade, population, card set, subject, and grading date via a single API endpoint.
What is the gosgc API?
The SGC Cert Code Lookup API exposes 1 endpoint — search_cert — that returns 10 structured fields for any SGC-graded sports card when queried by certification code. Submit a 7-digit black label code or an XXXXXXX-XXX format green/white label code and get back the card's grade, subject name, full set, population data, and the ISO datetime the card was graded.
curl -X POST 'https://api.parse.bot/scraper/f63ad1cb-5b08-4e33-9ea8-573b416e936d/search_cert' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"cert_code": "0453727"
}'Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace gosgc-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: SGC Cert Verification SDK — bounded, re-runnable."""
from parse_apis.gosgc_com_api import SGC, CardNotFound
client = SGC()
# Look up a graded card by cert code
try:
card = client.cards.get(cert_code="0453727")
print(card.card_subject, card.grade, card.card_set)
print(card.sport, card.population, card.pop_higher)
except CardNotFound as e:
print(f"Card not found: {e.cert_code}")
print("exercised: cards.get")
Look up a graded card by its SGC certification code. Returns card details including subject, set, grade, population, and grading date. Black label cert codes are 7 digits; green and white label codes use XXXXXXX-XXX format.
| Param | Type | Description |
|---|---|---|
| cert_coderequired | string | SGC certification code. 7 digits for black labels (e.g. 0453727) or XXXXXXX-XXX for green/white labels. |
{
"type": "object",
"fields": {
"grade": "Numeric grade assigned by SGC",
"sport": "Sport category",
"card_set": "Full set name including year and brand",
"cert_code": "SGC certification code",
"card_group": "Card group classification if applicable",
"grade_date": "ISO datetime when the card was graded",
"pop_higher": "Number of cards graded higher",
"population": "Number of cards with same grade for this card",
"card_number": "Card number within the set",
"card_subject": "Player or subject name",
"card_description": "Card variant/parallel description"
},
"sample": {
"data": {
"grade": "10",
"sport": "Football",
"card_set": "2020 Panini National Treasures",
"cert_code": "0453727",
"card_group": null,
"grade_date": "2022-06-07T15:30:02.1033333",
"pop_higher": "0",
"population": "1",
"card_number": "CRS-JH",
"card_subject": "Justin Herbert",
"card_description": "Crossover Rookie Patch Sig. Holo Gold /25"
},
"status": "success"
}
}About the gosgc API
What the API Returns
The search_cert endpoint accepts a single required input, cert_code, and returns a structured record for the matching SGC-graded card. The response includes card_subject (player or subject name), card_set (full year, brand, and set name), card_number, sport, and grade — the numeric SGC grade assigned to that specific slab.
Population and Grading Data
Beyond card identification, the response includes registry-level data: population reports how many copies of the same card have received the same grade, and pop_higher shows how many copies have received a higher grade. Together these fields let you assess relative scarcity within the graded population. The grade_date field returns an ISO datetime indicating when SGC completed grading, useful for tracking submission timelines or filtering recent certifications.
Cert Code Formats
SGC uses two certification code formats depending on the label type. Black label slabs use a plain 7-digit code (e.g. 0453727). Green and white label slabs use an XXXXXXX-XXX hyphenated format. Both formats are accepted by the cert_code parameter. If you are unsure of the label type, the format of the code on the slab itself determines which pattern to use.
Scope and Classification
Each response also includes card_group, a classification field that applies when SGC categorizes the card under a specific subset or group within a set. This field is populated conditionally. The cert_code field is echoed back in the response, which simplifies batch workflows where you need to reconcile requests against returned records.
The gosgc API is a managed, monitored endpoint for gosgc.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when gosgc.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 gosgc.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?+
- Verify authenticity of an SGC-graded card before purchase by confirming the cert code returns a matching subject and grade
- Build a portfolio tracker that logs
grade,card_set, andgrade_datefor every slab in a collection - Compare
populationandpop_highervalues across multiple certs to evaluate relative scarcity for pricing research - Automate pre-sale listing validation to confirm cert codes match the advertised
card_subjectandcard_number - Track submission turnaround times by recording
grade_datefor batches of cards sent to SGC - Enrich marketplace listings with live SGC registry data including grade and population figures
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does SGC offer an official developer API for cert lookups?+
What does the `search_cert` endpoint return beyond the grade?+
grade, the response includes card_subject, card_set, card_number, sport, card_group, cert_code, grade_date, population (same-grade count), and pop_higher (higher-grade count) — 10 fields in total.Does the API support looking up multiple cert codes in a single request?+
search_cert endpoint accepts one cert_code per request. Batch lookups require separate calls for each code. You can fork this API on Parse and revise it to add a batch endpoint that accepts an array of codes and returns an array of results.Is image data — such as front and back card scans — returned in the response?+
How current is the grading data returned for a cert code?+
grade_date field reflects the datetime SGC recorded for grading completion. Population figures (population and pop_higher) reflect the state of the SGC registry at the time the request is made, so they may change as new cards of the same type are graded.