resell.storedocs

API reference

Listings

Make, change, publish and take down listings.

List your listings

GET/v1/listings
Needs a key with read

Listings across your shops, most recently changed first. Filter by shop or status.

Query

shopstring
A shop slug. Leave out for every shop.
status"draft" | "live" | "sold"
limitintegerdefault 25
How many to return, 1 to 100. Default 25.
offsetintegerdefault 0
How many to skip, for the next page.
Request
curl https://api.resell.store/v1/listings?status=live&limit=2 \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "object": "list",
  "data": [
    {
      "object": "listing",
      "id": "8d1e6c2a-…",
      "shop": "maya",
      "status": "live",
      "visibility": "everyone",
      "step": "publish",
      "name": "Le Creuset dutch oven",
      "title": "Yellow Le Creuset dutch oven, 5.5 qt",
      "one_liner": "The good one, barely used, ready for soup season",
      "description": "Bought it for a recipe I made twice. No chips…",
      "category": "Kitchen",
      "price": 185,
      "lowest_price": 160,
      "shipping": 18,
      "take_offers": true,
      "fields": [
        {
          "key": "brand",
          "label": "Brand",
          "value": "Le Creuset",
          "source": "agent"
        },
        {
          "key": "condition",
          "label": "Condition",
          "value": "Like new",
          "source": "you"
        }
      ],
      "photos": [
        {
          "id": "3f…",
          "url": "https://files.resell.store/…",
          "alt": null,
          "source": null,
          "is_video": false
        }
      ],
      "url": "https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt",
      "edit_url": "https://resell.store/listings/8d1e6c2a-…",
      "stats": {
        "views": 214,
        "views_7d": 61,
        "likes": 12,
        "shares": 3,
        "offers": 2,
        "offers_waiting": 1
      },
      "research": {
        "identified": "Le Creuset Signature round dutch oven, 5.5 qt, Soleil",
        "category": "Kitchen",
        "confidence": "high",
        "suggested_price": 185,
        "price_range": {
          "low": 160,
          "high": 210
        },
        "summary": "Sells quickly between $160 and $210 in this colour."
      },
      "published_at": "2026-09-28T16:02:11.000Z",
      "sold_at": null,
      "created_at": "2026-09-28T15:40:00.000Z",
      "updated_at": "2026-09-28T16:02:11.000Z"
    }
  ],
  "total": 12,
  "has_more": true
}

Make a listing

POST/v1/listings
Needs a key with listings

Makes a draft in one of your shops. Give it what you know: a prompt ("yellow le creuset dutch oven, 5.5 qt, used twice") is enough for the research agent to work out the rest; or set the title, price and details yourself. Add research: true to look it up and suggest a price (poll GET /listings/:id/research). Add publish: true to put it live straight away, if it has a title and a price.

Body

shopstring
A shop slug. Defaults to your first shop.
promptstring
What it is, in your words. The research agent starts from this.
titlestring
Up to 80 characters. What it is first: brand, item, key detail.
one_linerstring
One line under the title, up to 120 characters.
descriptionstring
categorystring
pricenumber
The asking price in dollars.
lowest_pricenumber
The private floor the shop's agent won't go under. Never shown to buyers.
shippingnumber
Shipping in dollars. 0 means pickup only.
take_offersboolean
Whether buyers can make offers. Default true.
visibility"everyone" | "link"
everyone: in search and on the store. link: only people with the link.
fieldsobject[]
Details like brand, size and condition, as { "Label": "value" }. Merged into what's there.
photo_urlsstring[]
Public picture URLs. We download and keep a copy of each.
researchboolean
Look it up and suggest a price, in the background.
publishboolean
Put it live now. Needs a title and a price.
Request
curl https://api.resell.store/v1/listings \
  -H "Authorization: Bearer $RESELL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "shop": "maya",
    "title": "Yellow Le Creuset dutch oven, 5.5 qt",
    "price": 185,
    "lowest_price": 160,
    "fields": {
      "Brand": "Le Creuset",
      "Condition": "Like new"
    },
    "publish": true
  }'
