---
title: "Browse Poshmark listings by category"
method: GET
path: "/poshmark/category/{path}"
tags: ["Poshmark"]
---

# Browse Poshmark listings by category

`GET /poshmark/category/{path}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/poshmark/category/{path}`
- Auth: API key in header `x-api-key`

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.

## Path parameters

- `path` string, required

## Query parameters

- `max_id` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PoshmarkCategoryResponse
  - `has_more` boolean: Whether more listings are available after this page.
  - `listings` PoshmarkListing[]: Listings on this page of the category.
    - `brand` string: Brand name of the item.
    - `category` string: Poshmark category of the item, for example `Shorts`.
    - `colors` string[]: Colors the seller selected for the item.
    - `comment_count` integer: Number of comments on the listing.
    - `condition` string: Item condition code set by the seller, for example `nwt` for new with tags.
    - `cover_shot` string: URL of the listing's cover photo.
    - `created_at` string: Time the listing was created, in ISO 8601 with a UTC offset.
    - `department` string: Poshmark department of the item, for example `Women`.
    - `description` string: Seller's description of the item. Set on the listing detail response.
    - `first_available_at` string: Time the listing first became available for sale, as Poshmark reports it.
    - `id` string: Poshmark listing id. Use it with the listing endpoint.
    - `inventory_status` string: Availability status of the item, for example `available`.
    - `like_count` integer: Number of members who liked the listing.
    - `original_price` number: Original retail price the seller entered for the item.
    - `pictures` string[]: URLs of all photos on the listing. Set on the listing detail response.
    - `price` number: Current asking price of the listing.
    - `quantity_available` integer: Total number of units still available across all sizes.
    - `seller_display_handle` string: Display handle of the seller who posted the listing.
    - `seller_full_name` string: Display name of the seller who posted the listing.
    - `seller_picture_url` string: Profile picture URL of the seller who posted the listing.
    - `seller_username` string: Username of the seller who posted the listing.
    - `share_count` integer: Number of times the listing was shared.
    - `size` string: Size of the item as entered by the seller.
    - `status` string: Publication status of the listing, for example `published`.
    - `title` string: Listing title as shown on Poshmark.
    - `url` string: Poshmark page URL of the listing.
  - `next_max_id` string: Cursor to pass as `max_id` to get the next page. Omitted on the last page.
  - `source_url` string: URL the data was read from.
  - `total` integer: Total number of listings Poshmark reports for the category.

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)