Get BreakCheck Certified Got scammed?
Navigation
Home
Buyers
Search Sellers/Breakers Search Live Streams Scam Alert Directory Top Rated Sellers/Breakers Hall of Shame
Sellers
Search Sellers/Breakers Add Your Live Streams Add Your Big Hits Why get Certified
Certification
Apply/Renew Certification Verify Certification Appeal a Decision Certified Seller Spotlight
Safety Hub
Was I Scammed? Report A Scam
Resources
API Docs Buyer Guides Approved Tools Add Notable Hits
More
Browser Extension Got scammed? Get BreakCheck Certified
Public API v1 · Now Live

The trust layer for
the card hobby.

Embed Trust Scores, certified seller data, and scam alerts anywhere. One API. No friction. Free to start.

5
API Endpoints
100/day
Free Tier (no key)
60/min
Keyed Free Tier
<300ms
Median Latency

Quickstart

Three steps to your first Trust Score response — no signup required.

1 Make a request No API key needed for the free tier
curl https://breakcheck.gg/api/v1/seller/some-seller-slug
2 Get the response
{ "data": { "slug": "some-seller-slug", "display_name": "Great Breaker", "trust_score": 84, "certification": { "tier": "gold", "cert_id": "BC-CERT-0042", "expires_at": "2027-01-01T00:00:00.000Z" }, "review_count": 127, "avg_rating": 4.7, "verified_review_count": 89, "active_scam_alerts": 0, "profile_url": "https://breakcheck.gg/seller/some-seller-slug" }, "meta": { "request_id": "a3f1b2c4d5e6f7g8", "rate_limit": { "limit": 100, "remaining": 99, "reset": 86400 } } }
3 Get an API key for higher limits

Free tier is 100 requests/day per IP. A free API key gives you 60 requests/minute.

Request a Free Key →

Authentication

All v1 endpoints accept an optional API key via Authorization: Bearer header.

curl https://breakcheck.gg/api/v1/seller/some-slug \ -H "Authorization: Bearer pk_live_your_key_here"
Tier Auth Limit Cost
Public None (IP-based) 100 req/day Free
Free Key pk_live_... 60 req/min Free
Partner pk_live_... 600 req/min Contact us

Endpoints

Base URL: https://breakcheck.gg/api/v1

GET /seller/:slug Full trust profile for a seller

Returns trust score, certification, platform handles, review aggregate, and scam alert count.

Parameters

NameTypeDescription
slug (path) string Seller slug (e.g. great-breaker)
curl https://breakcheck.gg/api/v1/seller/great-breaker
GET /seller/:slug/reviews Paginated review feed

Returns published reviews with verified-purchase flag. Cursor-based pagination.

NameTypeDescription
slug (path) string Seller slug
limit (query) integer Reviews per page. Default 20, max 50.
cursor (query) integer Review ID cursor for next page (from meta.next_cursor)
curl "https://breakcheck.gg/api/v1/seller/great-breaker/reviews?limit=10"
GET /leaderboard/:category Top sellers per category
NameTypeDescription
category (path) string whatnot-breakers · ebay-sellers · tiktok-live · certified · top-rated
limit (query) integer Number of sellers. Default 25, max 100.
curl https://breakcheck.gg/api/v1/leaderboard/whatnot-breakers
GET /lookup Look up seller by platform handle

Used by the BreakCheck Chrome extension to show trust scores inline on Whatnot, eBay, and TikTok.

NameTypeDescription
platform (query, required) string whatnot, ebay, tiktok
handle (query, required) string Seller's handle on that platform
curl "https://breakcheck.gg/api/v1/lookup?platform=whatnot&handle=great-breaker"

Rate Limits

Rate limit status is returned in every response header.

X-RateLimit-Limit: 100 X-RateLimit-Remaining: 99 X-RateLimit-Reset: 86400 # seconds until window resets

When you exceed the limit, you get a 429 Too Many Requests with a Retry-After header.

{ "error": { "code": "RATE_LIMITED", "message": "Public rate limit exceeded (100 req/day). Get a free API key at breakcheck.gg/developers to increase limits." }, "meta": { "request_id": "..." } }

Response Envelope

All v1 endpoints return a consistent JSON envelope.

{ "data": { /* endpoint-specific payload */ }, "meta": { "request_id": "a3f1b2c4", // unique request identifier for debugging "rate_limit": { "limit": 100, "remaining": 99, "reset": 86400 // seconds until rate limit window resets } } }

Error responses use error.code and error.message at the top level alongside meta.

Code Samples

# Seller trust profile curl -H "Authorization: Bearer pk_live_your_key" \ https://breakcheck.gg/api/v1/seller/great-breaker # Search sellers on Whatnot curl "https://breakcheck.gg/api/v1/search?q=amazing&platform=whatnot&limit=5" # Top certified sellers curl https://breakcheck.gg/api/v1/leaderboard/certified

Use Cases

🤖

Discord Safety Bot

Build a bot that auto-warns your server when a flagged seller posts a break link. Pull scam alerts in real time.

🛒

Marketplace Integration

Show BreakCheck trust scores inline on your own marketplace or Whatnot/eBay tracker site.

📊

Analytics Dashboards

Sync seller reputation data into your own analytics pipeline. Leaderboard data refreshes nightly.

🏷️

Breaker's Own Website

Pull your own live trust score onto your personal site. Show off your certification and reviews.

🔍

Browser Extension

The BreakCheck Chrome extension dogfoods this API — showing trust scores inline on Whatnot, eBay, and TikTok Live.

📋

Review Aggregation

Paginate and ingest all reviews for a seller. Build your own custom reporting or alerting on top.

Need Higher Limits or a Partnership?

If you're building something serious on the BreakCheck API — a Discord bot, a marketplace integration, a research tool — reach out. We'll set you up with a partner key and higher limits.