Response
{
  "object": "listing",
  "id": "8d1e6c2a-…",
  "shop": "maya",
  "status": "live",
  "visibility": "everyone",
  "step": "publish",
  "name": "Le Creuset dutch oven",
  "title": "Yellow Le Creuset dutch oven, 5.5 qt",
  "one_liner": "The good one, barely used, ready for soup season",
  "description": "Bought it for a recipe I made twice. No chips…",
  "category": "Kitchen",
  "price": 185,
  "lowest_price": 160,
  "shipping": 18,
  "take_offers": true,
  "fields": [
    {
      "key": "brand",
      "label": "Brand",
      "value": "Le Creuset",
      "source": "agent"
    },
    {
      "key": "condition",
      "label": "Condition",
      "value": "Like new",
      "source": "you"
    }
  ],
  "photos": [
    {
      "id": "3f…",
      "url": "https://files.resell.store/…",
      "alt": null,
      "source": null,
      "is_video": false
    }
  ],
  "url": "https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt",
  "edit_url": "https://resell.store/listings/8d1e6c2a-…",
  "stats": {
    "views": 214,
    "views_7d": 61,
    "likes": 12,
    "shares": 3,
    "offers": 2,
    "offers_waiting": 1
  },
  "research": {
    "identified": "Le Creuset Signature round dutch oven, 5.5 qt, Soleil",
    "category": "Kitchen",
    "confidence": "high",
    "suggested_price": 185,
    "price_range": {
      "low": 160,
      "high": 210
    },
    "summary": "Sells quickly between $160 and $210 in this colour."
  },
  "published_at": "2026-09-28T16:02:11.000Z",
  "sold_at": null,
  "created_at": "2026-09-28T15:40:00.000Z",
  "updated_at": "2026-09-28T16:02:11.000Z"
}

Get a listing

GET/v1/listings/:id
Needs a key with read

Everything about one of your listings: its words, details, photos, research and numbers.

Path

idstringrequired
The id.
Request
curl https://api.resell.store/v1/listings/8d1e6c2a-… \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "object": "listing",
  "id": "8d1e6c2a-…",
  "shop": "maya",
  "status": "live",
  "visibility": "everyone",
  "step": "publish",
  "name": "Le Creuset dutch oven",
  "title": "Yellow Le Creuset dutch oven, 5.5 qt",
  "one_liner": "The good one, barely used, ready for soup season",
  "description": "Bought it for a recipe I made twice. No chips…",
  "category": "Kitchen",
  "price": 185,
  "lowest_price": 160,
  "shipping": 18,
  "take_offers": true,
  "fields": [
    {
      "key": "brand",
      "label": "Brand",
      "value": "Le Creuset",
      "source": "agent"
    },
    {
      "key": "condition",
      "label": "Condition",
      "value": "Like new",
      "source": "you"
    }
  ],
  "photos": [
    {
      "id": "3f…",
      "url": "https://files.resell.store/…",
      "alt": null,
      "source": null,
      "is_video": false
    }
  ],
  "url": "https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt",
  "edit_url": "https://resell.store/listings/8d1e6c2a-…",
  "stats": {
    "views": 214,
    "views_7d": 61,
    "likes": 12,
    "shares": 3,
    "offers": 2,
    "offers_waiting": 1
  },
  "research": {
    "identified": "Le Creuset Signature round dutch oven, 5.5 qt, Soleil",
    "category": "Kitchen",
    "confidence": "high",
    "suggested_price": 185,
    "price_range": {
      "low": 160,
      "high": 210
    },
    "summary": "Sells quickly between $160 and $210 in this colour."
  },
  "published_at": "2026-09-28T16:02:11.000Z",
  "sold_at": null,
  "created_at": "2026-09-28T15:40:00.000Z",
  "updated_at": "2026-09-28T16:02:11.000Z"
}

