---
title: "Search Poshmark listings"
method: GET
path: "/poshmark/search"
tags: ["Poshmark"]
---

# Search Poshmark listings

`GET /poshmark/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/poshmark/search`
- Auth: API key in header `x-api-key`

Searches Poshmark for clothing, shoes, and accessory listings, returning listing summaries (title, price, brand, size, condition, seller, images) plus the total matching count and an opaque pagination cursor. Pass a previous response's next_max_id back as max_id to fetch the next page.

## Query parameters

- `query` string, required
- `department` string
- `max_id` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PoshmarkSearchResponseDoc
  - `code` integer
  - `data` PoshmarkSearchResponse
    - `has_more` boolean
    - `listings` PoshmarkListing[]
      - `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
    - `source_url` string
    - `total` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `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)