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
- currency_symbol
- 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")
- display_with_size_set
- category_v2
object
: Category information- message_id
string
: Category message ID - slug
string
: Category slug - display
string
: Category display name - id
string
: Category identifier
- message_id
- 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
- id
- id
- 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)