Change a listing

PATCH/v1/listings/:id
Needs a key with listings

Change the words, price, details or who can see it. Send only what changes; null clears a field. Changes to a live listing show straight away.

Path

idstringrequired
The id.

Body

titlestring
Up to 80 characters. What it is first: brand, item, key detail.
one_linerstring
One line under the title, up to 120 characters.
descriptionstring
categorystring
pricenumber
The asking price in dollars.
lowest_pricenumber
The private floor the shop's agent won't go under. Never shown to buyers.
shippingnumber
Shipping in dollars. 0 means pickup only.
take_offersboolean
Whether buyers can make offers. Default true.
visibility"everyone" | "link"
everyone: in search and on the store. link: only people with the link.
fieldsobject[]
Details like brand, size and condition, as { "Label": "value" }. Merged into what's there.
Request
curl -X PATCH https://api.resell.store/v1/listings/8d1e6c2a-… \
  -H "Authorization: Bearer $RESELL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "price": 170,
    "fields": {
      "Condition": "Very good"
    }
  }'
Response
{
  "object": "listing",
  "id": "8d1e6c2a-…",
  "shop": "maya",
  "status": "live",
  "visibility": "everyone",
  "step": "publish",
  "name": "Le Creuset dutch oven",
  "title": "Yellow Le Creuset dutch oven, 5.5 qt",
  "one_liner": "The good one, barely used, ready for soup season",
  "description": "Bought it for a recipe I made twice. No chips…",
  "category": "Kitchen",
  "price": 185,
  "lowest_price": 160,
  "shipping": 18,
  "take_offers": true,
  "fields": [
    {
      "key": "brand",
      "label": "Brand",
      "value": "Le Creuset",
      "source": "agent"
    },
    {
      "key": "condition",
      "label": "Condition",
      "value": "Like new",
      "source": "you"
    }
  ],
  "photos": [
    {
      "id": "3f…",
      "url": "https://files.resell.store/…",
      "alt": null,
      "source": null,
      "is_video": false
    }
  ],
  "url": "https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt",
  "edit_url": "https://resell.store/listings/8d1e6c2a-…",
  "stats": {
    "views": 214,
    "views_7d": 61,
    "likes": 12,
    "shares": 3,
    "offers": 2,
    "offers_waiting": 1
  },
  "research": {
    "identified": "Le Creuset Signature round dutch oven, 5.5 qt, Soleil",
    "category": "Kitchen",
    "confidence": "high",
    "suggested_price": 185,
    "price_range": {
      "low": 160,
      "high": 210
    },
    "summary": "Sells quickly between $160 and $210 in this colour."
  },
  "published_at": "2026-09-28T16:02:11.000Z",
  "sold_at": null,
  "created_at": "2026-09-28T15:40:00.000Z",
  "updated_at": "2026-09-28T16:02:11.000Z"
}

Delete a listing

DELETE/v1/listings/:id
Needs a key with listings

Deletes a listing and its photos. Listings that have sold stay on record and can't be deleted.

Path

idstringrequired
The id.
Request
curl -X DELETE https://api.resell.store/v1/listings/8d1e6c2a-… \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "object": "listing",
  "id": "8d1e6c2a-…",
  "deleted": true
}

Put a listing live

POST/v1/listings/:id/publish
Needs a key with listings

Publishes it on your store, at a link made from the title. With visibility: "link" it stays out of search and the store page. Needs a title and a price.

Path

idstringrequired
The id.

Body

visibility"everyone" | "link"
Request
curl https://api.resell.store/v1/listings/8d1e6c2a-…/publish \
  -H "Authorization: Bearer $RESELL_KEY" \
  -d visibility=everyone
