# Poshmark

> Search for fashion listings on Poshmark marketplace.

Source: https://cotera.co/docs/reference/tools/individual-tools/poshmark

---

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

***

## Authentication

To authenticate, you'll need a RapidAPI key for the [Poshmark API](https://rapidapi.com/apimaker/api/poshmark).

**Note:** The free plan includes 15 requests per month.

***

## 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:**

```json
{
  "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)