compsniper-com

compsniper-com Grailed API

The Grailed API from compsniper-com — 2 operation(s) for grailed.

GitHub OpenAPI

Operations 2

GET /v1/grailed/sold Grailed sold listings #
GET /v1/grailed/listings Grailed active listings #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/compsniper-com/openapi/compsniper-com-grailed-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/compsniper-com/json-schema/compsniper-com-shipping-rate-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/compsniper-com/json-schema/compsniper-com-max-job-schema.json
📊
JSONSchema
https://artifacts.apis.io/compsniper-com/json-schema/compsniper-com-max-search-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/compsniper-com/json-schema/compsniper-com-shipping-rate-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/compsniper-com/json-schema/compsniper-com-account-usage-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/compsniper-com/json-schema/compsniper-com-card-batch-job-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/compsniper-com:compsniper-com-grailed-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

compsniper-com-grailed-api-openapi.yml Raw ↑ 
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_...''.'