Response
{
  "object": "listing",
  "id": "8d1e6c2a-…",
  "shop": "maya",
  "status": "live",
  "visibility": "everyone",
  "step": "publish",
  "name": "Le Creuset dutch oven",
  "title": "Yellow Le Creuset dutch oven, 5.5 qt",
  "one_liner": "The good one, barely used, ready for soup season",
  "description": "Bought it for a recipe I made twice. No chips…",
  "category": "Kitchen",
  "price": 185,
  "lowest_price": 160,
  "shipping": 18,
  "take_offers": true,
  "fields": [
    {
      "key": "brand",
      "label": "Brand",
      "value": "Le Creuset",
      "source": "agent"
    },
    {
      "key": "condition",
      "label": "Condition",
      "value": "Like new",
      "source": "you"
    }
  ],
  "photos": [
    {
      "id": "3f…",
      "url": "https://files.resell.store/…",
      "alt": null,
      "source": null,
      "is_video": false
    }
  ],
  "url": "https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt",
  "edit_url": "https://resell.store/listings/8d1e6c2a-…",
  "stats": {
    "views": 214,
    "views_7d": 61,
    "likes": 12,
    "shares": 3,
    "offers": 2,
    "offers_waiting": 1
  },
  "research": {
    "identified": "Le Creuset Signature round dutch oven, 5.5 qt, Soleil",
    "category": "Kitchen",
    "confidence": "high",
    "suggested_price": 185,
    "price_range": {
      "low": 160,
      "high": 210
    },
    "summary": "Sells quickly between $160 and $210 in this colour."
  },
  "published_at": "2026-09-28T16:02:11.000Z",
  "sold_at": null,
  "created_at": "2026-09-28T15:40:00.000Z",
  "updated_at": "2026-09-28T16:02:11.000Z"
}

Take a listing down

POST/v1/listings/:id/unpublish
Needs a key with listings

Back to a draft. It keeps its link for when it goes back up.

Path

idstringrequired
The id.
Request
curl -X POST https://api.resell.store/v1/listings/8d1e6c2a-…/unpublish \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "object": "listing",
  "id": "8d1e6c2a-…",
  "shop": "maya",
  "status": "draft",
  "visibility": "everyone",
  "step": "publish",
  "name": "Le Creuset dutch oven",
  "title": "Yellow Le Creuset dutch oven, 5.5 qt",
  "one_liner": "The good one, barely used, ready for soup season",
  "description": "Bought it for a recipe I made twice. No chips…",
  "category": "Kitchen",
  "price": 185,
  "lowest_price": 160,
  "shipping": 18,
  "take_offers": true,
  "fields": [
    {
      "key": "brand",
      "label": "Brand",
      "value": "Le Creuset",
      "source": "agent"
    },
    {
      "key": "condition",
      "label": "Condition",
      "value": "Like new",
      "source": "you"
    }
  ],
  "photos": [
    {
      "id": "3f…",
      "url": "https://files.resell.store/…",
      "alt": null,
      "source": null,
      "is_video": false
    }
  ],
  "url": "https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt",
  "edit_url": "https://resell.store/listings/8d1e6c2a-…",
  "stats": {
    "views": 214,
    "views_7d": 61,
    "likes": 12,
    "shares": 3,
    "offers": 2,
    "offers_waiting": 1
  },
  "research": {
    "identified": "Le Creuset Signature round dutch oven, 5.5 qt, Soleil",
    "category": "Kitchen",
    "confidence": "high",
    "suggested_price": 185,
    "price_range": {
      "low": 160,
      "high": 210
    },
    "summary": "Sells quickly between $160 and $210 in this colour."
  },
  "published_at": null,
  "sold_at": null,
  "created_at": "2026-09-28T15:40:00.000Z",
  "updated_at": "2026-09-28T16:02:11.000Z"
}

Mark sold elsewhere

POST/v1/listings/:id/mark-sold
Needs a key with listings

For something that sold somewhere else. Sales through resell.store mark themselves sold.

Path

