compsniper-com Grailed API
The Grailed API from compsniper-com — 2 operation(s) for grailed.
The Grailed API from compsniper-com — 2 operation(s) for grailed.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/compsniper-com:compsniper-com-grailed-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: CompSniper Marketplace and Shipping Grailed API
version: 2.3.0
description: Public eBay (including up to 3 years of sold history), Poshmark, Mercari, TCGplayer, Grailed, Depop and PSA graded card (prices by grade, population) data plus a separate quote-only US shipping-rates product. Shipping quotes separate applicable services from carrier-packaging and content-restricted options, use an independent subscription and quota, and do not consume sold-comps requests or purchased credits.
contact:
name: CompSniper
url: https://compsniper.com
servers:
- url: https://api.compsniper.com
security:
- bearerAuth: []
tags:
- name: Grailed
paths:
/v1/grailed/sold:
get:
tags:
- Grailed
summary: Grailed sold listings
description: Grailed sold listings with the price the buyer paid (accepted offers included), the asking price it sold from, sold date, shipping paid, size, condition and designer. Up to 100 rows per page and 1,000 per search. One successful call uses one request.
security:
- bearerAuth: []
parameters:
- $ref: '#/components/parameters/CreditSource'
- name: keyword
in: query
required: true
schema:
type: string
maxLength: 300
example: supreme box logo hoodie
description: Brand, model and item
- name: department
in: query
required: false
schema:
type: string
enum:
- any
- menswear
- womenswear
default: any
description: Department filter
- name: condition
in: query
required: false
schema:
type: string
enum:
- any
- new
- gently_used
- used
- worn
default: any
description: Condition filter
- name: minPrice
in: query
required: false
schema:
type: number
minimum: 0
description: Minimum price in USD
- name: maxPrice
in: query
required: false
schema:
type: number
minimum: 0
description: Maximum price in USD
- name: count
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
default: 40
description: Rows per page
- name: page
in: query
required: false
schema:
type: integer
minimum: 1
default: 1
description: Page number; page x count must be 1000 or less
- name: sortBy
in: query
required: false
schema:
type: string
enum:
- recent
- price_desc
- price_asc
default: recent
description: Sort order
responses:
'200':
description: Sold listings
content:
application/json:
schema:
type: object
properties:
keyword:
type: string
page:
type: integer
count:
type: integer
marketplace:
type: string
totalResults:
type:
- integer
- 'null'
totalItems:
type: integer
hasNextPage:
type: boolean
scrapedAt:
type: string
summary:
type:
- object
- 'null'
items:
type: array
items:
type: object
properties:
listingId:
type: string
url:
type: string
title:
type: string
currency:
type: string
designers:
type: array
items:
type: string
size:
type:
- string
- 'null'
condition:
type:
- string
- 'null'
category:
type:
- string
- 'null'
department:
type:
- string
- 'null'
location:
type:
- string
- 'null'
imageUrl:
type:
- string
- 'null'
soldPrice:
type:
- number
- 'null'
listPrice:
type:
- number
- 'null'
shippingPrice:
type:
- number
- 'null'
soldPriceIncludesShipping:
type:
- boolean
- 'null'
soldAt:
type:
- string
- 'null'
'400':
description: Error
content:
application/json:
schema:
type: object
properties:
code:
type: string
error:
type: string
requestId:
type: string
'401':
description: Error
content:
application/json:
schema:
type: object
properties:
code:
type: string
error:
type: string
requestId:
type: string
'429':
description: Error
content:
application/json:
schema:
type: object
properties:
code:
type: string
error:
type: string
requestId:
type: string
'502':
description: Error
content:
application/json:
schema:
type: object
properties:
code:
type: string
error:
type: string
requestId:
type: string
'503':
description: Error
content:
application/json:
schema:
type: object
properties:
code:
type: string
error:
type: string
requestId:
type: string
operationId: getV1GrailedSold
x-operation-id-source: derived
/v1/grailed/listings:
get:
tags:
- Grailed
summary: Grailed active listings
description: Current Grailed listings with asking price, US shipping, offers, size, condition and designer. One successful call uses one request.
security:
- bearerAuth: []
parameters:
- $ref: '#/components/parameters/CreditSource'
- name: keyword
in: query
required: true
schema:
type: string
maxLength: 300
example: supreme box logo hoodie
description: Brand, model and item
- name: department
in: query
required: false
schema:
type: string
enum:
- any
- menswear
- womenswear
default: any
description: Department filter
- name: condition
in: query
required: false
schema:
type: string
enum:
- any
- new
- gently_used
- used
- worn
default: any
description: Condition filter
- name: minPrice
in: query
required: false
schema:
type: number
minimum: 0
description: Minimum price in USD
- name: maxPrice
in: query
required: false
schema:
type: number
minimum: 0
description: Maximum price in USD
- name: count
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
default: 40
description: Rows per page
- name: page
in: query
required: false
schema:
type: integer
minimum: 1
default: 1
description: Page number; page x count must be 1000 or less
- name: sortBy
in: query
required: false
schema:
type: string
enum:
- default
- newest
- price_asc
- price_desc
default: default
description: Sort order
responses:
'200':
description: Active listings
content:
application/json:
schema:
type: object
properties:
keyword:
type: string
page:
type: integer
count:
type: integer
marketplace:
type: string
totalListings:
type:
- integer
- 'null'
totalItems:
type: integer
hasNextPage:
type: boolean
scrapedAt:
type: string
summary:
type:
- object
- 'null'
items:
type: array
items:
type: object
properties:
listingId:
type: string
url:
type: string
title:
type: string
currency:
type: string
designers:
type: array
items:
type: string
size:
type:
- string
- 'null'
condition:
type:
- string
- 'null'
category:
type:
- string
- 'null'
department:
type:
- string
- 'null'
location:
type:
- string
- 'null'
imageUrl:
type:
- string
- 'null'
price:
type:
- number
- 'null'
shippingPrice:
type:
- number
- 'null'
acceptsOffers:
type: boolean
listedAt:
type:
- string
- 'null'
bumpedAt:
type:
- string
- 'null'
'400':
description: Error
content:
application/json:
schema:
type: object
properties:
code:
type: string
error:
type: string
requestId:
type: string
'401':
description: Error
content:
application/json:
schema:
type: object
properties:
code:
type: string
error:
type: string
requestId:
type: string
'429':
description: Error
content:
application/json:
schema:
type: object
properties:
code:
type: string
error:
type: string
requestId:
type: string
'502':
description: Error
content:
application/json:
schema:
type: object
properties:
code:
type: string
error:
type: string
requestId:
type: string
'503':
description: Error
content:
application/json:
schema:
type: object
properties:
code:
type: string
error:
type: string
requestId:
type: string
operationId: getV1GrailedListings
x-operation-id-source: derived
components:
parameters:
CreditSource:
name: X-Credit-Source
in: header
required: false
schema:
type: string
enum:
- credits
description: Omit to use temporary carryover first, then monthly quota, then purchased credits. Set to credits to spend a purchased credit directly. Failed searches are not charged.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'Send your API key as ''Authorization: Bearer cs_live_...''.'