Poshmark Item Search API Documentation Search Poshmark fashion listings in the US or Canada. Every item has the id, url, title, description, brand, department, category path, colours, condition, size and size variants with stock, price and original price as numbers with currency, discount, first listed price, full size photos, likes, comments count, listing date and the seller username. Set availability to sold to read sold items: each one adds sold, sold_at, sold_price and days_to_sell. Filters are enforced on every returned item: a brand filter returns that brand only (not Zara Basic for Zara), a size filter returns items that have the size, and the price, condition, colour, department and category filters hold for every row. A page can hold fewer than 48 items after this check. Poshmark pages forward only: send pagination.next_cursor as cursor. Items repeated between pages are removed. Poshmark returns at most 5000 items per query; total is the match count before the exact brand and size check. Sold search checks the condition on the 48 items of each page, so a page can hold fewer items. Cost: 1 credit per request, only for successful requests.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
15 optional filters available.
string
Optional
Search text, e.g. jacket. Required unless you send a brand or a category.
coffee shops
string
Optional
Brand name as Poshmark spells it, comma separated for several, e.g. Zara. Matches the exact brand only. Use the suggestions endpoint for the spelling.
example
string
Optional
Women, Men or Kids. Required when you send a category.
example
string
Optional
Category slug taken from the category.slug of a result row, e.g. Jackets_&_Coats. Needs a department. An unknown slug gives a 422.
example
string
Optional
Sub category slug taken from category_features[].slug of a result row, e.g. Utility_Jackets. Needs a category. Not used for sold search.
example
string
Optional
Size as shown on Poshmark, comma separated for several, e.g. M or 8,8.5. Items with that size in any variant match.
example
string
Optional
nwt (new with tags), uln (like new), ug (good) or uf (fair). Comma separated for several.
example
string
Optional
Colour name, comma separated for several, e.g. Black.
example
number
Optional
Lowest price in the currency of the country, e.g. 10.
10
number
Optional
Highest price in the currency of the country, e.g. 60.
10
string
Optional
available (default), sold, not_for_sale or all. Sold returns sold items with sale price and date.
example
string
Optional
relevance (default), price_asc, price_desc, added_desc, price_drop or like_count.
relevance
string
Optional
The pagination.next_cursor value of the previous response. Poshmark has no page numbers; page above 1 gives a 422.
0
integer
Optional
Items per page, 1 to 48. Defaults to 48. Sold search always returns 48.
10
string
Optional
Poshmark site: us (poshmark.com, USD) or ca (poshmark.ca, CAD). Defaults to us. Australia and India closed in 2023.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
meta
items
country
success
pagination
filters_applied
Common items fields
id
url
size
sold
{
"meta": {
"billable": true,
"endpoint_family": "search"
},
"items": [
{
"id": "6ae92ff4b55223d89d84966c",
"url": "https://poshmark.com/listing/6ae92ff4b55223d89d84966c",
"size": "S",
"sold": false,
"brand": "Zara",
"likes": 0,
"price": {
"amount": 48,
"currency": "USD"
},
"sizes": [
{
"size": "S",
"quantity_sold": 0,
"quantity_reserved": 0,
"quantity_available": 1
}
],
"title": "Zara Olive Green Military Patch Long Duster Jacket",
"colors": [
"Green"
],
"images": [
{
"url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/l_6ae93003b9dd70e489e799bc.jpg",
"thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/s_6ae93003b9dd70e489e799bc.jpg"
},
{
"url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/l_6ae9300424cc87d28cea1801.jpg",
"thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/s_6ae9300424cc87d28cea1801.jpg"
},
{
"url": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/l_6ae930058091ef04c79ac971.jpg",
"thumbnail": "https://di2ponv0v5otw.cloudfront.net/posts/2026/11/02/6ae92ff4b55223d89d84966c/s_6ae930058091ef04c79ac971.jpg"
}
],
"seller": {
"username": "example_closet",
"picture_url": "https://di2ponv0v5otw.cloudfront.net/users/2026/02/07/8/t_698767ff3972a844fea8edaf.jpg",
"display_handle": "example_closet"
},
"shares": 0,
"sold_at": null,
"category": {
"name": "Jackets & Coats",
"slug": "Jackets_&_Coats"
},
"discount": {
"amount": 81,
"percent": 62.8
},
"condition": {
"code": "uln",
"label": "Like new"
},
"listed_at": "2026-11-04T11:51:18+00:00",
"department": "Women",
"sold_price": null,
"updated_at": "2026-11-04T12:31:57+00:00",
"description": "Stylish Zara olive green long duster jacket featuring military-inspired detailing, embroidered patches, button-front closure, pointed collar, chest pocket, and subtle contrast trim. Relaxed, oversized silhouette with side slits. Perfect for layering and adding a vintage-inspired utility look to any outfit.\n\n19.4\u201d armpit to armpit flat\n41\u201d shoulder to hem",
"availability": "available",
"days_to_sell": null,
"category_path": [
"Women",
"Jackets & Coats",
"Utility Jackets"
],
"comments_count": 0,
"original_price": {
"amount": 129,
"currency": "USD"
},
"category_features": [
{
"name": "Utility Jackets",
"slug": "Utility_Jackets"
}
],
"first_listed_price": {
"amount": 48,
"currency": "USD"
}
}
],
"country": "us",
"success": true,
"pagination": {
"count": 48,
"total": 5000,
"has_more": true,
"next_cursor": "ENC_eyJtYXhfaWRzIjpbNiwxLDFd",
"total_capped": true
},
"filters_applied": {
"sort": "relevance",
"brand": [
"Zara"
],
"query": "jacket",
"availability": "available"
}
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"department": [
"A category needs its department: Women, Men or Kids."
]
},
"message": "The request validation failed"
}Unknown Category
The category or category feature is not known to Poshmark. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "search"
},
"error": {
"code": "INVALID_REQUEST",
"message": "The category \"Nonsense\" is not a Poshmark category of this department. Use the category slug of a result row, e.g. Jackets_&_Coats."
},
"success": false
}Upstream Unavailable
Poshmark could not be reached or answered with an unexpected shape. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Poshmark is temporarily unavailable. Please retry."
},
"success": false
}Upstream Timeout
Poshmark did not answer in time. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_TIMEOUT",
"message": "Poshmark did not answer in time. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.