Poshmark API endpoint
Returns a page of Poshmark listings for a given category path (e.g. Women-Shoes, Men-Shirts), the same browsing view as Poshmark's own category pages. Pass a previous response's next_max_id back as max_id to fetch the next page.
/poshmark/category/{path}Path parameters:
path (required) — the category path segment of a /category/{path}
URL, e.g. Women-Shoes.Query parameters:
max_id (optional) — an opaque pagination cursor from a previous
response's next_max_id. Omit for the first page.Notable response behavior:
total reflects Poshmark's full matching-result count for the category,
not just len(listings).next_max_id is an opaque, server-issued pagination cursor. Pass it back
as max_id on a subsequent request (with the same path) to fetch the
next page.404.| Field | Filled in, of 48 checked | Values in the sample |
|---|---|---|
| id | 48 | |
| title | 48 | “FINN COMFORT-Andermatt-Navy Blue Wool Slip-On Slippers/Mule…” and 47 other values |
| description | 48 | median 348 characters |
| price | 48 | 10 to 899, median 49 |
| condition | 33 | ug (15), uln (8), nwt (8) and 2 more |
| brand | 48 | “Finn Comfort” and 46 other values |
| category | 48 | Shoes in all 48 |
| department | 48 | Women in all 48 |
| size | 48 | “9.5” and 25 other values |
| colors | 47 | median 1 entry |
| status | 48 | published in all 48 |
| cover_shot | 48 | di2ponv0v5otw.cloudfront.net |
| pictures | 48 | median 7 entries |
| share_count | 43 | 2 to 2,223, median 45 |
| inventory_status | 48 | available in all 48 |
| quantity_available | 48 | 1 to 4, median 1 |
| created_at | 48 | 2021-12-13 to 2026-10-12 |
| first_available_at | 48 | 2021-12-13 to 2026-10-12 |
| seller_username | 48 | |
| seller_display_handle | 48 | |
| seller_full_name | 48 | |
| seller_picture_url | 48 | di2ponv0v5otw.cloudfront.net and 1 other host |
| url | 48 | poshmark.com |
| like_count | 23 | 1 to 110, median 2 |
| original_price | 25 | 29 to 1,500, median 160 |
| comment_count | 3 | 2 to 7, median 2 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| path (path) | string | Yes | Poshmark category path segment, e.g. Women-Shoes, Men-Shirts | Women-Shoes | |
| max_id | string | No | Opaque pagination cursor from a previous response's next_max_id. Omit for the first page | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/poshmark/category/Women-Shoes" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"total": 84000,
"has_more": true,
"listings": [
{
"id": "6a2222222222222222222222",
"title": "Nike Air Max",
"price": 60,
"brand": "Nike",
"department": "Women"
}
],
"source_url": "https://poshmark.com/category/Women-Shoes"
}
}Request schema
No body schema
Response schema
#/definitions/poshmark.CategoryResponse
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| has_more | boolean | No | true | Whether more listings are available after this page. | ||
| listings | array | No | Listings on this page of the category. | |||
| listings[].brand | string | No | FARM Rio | Brand name of the item. | ||
| listings[].category | string | No | Shorts | Poshmark category of the item, for example `Shorts`. | ||
| listings[].colors | array | No | Red,Yellow | Colors the seller selected for the item. | ||
| listings[].comment_count | integer | No | 4 | Number of comments on the listing. | ||
| listings[].condition | string | No | nwt | Item condition code set by the seller, for example `nwt` for new with tags. | ||
| listings[].cover_shot | string | No | https://di2ponv0v5otw.cloudfront.net/posts/2026/06/27/6a3fed1de9c77df92e2c0cc6/s_6a3fed24bd4ce3ff762126e5.jpg | URL of the listing's cover photo. | ||
| listings[].created_at | string | No | 2026-06-27T08:32:58-07:00 | Time the listing was created, in ISO 8601 with a UTC offset. | ||
| listings[].department | string | No | Women | Poshmark department of the item, for example `Women`. | ||
| listings[].description | string | No | Seller's description of the item. Set on the listing detail response. | |||
| listings[].first_available_at | string | No | Time the listing first became available for sale, as Poshmark reports it. | |||
| listings[].id | string | No | 6a3fed1de9c77df92e2c0cc6 | Poshmark listing id. Use it with the listing endpoint. | ||
| listings[].inventory_status | string | No | available | Availability status of the item, for example `available`. | ||
| listings[].like_count | integer | No | 111 | Number of members who liked the listing. | ||
| listings[].original_price | number | No | 95 | Original retail price the seller entered for the item. | ||
| listings[].pictures | array | No | URLs of all photos on the listing. Set on the listing detail response. | |||
| listings[].price | number | No | 55 | Current asking price of the listing. | ||
| listings[].quantity_available | integer | No | 1 | Total number of units still available across all sizes. | ||
| listings[].seller_display_handle | string | No | maltimar | Display handle of the seller who posted the listing. | ||
| listings[].seller_full_name | string | No | Mary Altimar | Display name of the seller who posted the listing. | ||
| listings[].seller_picture_url | string | No | Profile picture URL of the seller who posted the listing. | |||
| listings[].seller_username | string | No | maltimar | Username of the seller who posted the listing. | ||
| listings[].share_count | integer | No | 13 | Number of times the listing was shared. | ||
| listings[].size | string | No | S | Size of the item as entered by the seller. | ||
| listings[].status | string | No | published | Publication status of the listing, for example `published`. | ||
| listings[].title | string | No | NWT Farm Rio Shorts | Listing title as shown on Poshmark. | ||
| listings[].url | string | No | https://poshmark.com/listing/6a3fed1de9c77df92e2c0cc6 | Poshmark page URL of the listing. | ||
| next_max_id | string | No | Cursor to pass as `max_id` to get the next page. Omitted on the last page. | |||
| source_url | string | No | URL the data was read from. | |||
| total | integer | No | 84000 | Total number of listings Poshmark reports for the category. |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/poshmark/category/Women-Shoes" \
-H "x-api-key: $CRAWLORA_API_KEY"