Catalog / Poshmark Public Marketplace

Poshmark Public Marketplace API

poshmark.com

Read-only access to public Poshmark search results, listing details, and seller closets. Search uses Poshmark's native query, filters, sort values, and opaque max_id cursor. Results are retrieved live over HTTP; authentication and private seller activity are not included.

  • shopping
  • poshmark
  • marketplace
  • resale
  • listings
3 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Poshmark Public Marketplace API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Search public Poshmark listings

Optional parameters 14

Free-text query, matched by Poshmark's search engine.

Native department name or slug, such as Women or Men.

Native category slug, such as Dresses.

Native sub-category value when supported by the selected category.

Repeatable native brand filter values.

Repeatable native size filter values.

Repeatable native price range values, passed unchanged to Poshmark.

Repeatable native color filter values.

Native condition value, such as all or new_with_tags.

Native availability value, such as available or sold_out.

Native Poshmark sort value, such as price_asc.

Opaque cursor returned as next_cursor; do not edit it.

Use Poshmark's native saved-size filter when available to the anonymous surface.

Native shipping-discount filter value.

View call pricing
cURL · Listings search
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/24dddbcc-d968-4068-9038-9aad169d34ca/v1/listings/search' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETListings by listing ref/v1/listings/{listing_ref}

Inspect one public Poshmark listing

Input

listing_refRequiredPath · string

A Poshmark listing id or canonical listing slug returned by search.

Example: 6ad93666b5522323103ef3a9

Response

seller?object
seller.id?string | null
seller.gender?string | null
seller.status?string | null
seller.su_level?string | null
seller.username?string | null
seller.full_name?string | null
seller.last_name?string | null
seller.aggregates?object
seller.aggregates.likes?integer | null
seller.aggregates.posts?integer | null
seller.aggregates.shares?integer | null
seller.aggregates.comments?integer | null
seller.aggregates.followers?integer | null
seller.aggregates.following?integer | null
seller.aggregates.items_sold_display?string | null
seller.aggregates.seller_orders_shipped?integer | null
seller.aggregates.buyer_5_star_rating_comment_count?integer | null
seller.aggregates.seller_5_star_rating_comment_count?integer | null
seller.created_at?string | null
seller.first_name?string | null
seller.profile_v2?object
seller.profile_v2.city?string | null
seller.profile_v2.state?string | null
seller.profile_v2.website?string | null
seller.profile_v2.college_id?string | null
seller.profile_v2.description?string | null
seller.profile_v2.college_year?string | null
seller.profile_v2.city_state_id?string | null
seller.home_domain?string | null
seller.picture_url?string | null
seller.source_record?object
seller.display_handle?string | null
seller.last_active_at?string | null
listingobject
listing.brand?string | null
listing.price?object
listing.price.val?string | null
listing.price.currency_code?string | null
listing.price.currency_symbol?string | null
listing.title?string | null
listing.colors?object[]
listing.colors[].rgb?string | null
listing.colors[].name?string | null
listing.colors[].message_id?string | null
listing.status?string | null
listing.category?string | null
listing.pictures?object[]
listing.pictures[].id?string | null
listing.pictures[].url?string | null
listing.pictures[].path?string | null
listing.pictures[].url_webp?string | null
listing.pictures[].url_large?string | null
listing.pictures[].url_small?string | null
listing.pictures[].created_at?string | null
listing.pictures[].content_type?string | null
listing.condition?string | null
listing.inventory?object
listing.inventory.status?string | null
listing.inventory.multi_item?boolean | null
listing.inventory.size_quantities?object[]
listing.inventory.size_quantities[].size_id?string | null
listing.inventory.size_quantities[].size_obj?object
listing.inventory.size_quantities[].size_obj.id?string | null
listing.inventory.size_quantities[].size_obj.display?string | null
listing.inventory.size_quantities[].size_obj.size_system?string | null
listing.inventory.size_quantities[].size_obj.display_with_size_set?string | null
listing.inventory.size_quantities[].size_obj.display_with_size_system?string | null
listing.inventory.size_quantities[].size_obj.display_with_system_and_set?string | null
listing.inventory.size_quantities[].size_ref?integer | null
listing.inventory.size_quantities[].size_system?string | null
listing.inventory.size_quantities[].quantity_sold?integer | null
listing.inventory.size_quantities[].size_set_tags?string[]
listing.inventory.size_quantities[].quantity_reserved?integer | null
listing.inventory.size_quantities[].quantity_available?integer | null
listing.inventory.status_changed_at?string | null
listing.inventory.size_quantity_revision?integer | null
listing.seller_id?string | null
listing.cover_shot?object
listing.cover_shot.id?string | null
listing.cover_shot.url?string | null
listing.cover_shot.path?string | null
listing.cover_shot.url_webp?string | null
listing.cover_shot.url_large?string | null
listing.cover_shot.url_small?string | null
listing.cover_shot.created_at?string | null
listing.cover_shot.content_type?string | null
listing.listing_id?string | null
listing.source_url?string | null
listing.description?string | null
listing.source_record?object
listing.original_price?object
listing.original_price.val?string | null
listing.original_price.currency_code?string | null
listing.original_price.currency_symbol?string | null
listing.seller_username?string | null

