API reference
Marketplace
Search and browse everything for sale. No key needed.
No key needed
These read what any visitor to resell.store can see: listed stores and things for sale. Send a key anyway and listings say whether you've liked them, and stores whether you follow them. To act on them, see Likes and follows and Offers.
Read a store's reviews
GET
/v1/stores/:slug/reviewsNo key needed
What buyers said about a store, newest first, with the seller's replies. Only people who bought can review, and only public reviews show. No key needed. Pass next_cursor back as cursor for the next page.
Path
slugstringrequired- The shop's slug.
Query
ratinginteger- Only reviews with this many stars.
limitintegerdefault 10- How many to return, 1 to 50. Default 10.
cursorstringnext_cursorfrom the page before.
curl https://api.resell.store/v1/stores/maya/reviewsResponse
{
"object": "list",
"rating": {
"average": 4.8,
"count": 12
},
"data": [
{
"object": "review",
"id": "5b2e…",
"rating": 5,
"body": "Exactly like the photos, and packed with a little note.",
"from": "Priya",
"created_at": "2026-10-05T10:00:00.000Z",
"reply": {
"body": "Thank you, Priya! Enjoy it.",
"created_at": "2026-10-05T12:00:00.000Z"
},
"listing": {
"id": "8d1e6c2a-…",
"title": "Linen wrap dress",
"url": "https://maya.resell.store/linen-wrap-dress"
},
"shop": {
"slug": "maya",
"name": "Maya's closet"
}
}
],
"next_cursor": "5b2e…",
"has_more": true
}Search the marketplace
GET
/v1/market/searchNo key needed
Search everything for sale on resell.store, by words and by meaning ("something to cook stew in" finds dutch ovens). No key needed. With a key, each result says whether you've liked it.
Query
qstring- What you're looking for. Leave out to browse.
category"Clothing" | "Shoes" | "Bags" | "Home" | "Collectibles" | "Books" | "Tech" | "Kids" | "Garden"- One of: Clothing, Shoes, Bags, Home, Collectibles, Books, Tech, Kids, Garden.
price"any" | "under-25" | "25-100" | "over-100"default "any"- any, under-25, 25-100 or over-100.
offersboolean- Only things open to offers.
sort"best" | "newest" | "price-asc" | "price-desc"- best (with a query), newest, price-asc or price-desc.
limitintegerdefault 20offsetintegerdefault 0- How many to skip, for the next page.
curl https://api.resell.store/v1/market/search?q=dutch%20oven&price=over-100Response
{
"object": "search_result",
"data": [
{
"object": "public_listing",
"id": "8d1e6c2a-…",
"slug": "yellow-le-creuset-dutch-oven-5-5-qt",
"store": "maya",
"title": "Yellow Le Creuset dutch oven, 5.5 qt",
"one_liner": "The good one, barely used, ready for soup season",
"price": 185,
"shipping": 18,
"photo": "https://files.resell.store/…",
"category": "Home",
"open_to_offers": true,
"sold": false,
"just_listed": false,
"url": "https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt",
"seller": {
"name": "Maya's closet"
},
"liked": false
}
],
"total": 3,
"stores": 2,
"has_more": true
}Look at a listing
GET
/v1/market/listings/:idNo key needed
Everything a buyer sees on a listing's page: photos, the seller's description, details and shipping. No key needed.
Path
idstringrequired- The id.
curl https://api.resell.store/v1/market/listings/8d1e6c2a-…Response
{
"object": "public_listing",
"id": "8d1e6c2a-…",
"slug": "yellow-le-creuset-dutch-oven-5-5-qt",
"store": "maya",
"title": "Yellow Le Creuset dutch oven, 5.5 qt",
"one_liner": "The good one, barely used, ready for soup season",
"price": 185,
"shipping": 18,
"photo": "https://files.resell.store/…",
"category": "Home",
"open_to_offers": true,
"sold": false,
"just_listed": false,
"url": "https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt",
"seller": {
"name": "Maya's closet"
},
"liked": false,
"description": [
"Bought it for a recipe I made twice. No chips, no stains."
],
"details": [
{
"label": "Brand",
"value": "Le Creuset"
},
{
"label": "Condition",
"value": "Like new"
},
{
"label": "Offers",
"value": "Welcome"
}
],
"photos": [
{
"url": "https://files.resell.store/…",
"video": false
}
],
"listed": "Listed on September 28."
}Browse stores
GET
/v1/market/storesNo key needed
Every store listed on the marketplace, busiest first. No key needed.
Query
limitintegerdefault 25- How many to return, 1 to 100. Default 25.
offsetintegerdefault 0- How many to skip, for the next page.
curl https://api.resell.store/v1/market/storesResponse
{
"object": "list",
"data": [
{
"object": "store",
"slug": "maya",
"name": "Maya's closet",
"owner": "Maya",
"tagline": "Clothes and kitchen things I don't use any more",
"about": "Clothes and kitchen things I don't use any more. Ships from Portland.",
"location": "Portland, OR",
"since": "September 2026",
"for_sale": 12,
"sold": 20,
"paused": false,
"picture_url": null,
"url": "https://maya.resell.store"
}
],
"total": 1,
"has_more": false
}Look at a store
GET
/v1/market/stores/:slugNo key needed
A store, what's on its shelves and what it's sold lately. No key needed; with one, it says whether you follow it.
Path
slugstringrequired- The shop's slug.
curl https://api.resell.store/v1/market/stores/mayaResponse
{
"object": "store",
"slug": "maya",
"name": "Maya's closet",
"owner": "Maya",
"tagline": "Clothes and kitchen things I don't use any more",
"about": "Clothes and kitchen things I don't use any more. Ships from Portland.",
"location": "Portland, OR",
"since": "September 2026",
"for_sale": 12,
"sold": 20,
"paused": false,
"picture_url": null,
"url": "https://maya.resell.store",
"followers": 105,
"following": false,
"listings": [
{
"object": "public_listing",
"id": "8d1e6c2a-…",
"slug": "yellow-le-creuset-dutch-oven-5-5-qt",
"store": "maya",
"title": "Yellow Le Creuset dutch oven, 5.5 qt",
"one_liner": "The good one, barely used, ready for soup season",
"price": 185,
"shipping": 18,
"photo": "https://files.resell.store/…",
"category": "Home",
"open_to_offers": true,
"sold": false,
"just_listed": false,
"url": "https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt",
"seller": {
"name": "Maya's closet"
},
"liked": false
}
],
"recently_sold": [
{
"title": "Linen wrap dress",
"price": 24,
"when": "last week"
}
]
}