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)