compsniper-com Depop API

openapi: 3.2.0
info:
  title: CompSniper Marketplace and Shipping Depop 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: Depop
paths:
  /v1/depop/listings:
    get:
      tags:
      - Depop
      summary: Depop active listings
      description: Current Depop listings in the US, UK, Australia or Canada with asking price, original price before a discount, shipping, brand, size, condition and seller. Page with nextCursor. 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: vintage levis 501
          description: Brand, model and item
      - name: country
        in: query
        required: false
        schema:
          type: string
          enum:
          - us
          - gb
          - au
          - ca
          default: us
          description: Depop marketplace
      - name: count
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 48
          default: 24
          description: Listings per page
      - name: cursor
        in: query
        required: false
        schema:
          type: string
          maxLength: 200
          description: nextCursor from the previous page
      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'
                  country:
                    type: string
                  nextCursor:
                    type:
                    - string
                    - 'null'
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        productId:
                          type: string
                        url:
                          type: string
                        title:
                          type: string
                        description:
                          type:
                          - string
                          - 'null'
                        price:
                          type:
                          - number
                          - 'null'
                        originalPrice:
                          type:
                          - number
                          - 'null'
                        shippingPrice:
                          type:
                          - number
                          - 'null'
                        currency:
                          type:
                          - string
                          - 'null'
                        brand:
                          type:
                          - string
                          - 'null'
                        category:
                          type:
                          - string
                          - 'null'
                        sizes:
                          type: array
                          items:
                            type: string
                        condition:
                          type:
                          - string
                          - 'null'
                        gender:
                          type:
                          - string
                          - 'null'
                        colors:
                          type: array
                          items:
                            type: string
                        quantity:
                          type:
                          - integer
                          - 'null'
                        sellerUsername:
                          type:
                          - string
                          - 'null'
                        location:
                          type:
                          - string
                          - 'null'
                        country:
                          type:
                          - string
                          - 'null'
                        imageUrl:
                          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: getV1DepopListings
      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_...''.'