idstringrequired
The id.
Request
curl -X POST https://api.resell.store/v1/listings/8d1e6c2a-…/mark-sold \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "object": "listing",
  "id": "8d1e6c2a-…",
  "shop": "maya",
  "status": "sold",
  "visibility": "everyone",
  "step": "publish",
  "name": "Le Creuset dutch oven",
  "title": "Yellow Le Creuset dutch oven, 5.5 qt",
  "one_liner": "The good one, barely used, ready for soup season",
  "description": "Bought it for a recipe I made twice. No chips…",
  "category": "Kitchen",
  "price": 185,
  "lowest_price": 160,
  "shipping": 18,
  "take_offers": true,
  "fields": [
    {
      "key": "brand",
      "label": "Brand",
      "value": "Le Creuset",
      "source": "agent"
    },
    {
      "key": "condition",
      "label": "Condition",
      "value": "Like new",
      "source": "you"
    }
  ],
  "photos": [
    {
      "id": "3f…",
      "url": "https://files.resell.store/…",
      "alt": null,
      "source": null,
      "is_video": false
    }
  ],
  "url": "https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt",
  "edit_url": "https://resell.store/listings/8d1e6c2a-…",
  "stats": {
    "views": 214,
    "views_7d": 61,
    "likes": 12,
    "shares": 3,
    "offers": 2,
    "offers_waiting": 1
  },
  "research": {
    "identified": "Le Creuset Signature round dutch oven, 5.5 qt, Soleil",
    "category": "Kitchen",
    "confidence": "high",
    "suggested_price": 185,
    "price_range": {
      "low": 160,
      "high": 210
    },
    "summary": "Sells quickly between $160 and $210 in this colour."
  },
  "published_at": "2026-09-28T16:02:11.000Z",
  "sold_at": null,
  "created_at": "2026-09-28T15:40:00.000Z",
  "updated_at": "2026-09-28T16:02:11.000Z"
}

Relist

POST/v1/listings/:id/relist
Needs a key with listings

Puts a sold listing (or a draft) back up, at the same link.

Path

idstringrequired
The id.
Request
curl -X POST https://api.resell.store/v1/listings/8d1e6c2a-…/relist \
  -H "Authorization: Bearer $RESELL_KEY"
Response
{
  "object": "listing",
  "id": "8d1e6c2a-…",
  "shop": "maya",
  "status": "live",
  "visibility": "everyone",
  "step": "publish",
  "name": "Le Creuset dutch oven",
  "title": "Yellow Le Creuset dutch oven, 5.5 qt",
  "one_liner": "The good one, barely used, ready for soup season",
  "description": "Bought it for a recipe I made twice. No chips…",
  "category": "Kitchen",
  "price": 185,
  "lowest_price": 160,
  "shipping": 18,
  "take_offers": true,
  "fields": [
    {
      "key": "brand",
      "label": "Brand",
      "value": "Le Creuset",
      "source": "agent"
    },
    {
      "key": "condition",
      "label": "Condition",
      "value": "Like new",
      "source": "you"
    }
  ],
  "photos": [
    {
      "id": "3f…",
      "url": "https://files.resell.store/…",
      "alt": null,
      "source": null,
      "is_video": false
    }
  ],
  "url": "https://maya.resell.store/yellow-le-creuset-dutch-oven-5-5-qt",
  "edit_url": "https://resell.store/listings/8d1e6c2a-…",
  "stats": {
    "views": 214,
    "views_7d": 61,
    "likes": 12,
    "shares": 3,
    "offers": 2,
    "offers_waiting": 1
  },
  "research": {
    "identified": "Le Creuset Signature round dutch oven, 5.5 qt, Soleil",
    "category": "Kitchen",
    "confidence": "high",
    "suggested_price": 185,
    "price_range": {
      "low": 160,
      "high": 210
    },
    "summary": "Sells quickly between $160 and $210 in this colour."
  },
  "published_at": "2026-09-28T16:02:11.000Z",
  "sold_at": null,
  "created_at": "2026-09-28T15:40:00.000Z",
  "updated_at": "2026-09-28T16:02:11.000Z"
}