Fields marked ? are optional.

GETSellers by username/v1/sellers/{username}

Inspect a public seller and current closet listings

Input

usernameRequiredPath · string

Public Poshmark username from a listing's seller_username or source URL.

Example: gj0909

max_idOptionalQuery · string | null

Opaque seller-closet cursor returned as next_cursor.

Example: ENC_eyJtYXhfaWRzIjpbNDksMSwxXSw...

Response

sellerobject
seller.id?string | null
seller.gender?string | null
seller.status?string | null
seller.su_level?string | null
seller.username?string | null
seller.full_name?string | null
seller.last_name?string | null
seller.aggregates?object
seller.aggregates.likes?integer | null
seller.aggregates.posts?integer | null
seller.aggregates.shares?integer | null
seller.aggregates.comments?integer | null
seller.aggregates.followers?integer | null
seller.aggregates.following?integer | null
seller.aggregates.items_sold_display?string | null
seller.aggregates.seller_orders_shipped?integer | null
seller.aggregates.buyer_5_star_rating_comment_count?integer | null
seller.aggregates.seller_5_star_rating_comment_count?integer | null
seller.created_at?string | null
seller.first_name?string | null
seller.profile_v2?object
seller.profile_v2.city?string | null
seller.profile_v2.state?string | null
seller.profile_v2.website?string | null
seller.profile_v2.college_id?string | null
seller.profile_v2.description?string | null
seller.profile_v2.college_year?string | null
seller.profile_v2.city_state_id?string | null
seller.home_domain?string | null
seller.picture_url?string | null
seller.source_record?object
seller.display_handle?string | null
seller.last_active_at?string | null
has_moreboolean
listingsobject[]
listings[].brand?string | null
listings[].price?object
listings[].price.val?string | null
listings[].price.currency_code?string | null
listings[].price.currency_symbol?string | null
listings[].title?string | null
listings[].colors?object[]
listings[].colors[].rgb?string | null
listings[].colors[].name?string | null
listings[].colors[].message_id?string | null
listings[].status?string | null
listings[].category?string | null
listings[].pictures?object[]
listings[].pictures[].id?string | null
listings[].pictures[].url?string | null
listings[].pictures[].path?string | null
listings[].pictures[].url_webp?string | null
listings[].pictures[].url_large?string | null
listings[].pictures[].url_small?string | null
listings[].pictures[].created_at?string | null
listings[].pictures[].content_type?string | null
listings[].condition?string | null
listings[].inventory?object
listings[].inventory.status?string | null
listings[].inventory.multi_item?boolean | null
listings[].inventory.size_quantities?object[]
listings[].inventory.size_quantities[].size_id?string | null
listings[].inventory.size_quantities[].size_obj?object
listings[].inventory.size_quantities[].size_obj.id?string | null
listings[].inventory.size_quantities[].size_obj.display?string | null
listings[].inventory.size_quantities[].size_obj.size_system?string | null
listings[].inventory.size_quantities[].size_obj.display_with_size_set?string | null
listings[].inventory.size_quantities[].size_obj.display_with_size_system?string | null
listings[].inventory.size_quantities[].size_obj.display_with_system_and_set?string | null
listings[].inventory.size_quantities[].size_ref?integer | null
listings[].inventory.size_quantities[].size_system?string | null
listings[].inventory.size_quantities[].quantity_sold?integer | null
listings[].inventory.size_quantities[].size_set_tags?string[]
listings[].inventory.size_quantities[].quantity_reserved?integer | null
listings[].inventory.size_quantities[].quantity_available?integer | null
listings[].inventory.status_changed_at?string | null
listings[].inventory.size_quantity_revision?integer | null
listings[].seller_id?string | null
listings[].cover_shot?object
listings[].cover_shot.id?string | null
listings[].cover_shot.url?string | null
listings[].cover_shot.path?string | null
listings[].cover_shot.url_webp?string | null
listings[].cover_shot.url_large?string | null
listings[].cover_shot.url_small?string | null
listings[].cover_shot.created_at?string | null
listings[].cover_shot.content_type?string | null
listings[].listing_id?string | null
listings[].source_url?string | null
listings[].description?string | null
listings[].source_record?object
listings[].original_price?object
listings[].original_price.val?string | null
listings[].original_price.currency_code?string | null
listings[].original_price.currency_symbol?string | null
listings[].seller_username?string | null
usernamestring
seller_id?string | null
source_urlstring
next_cursor?string | null
source_more?object
listing_total?integer | null
returned_countinteger

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.