Logo

Poshmark

Authentication Type: API Key
Description: Search for fashion listings on Poshmark marketplace.


Listings

Operations for Poshmark listings.

Search Listings

Search for fashion listings with filters for price, category, and sorting options.

Operation Type: Mutation (Write)

Parameters:

  • query string (required): Search query for listings
  • domain string (nullable): Domain to search (e.g., "com", "ca")
  • price_min number (nullable): Minimum price filter
  • price_max number (nullable): Maximum price filter
  • sort enum (nullable): Sort order
    • Options: "best_match", "added_desc", "price_desc", "price_asc", "price_drop", "like_count", "relevance_v2"
  • status enum (nullable): Listing status filter
    • Options: "available", "sold_out", "all", "coming_soon"

Returns:

  • data array of objects: Array of fashion listings
    • id string: Listing identifier
    • title string: Item title
    • description string: Item description
    • price_amount object: Price information
      • currency_symbol string: Currency symbol (e.g., "$")
      • currency_code string: Currency code (e.g., "USD")
      • val string: Price value
    • size_obj object: Size information
      • display_with_size_set string: Size display with size set
      • id string: Size identifier
      • display_with_size_system string: Size display with system
      • display_with_system_and_set string: Size display with system and set
      • display string: Size display text
      • size_system string (nullable): Size system (e.g., "US", "UK")
    • category_v2 object: Category information
      • message_id string: Category message ID
      • slug string: Category slug
      • display string: Category display name
      • id string: Category identifier
    • creator_picture_url string (nullable): Seller profile picture URL
    • creator_username string (nullable): Seller username
    • creator_full_name string (nullable): Seller full name
    • first_published_at string (nullable): First publication timestamp in ISO format
    • pictures array of objects (nullable): Product image information
      • id string (nullable): Picture identifier
      • url_large string (nullable): Large image URL
      • url string (nullable): Standard image URL
      • url_small string (nullable): Small image URL
      • url_large_webp string (nullable): Large WebP image URL
      • url_webp string (nullable): Standard WebP image URL
      • url_small_webp string (nullable): Small WebP image URL
      • path_large string (nullable): Large image path
      • path string (nullable): Standard image path
      • path_small string (nullable): Small image path
      • content_type string (nullable): Image content type
      • created_at string (nullable): Image upload timestamp
  • totalResultCount number (nullable): Total number of results available
  • next_page string (nullable): Next page token for pagination

Example Usage:

{
  "query": "vintage designer handbag",
  "domain": "com",
  "price_min": 50,
  "price_max": 500,
  "sort": "price_asc",
  "status": "available"
}

Common Use Cases

Fashion Market Research:

  • Analyze pricing trends for specific fashion categories and designer items
  • Research competitor pricing strategies and inventory across different domains
  • Track seasonal availability and popularity of fashion items using like counts and listing dates

Personal Shopping and Resale:

  • Search for specific designer items within budget constraints using price filters
  • Find available fashion items by size and category for personal wardrobe or resale business
  • Compare prices across different sellers for the same or similar fashion items

Inventory Management:

  • Monitor fashion marketplace trends by tracking newly added items and price changes
  • Analyze successful listings by sorting by likes and engagement metrics
  • Track which categories and price points are most popular in the fashion resale market

Business Intelligence:

  • Study seller profiles and success patterns to understand marketplace dynamics
  • Analyze category distribution and demand patterns across different fashion segments
  • Monitor international markets by searching across different domain regions (US, Canada)