compsniper-com Poshmark API

openapi: 3.2.0
info:
  title: CompSniper Marketplace and Shipping Poshmark 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: Poshmark
paths:
  /v1/poshmark/sold:
    get:
      tags:
      - Poshmark
      summary: Scrape Poshmark sold listings
      description: Returns one native page of public Poshmark sold listings. Authentication, rate limits, monthly quota, purchased credits, request IDs, and cache headers match the other CompSniper endpoints. Each successful page uses one CompSniper request, including enrich=true. The native page ceiling is 48 listings.
      security:
      - bearerAuth: []
      parameters:
      - $ref: '#/components/parameters/CreditSource'
      - schema:
          type: string
          minLength: 1
          description: Poshmark search term
          example: louis vuitton neverfull
        required: true
        name: keyword
        in: query
      - schema:
          type: integer
          minimum: 1
          default: 1
          description: Page number. Each page returns up to 48 items.
          example: 1
        required: false
        name: page
        in: query
      - schema:
          type:
          - number
          - 'null'
          minimum: 0
          description: Minimum price filter (USD)
          example: 50
        required: false
        name: minPrice
        in: query
      - schema:
          type:
          - number
          - 'null'
          minimum: 0
          description: Maximum price filter (USD)
          example: 500
        required: false
        name: maxPrice
        in: query
      - schema:
          type: string
          enum:
          - all
          - women
          - men
          - kids
          - home
          - pets
          - electronics
          default: all
          description: Poshmark department filter
        required: false
        name: department
        in: query
      - schema:
          type: string
          enum:
          - all
          - nwt
          default: all
          description: Condition filter. 'nwt' = New With Tags only.
        required: false
        name: condition
        in: query
      - schema:
          type: string
          description: Filter by brand name
          example: Louis Vuitton
        required: false
        name: brand
        in: query
      - schema:
          type: string
          enum:
          - sold_recently
          - price_asc
          - price_desc
          - likes
          default: sold_recently
          description: Sort order for results
        required: false
        name: sortBy
        in: query
      - schema:
          type: string
          enum:
          - 'true'
          - 'false'
          default: 'false'
          description: Adds public seller location, approximate sold-count evidence, and average ship time. Sold date, listed date, colors, description, category, and condition are already returned when present in the native search response. This still uses one CompSniper request.
          example: 'false'
        required: false
        name: enrich
        in: query
        description: Adds public seller location, approximate sold-count evidence, and average ship time. Sold date, listed date, colors, description, category, and condition are already returned when present in the native search response. This still uses one CompSniper request.
      responses:
        '200':
          description: Sold listings
          content:
            application/json:
              schema:
                type: object
                properties:
                  keyword:
                    type: string
                  page:
                    type: number
                    description: Current page number
                  totalItems:
                    type: number
                    description: Number of items returned in this response (up to 48)
                  hasNextPage:
                    type: boolean
                    description: Whether more pages of results are available.
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        listingId:
                          type: string
                          description: Poshmark listing ID (24-char hex)
                          example: 6478a1b2c3d4e5f6a7b8c9d0
                        url:
                          type: string
                          example: https://poshmark.com/listing/Louis-Vuitton-Neverfull-6478a1b2c3d4e5f6a7b8c9d0
                        title:
                          type: string
                          example: Louis Vuitton Neverfull MM Damier Ebene
                        soldPrice:
                          type:
                          - number
                          - 'null'
                          description: Sale price in USD
                          example: 1250
                        originalPrice:
                          type:
                          - number
                          - 'null'
                          description: Original listing price in USD
                          example: 1960
                        shippingCost:
                          type:
                          - number
                          - 'null'
                          description: Reserved for item-level shipping evidence. null when Poshmark does not expose it.
                          example: 7.97
                        brand:
                          type:
                          - string
                          - 'null'
                          example: Louis Vuitton
                        size:
                          type:
                          - string
                          - 'null'
                          example: OS
                        category:
                          type:
                          - string
                          - 'null'
                          description: Department > Category path.
                          example: Women > Bags > Totes
                        condition:
                          type:
                          - string
                          - 'null'
                          description: Item condition from Poshmark API.
                          example: Pre-owned
                        nwt:
                          type: boolean
                          description: New With Tags flag
                        colors:
                          type: array
                          items:
                            type: string
                          description: Color names from Poshmark API.
                          example:
                          - Brown
                        description:
                          type:
                          - string
                          - 'null'
                          description: Full listing description text.
                        soldAt:
                          type:
                          - string
                          - 'null'
                          description: Public ISO timestamp when Poshmark marked the item sold.
                          example: '2026-07-15T18:30:00.000Z'
                        listedAt:
                          type:
                          - string
                          - 'null'
                          description: ISO timestamp when the item was first published.
                          example: '2026-06-01T12:00:00.000Z'
                        daysToSell:
                          type:
                          - number
                          - 'null'
                          description: Days between listedAt and soldAt. null when either date is missing.
                          example: 44.27
                        likesCount:
                          type:
                          - number
                          - 'null'
                          example: 23
                        commentsCount:
                          type:
                          - number
                          - 'null'
                          description: Public comment count when exposed by Poshmark search.
                          example: 4
                        shareCount:
                          type:
                          - number
                          - 'null'
                          description: Public share count when exposed by Poshmark search.
                          example: 12
                        sellerUsername:
                          type:
                          - string
                          - 'null'
                          example: luxurycloset
                        sellerLocation:
                          type:
                          - string
                          - 'null'
                          description: Seller city + state. Requires enrich=true.
                          example: Los Angeles, CA
                        sellerSoldCount:
                          type:
                          - number
                          - 'null'
                          description: Approximate public seller sold count. Requires enrich=true.
                          example: 847
                        sellerAvgShipTime:
                          type:
                          - number
                          - 'null'
                          description: Seller's average ship time in days. Requires enrich=true.
                          example: 1.5
                        thumbnailUrl:
                          type:
                          - string
                          - 'null'
                          description: Listing thumbnail URL
                          example: https://di2ponv0v5otw.cloudfront.net/posts/2026/07/15/...
                        scrapedAt:
                          type: string
                          description: ISO timestamp when the listing was scraped
                          example: '2026-08-08T14:30:00.000Z'
                      required:
                      - listingId
                      - url
                      - title
                      - soldPrice
                      - originalPrice
                      - shippingCost
                      - brand
                      - size
                      - category
                      - condition
                      - nwt
                      - colors
                      - description
                      - soldAt
                      - listedAt
                      - daysToSell
                      - likesCount
                      - commentsCount
                      - shareCount
                      - sellerUsername
                      - sellerLocation
                      - sellerSoldCount
                      - sellerAvgShipTime
                      - thumbnailUrl
                      - scrapedAt
                  summary:
                    allOf:
                    - $ref: '#/components/schemas/PriceSummary'
                required:
                - keyword
                - page
                - totalItems
                - hasNextPage
                - items
                - summary
        '400':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  detail:
                    type: string
                required:
                - error
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limit or quota exceeded
          content:
            application/json:
              schema:
                oneOf:
                - type: object
                  properties:
                    code:
                      type: string
                      enum:
                      - rate_limited
                    error:
                      type: string
                    plan:
                      type: string
                    limit:
                      type: number
                    remaining:
                      type: number
                      enum:
                      - 0
                    retry_after:
                      type: number
                    reset:
                      type: number
                  required:
                  - code
                  - error
                  - plan
                  - limit
                  - remaining
                  - retry_after
                  - reset
                - type: object
                  properties:
                    code:
                      type: string
                      enum:
                      - quota_exceeded
                    error:
                      type: string
                    plan:
                      type: string
                    limit:
                      type: number
                    used:
                      type: number
                    remaining:
                      type: number
                      enum:
                      - 0
                    reset_at:
                      type: string
                    retry_after:
                      type: number
                    upgrade_url:
                      type: string
                  required:
                  - code
                  - error
                  - plan
                  - limit
                  - used
                  - remaining
                  - reset_at
                  - retry_after
                  - upgrade_url
        '500':
          description: Scrape failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  detail:
                    type: string
                required:
                - error
        '502':
          description: Poshmark fetch failed after retry
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  detail:
                    type: string
                required:
                - error
        '503':
          description: 'Server busy: concurrency limit reached; retry shortly'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  detail:
                    type: string
                required:
                - error
      operationId: searchPoshmarkSold
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.
  schemas:
    PriceSummary:
      type:
      - object
      - 'null'
      description: Deterministic price intelligence over the returned sold items.
      properties:
        count:
          type: integer
          description: Items with a usable sold price.
        currency:
          type:
          - string
          - 'null'
        median:
          type: number
        mean:
          type: number
        min:
          type: number
        max:
          type: number
        p25:
          type: number
          description: Lower bound of the realistic range.
        p75:
          type: number
          description: Upper bound of the realistic range.
        avgShipping:
          type:
          - number
          - 'null'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Send your API key as ''Authorization: Bearer cs_live_...''.'