Quickstart
Three steps to your first Trust Score response — no signup required.
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.
| 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
/seller/:slug
Full trust profile for a seller
Returns trust score, certification, platform handles, review aggregate, and scam alert count.
Parameters
| Name | Type | Description |
|---|---|---|
| slug (path) | string | Seller slug (e.g. great-breaker) |
/seller/:slug/reviews
Paginated review feed
Returns published reviews with verified-purchase flag. Cursor-based pagination.
| Name | Type | Description |
|---|---|---|
| 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) |
/search
Search sellers by name or platform handle
| Name | Type | Description |
|---|---|---|
| q (query, required) | string | Search query (min 2 chars) |
| platform (query) | string | Filter by platform: whatnot, ebay, tiktok |
| limit (query) | integer | Max results. Default 10, max 50. |
/leaderboard/:category
Top sellers per category
| Name | Type | Description |
|---|---|---|
| category (path) | string | whatnot-breakers · ebay-sellers · tiktok-live · certified · top-rated |
| limit (query) | integer | Number of sellers. Default 25, max 100. |
/lookup
Look up seller by platform handle
Used by the BreakCheck Chrome extension to show trust scores inline on Whatnot, eBay, and TikTok.
| Name | Type | Description |
|---|---|---|
| platform (query, required) | string | whatnot, ebay, tiktok |
| handle (query, required) | string | Seller's handle on that platform |
Rate Limits
Rate limit status is returned in every response header.
When you exceed the limit, you get a 429 Too Many Requests with a Retry-After header.
Response Envelope
All v1 endpoints return a consistent JSON envelope.
Error responses use error.code and error.message at the top level alongside meta.
Code Samples
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.