Poshmark Public Marketplace API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 search/v1/listings/search
Search public Poshmark listings
Input
queryOptionalQuery · string | nullFree-text query, matched by Poshmark's search engine.
Example: dress
departmentOptionalQuery · string | nullNative department name or slug, such as Women or Men.
Example: Women
categoryOptionalQuery · string | nullNative category slug, such as Dresses.
Example: Dresses
sub_categoryOptionalQuery · string | nullNative sub-category value when supported by the selected category.
Example: Midi
brand[]OptionalQuery · array | nullRepeatable native brand filter values.
Example: COS
size[]OptionalQuery · array | nullRepeatable native size filter values.
Example: US 4 / CA 4 / MX 4
price[]OptionalQuery · array | nullRepeatable native price range values, passed unchanged to Poshmark.
Example: 0-25
color[]OptionalQuery · array | nullRepeatable native color filter values.
Example: black
conditionOptionalQuery · string | nullNative condition value, such as all or new_with_tags.
Example: all
availabilityOptionalQuery · string | nullNative availability value, such as available or sold_out.
Example: available
sort_byOptionalQuery · string | nullNative Poshmark sort value, such as price_asc.
Example: price_asc
max_idOptionalQuery · string | nullOpaque cursor returned as next_cursor; do not edit it.
Example: ENC_eyJtYXhfaWRzIjpbNDksMSwxXSw...
my_sizeOptionalQuery · boolean | nullUse Poshmark's native saved-size filter when available to the anonymous surface.
Example: false
shipping_discount_typeOptionalQuery · string | nullNative shipping-discount filter value.
Example: free
Response
itemsobject[]items[].brand?string | nullitems[].price?objectitems[].price.val?string | nullitems[].price.currency_code?string | nullitems[].price.currency_symbol?string | nullitems[].title?string | nullitems[].colors?object[]items[].colors[].rgb?string | nullitems[].colors[].name?string | nullitems[].colors[].message_id?string | nullitems[].status?string | nullitems[].category?string | nullitems[].pictures?object[]items[].pictures[].id?string | nullitems[].pictures[].url?string | nullitems[].pictures[].path?string | nullitems[].pictures[].url_webp?string | nullitems[].pictures[].url_large?string | nullitems[].pictures[].url_small?string | nullitems[].pictures[].created_at?string | nullitems[].pictures[].content_type?string | nullitems[].condition?string | nullitems[].inventory?objectitems[].inventory.status?string | nullitems[].inventory.multi_item?boolean | nullitems[].inventory.size_quantities?object[]items[].inventory.size_quantities[].size_id?string | nullitems[].inventory.size_quantities[].size_obj?objectitems[].inventory.size_quantities[].size_obj.id?string | nullitems[].inventory.size_quantities[].size_obj.display?string | nullitems[].inventory.size_quantities[].size_obj.size_system?string | nullitems[].inventory.size_quantities[].size_obj.display_with_size_set?string | nullitems[].inventory.size_quantities[].size_obj.display_with_size_system?string | nullitems[].inventory.size_quantities[].size_obj.display_with_system_and_set?string | nullitems[].inventory.size_quantities[].size_ref?integer | nullitems[].inventory.size_quantities[].size_system?string | nullitems[].inventory.size_quantities[].quantity_sold?integer | nullitems[].inventory.size_quantities[].size_set_tags?string[]items[].inventory.size_quantities[].quantity_reserved?integer | nullitems[].inventory.size_quantities[].quantity_available?integer | nullitems[].inventory.status_changed_at?string | nullitems[].inventory.size_quantity_revision?integer | nullitems[].seller_id?string | nullitems[].cover_shot?objectitems[].cover_shot.id?string | nullitems[].cover_shot.url?string | nullitems[].cover_shot.path?string | nullitems[].cover_shot.url_webp?string | nullitems[].cover_shot.url_large?string | nullitems[].cover_shot.url_small?string | nullitems[].cover_shot.created_at?string | nullitems[].cover_shot.content_type?string | nullitems[].listing_id?string | nullitems[].source_url?string | nullitems[].description?string | nullitems[].source_record?objectitems[].original_price?objectitems[].original_price.val?string | nullitems[].original_price.currency_code?string | nullitems[].original_price.currency_symbol?string | nullitems[].seller_username?string | nullfacets?objecthas_morebooleannext_cursor?string | nullsource_more?objecttotal_count?integer | nullsearch_window?integer | nullreturned_countintegersource_query_hash?string | nullFields marked ? are optional.
GETListings by listing ref/v1/listings/{listing_ref}
Inspect one public Poshmark listing
Input
listing_refRequiredPath · stringA Poshmark listing id or canonical listing slug returned by search.
Example: 6ad93666b5522323103ef3a9
Response
seller?objectseller.id?string | nullseller.gender?string | nullseller.status?string | nullseller.su_level?string | nullseller.username?string | nullseller.full_name?string | nullseller.last_name?string | nullseller.aggregates?objectseller.aggregates.likes?integer | nullseller.aggregates.posts?integer | nullseller.aggregates.shares?integer | nullseller.aggregates.comments?integer | nullseller.aggregates.followers?integer | nullseller.aggregates.following?integer | nullseller.aggregates.items_sold_display?string | nullseller.aggregates.seller_orders_shipped?integer | nullseller.aggregates.buyer_5_star_rating_comment_count?integer | nullseller.aggregates.seller_5_star_rating_comment_count?integer | nullseller.created_at?string | nullseller.first_name?string | nullseller.profile_v2?objectseller.profile_v2.city?string | nullseller.profile_v2.state?string | nullseller.profile_v2.website?string | nullseller.profile_v2.college_id?string | nullseller.profile_v2.description?string | nullseller.profile_v2.college_year?string | nullseller.profile_v2.city_state_id?string | nullseller.home_domain?string | nullseller.picture_url?string | nullseller.source_record?objectseller.display_handle?string | nullseller.last_active_at?string | nulllistingobjectlisting.brand?string | nulllisting.price?objectlisting.price.val?string | nulllisting.price.currency_code?string | nulllisting.price.currency_symbol?string | nulllisting.title?string | nulllisting.colors?object[]listing.colors[].rgb?string | nulllisting.colors[].name?string | nulllisting.colors[].message_id?string | nulllisting.status?string | nulllisting.category?string | nulllisting.pictures?object[]listing.pictures[].id?string | nulllisting.pictures[].url?string | nulllisting.pictures[].path?string | nulllisting.pictures[].url_webp?string | nulllisting.pictures[].url_large?string | nulllisting.pictures[].url_small?string | nulllisting.pictures[].created_at?string | nulllisting.pictures[].content_type?string | nulllisting.condition?string | nulllisting.inventory?objectlisting.inventory.status?string | nulllisting.inventory.multi_item?boolean | nulllisting.inventory.size_quantities?object[]listing.inventory.size_quantities[].size_id?string | nulllisting.inventory.size_quantities[].size_obj?objectlisting.inventory.size_quantities[].size_obj.id?string | nulllisting.inventory.size_quantities[].size_obj.display?string | nulllisting.inventory.size_quantities[].size_obj.size_system?string | nulllisting.inventory.size_quantities[].size_obj.display_with_size_set?string | nulllisting.inventory.size_quantities[].size_obj.display_with_size_system?string | nulllisting.inventory.size_quantities[].size_obj.display_with_system_and_set?string | nulllisting.inventory.size_quantities[].size_ref?integer | nulllisting.inventory.size_quantities[].size_system?string | nulllisting.inventory.size_quantities[].quantity_sold?integer | nulllisting.inventory.size_quantities[].size_set_tags?string[]listing.inventory.size_quantities[].quantity_reserved?integer | nulllisting.inventory.size_quantities[].quantity_available?integer | nulllisting.inventory.status_changed_at?string | nulllisting.inventory.size_quantity_revision?integer | nulllisting.seller_id?string | nulllisting.cover_shot?objectlisting.cover_shot.id?string | nulllisting.cover_shot.url?string | nulllisting.cover_shot.path?string | nulllisting.cover_shot.url_webp?string | nulllisting.cover_shot.url_large?string | nulllisting.cover_shot.url_small?string | nulllisting.cover_shot.created_at?string | nulllisting.cover_shot.content_type?string | nulllisting.listing_id?string | nulllisting.source_url?string | nulllisting.description?string | nulllisting.source_record?objectlisting.original_price?objectlisting.original_price.val?string | nulllisting.original_price.currency_code?string | nulllisting.original_price.currency_symbol?string | nulllisting.seller_username?string | nullFields marked ? are optional.
GETSellers by username/v1/sellers/{username}
Inspect a public seller and current closet listings
Input
usernameRequiredPath · stringPublic Poshmark username from a listing's seller_username or source URL.
Example: gj0909
max_idOptionalQuery · string | nullOpaque seller-closet cursor returned as next_cursor.
Example: ENC_eyJtYXhfaWRzIjpbNDksMSwxXSw...
Response
sellerobjectseller.id?string | nullseller.gender?string | nullseller.status?string | nullseller.su_level?string | nullseller.username?string | nullseller.full_name?string | nullseller.last_name?string | nullseller.aggregates?objectseller.aggregates.likes?integer | nullseller.aggregates.posts?integer | nullseller.aggregates.shares?integer | nullseller.aggregates.comments?integer | nullseller.aggregates.followers?integer | nullseller.aggregates.following?integer | nullseller.aggregates.items_sold_display?string | nullseller.aggregates.seller_orders_shipped?integer | nullseller.aggregates.buyer_5_star_rating_comment_count?integer | nullseller.aggregates.seller_5_star_rating_comment_count?integer | nullseller.created_at?string | nullseller.first_name?string | nullseller.profile_v2?objectseller.profile_v2.city?string | nullseller.profile_v2.state?string | nullseller.profile_v2.website?string | nullseller.profile_v2.college_id?string | nullseller.profile_v2.description?string | nullseller.profile_v2.college_year?string | nullseller.profile_v2.city_state_id?string | nullseller.home_domain?string | nullseller.picture_url?string | nullseller.source_record?objectseller.display_handle?string | nullseller.last_active_at?string | nullhas_morebooleanlistingsobject[]listings[].brand?string | nulllistings[].price?objectlistings[].price.val?string | nulllistings[].price.currency_code?string | nulllistings[].price.currency_symbol?string | nulllistings[].title?string | nulllistings[].colors?object[]listings[].colors[].rgb?string | nulllistings[].colors[].name?string | nulllistings[].colors[].message_id?string | nulllistings[].status?string | nulllistings[].category?string | nulllistings[].pictures?object[]listings[].pictures[].id?string | nulllistings[].pictures[].url?string | nulllistings[].pictures[].path?string | nulllistings[].pictures[].url_webp?string | nulllistings[].pictures[].url_large?string | nulllistings[].pictures[].url_small?string | nulllistings[].pictures[].created_at?string | nulllistings[].pictures[].content_type?string | nulllistings[].condition?string | nulllistings[].inventory?objectlistings[].inventory.status?string | nulllistings[].inventory.multi_item?boolean | nulllistings[].inventory.size_quantities?object[]listings[].inventory.size_quantities[].size_id?string | nulllistings[].inventory.size_quantities[].size_obj?objectlistings[].inventory.size_quantities[].size_obj.id?string | nulllistings[].inventory.size_quantities[].size_obj.display?string | nulllistings[].inventory.size_quantities[].size_obj.size_system?string | nulllistings[].inventory.size_quantities[].size_obj.display_with_size_set?string | nulllistings[].inventory.size_quantities[].size_obj.display_with_size_system?string | nulllistings[].inventory.size_quantities[].size_obj.display_with_system_and_set?string | nulllistings[].inventory.size_quantities[].size_ref?integer | nulllistings[].inventory.size_quantities[].size_system?string | nulllistings[].inventory.size_quantities[].quantity_sold?integer | nulllistings[].inventory.size_quantities[].size_set_tags?string[]listings[].inventory.size_quantities[].quantity_reserved?integer | nulllistings[].inventory.size_quantities[].quantity_available?integer | nulllistings[].inventory.status_changed_at?string | nulllistings[].inventory.size_quantity_revision?integer | nulllistings[].seller_id?string | nulllistings[].cover_shot?objectlistings[].cover_shot.id?string | nulllistings[].cover_shot.url?string | nulllistings[].cover_shot.path?string | nulllistings[].cover_shot.url_webp?string | nulllistings[].cover_shot.url_large?string | nulllistings[].cover_shot.url_small?string | nulllistings[].cover_shot.created_at?string | nulllistings[].cover_shot.content_type?string | nulllistings[].listing_id?string | nulllistings[].source_url?string | nulllistings[].description?string | nulllistings[].source_record?objectlistings[].original_price?objectlistings[].original_price.val?string | nulllistings[].original_price.currency_code?string | nulllistings[].original_price.currency_symbol?string | nulllistings[].seller_username?string | nullusernamestringseller_id?string | nullsource_urlstringnext_cursor?string | nullsource_more?objectlisting_total?integer | nullreturned_countintegerFields 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.
An account is required to submit an extension. Prepare your request, then sign in to build.