Use case

Value used items and set resale prices from eBay sold comps

Get what items actually sold for on eBay as JSON with sold price, shipping, condition and end date, to value inventory and set resale prices.

Prepaid, no subscriptionREST or MCPOne key for models, data and agents
eBaylovelyjsonitems[0]"title": "NVIDIA GeForce RTX 40…"sold_price": "689.00""shipping": "Free""condition": "Pre-owned""ended": "2026-10-23"

Asking prices are wishes. If you resell electronics, flip estate finds or insure a collection, you need what buyers actually paid in the last few weeks. eBay keeps that as sold listings, one search at a time. Lovely Router reads them for you. Send keywords, get one JSON object per sold listing, pay per listing from a prepaid balance. Run it from a script, a spreadsheet job or an AI agent with one API key.

Hand it to your AI agent

Copy this prompt into Claude Code, Cursor, Codex or any coding agent. It tells the agent where the docs are and how to use your API key.

Value used items and set resale prices from eBay sold comps. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the inputs (links, keywords or accounts) and how many results you need>
01

How it works

010203
  1. List what you want to value

    A keyword per item: model numbers work best. Add itemCondition to match your stock, and a price range if the search is noisy.

  2. Run the tool with a cap

    Send them to POST /v1/tools/ebay-sold/run with count for the number of sold listings, daysToScrape for how far back to look, and max_results as the run cap. The run holds its maximum cost from your balance and returns the sales as JSON.

  3. Take the median

    Drop outliers such as parts-only sales, then use the median sold price (plus shipping, if you ship) as the comp. Save it with a date.

02

Get sold prices with one request

eBay sold listings takes search terms in keywords, each a separate search with the same filters. ebaySite picks the country site, daysToScrape the look-back (default 30), itemCondition is any, new or used, and count is the number of listings:

curl https://lovelyrouter.com/v1/tools/ebay-sold/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "keywords": ["rtx 4080"],
      "count": 3
    },
    "max_results": 3
  }'

A run still going after 60 seconds returns 202; Run a tool shows how to poll. One run can return up to 500 sold listings.

03

What each sold listing holds

Field groupWhat you get
PriceThe price it sold for
ShippingThe shipping charge
ConditionNew, used or as listed
TimingThe end date of the sale
04

Recipes

Value inventory

Run every model in your stock with itemCondition set to used, take the median sold price over 30 days, and write it next to your list price.

Decide what to buy

Before a bulk purchase, compare the asking price of the lot with the median sold price of each item in it.

Track a price trend

Run the same keyword with daysToScrape set to 30 each week, store the median, and see whether a product's resale price is falling.

Insure or appraise

Build a dated table of comparable sales for a collection, as backup for a value claim.

Compare countries

Run the same keyword on ebay.co.uk and ebay.com and compare medians before you ship stock abroad.

Prefer plain words? Connect the MCP server and tell Claude Code or Cursor: "For the models in gpus.txt, get 30 used sold listings each from eBay, and give me the median sold price and the number of sales for each. Set max_results to the total."

06

What you pay

You pay per listing: starting a run holds its maximum cost, the per-call fee plus the per-listing fee times max_results, and the run settles to what it returned. The rest of the hold goes back to your balance. A run that fails or times out pays only for the listings it delivered, and a run refused at the start costs nothing.

Valuing 100 items at 20 sales each is billed as 2,000 listings. There is no subscription and no monthly minimum: top up from $5, and one balance pays for tools and models. The card above shows today's price; pricing lists every tool.

07

Frequently asked questions

?
How far back do the sold listings go?+

You set it with daysToScrape. The default is 30 days.

Which eBay sites can I use?+

ebaySite accepts ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.ca and ebay.com.au.

Can I filter by condition or price?+

Yes. itemCondition takes any, new or used, and minPrice and maxPrice filter by sold price. sortOrder changes the order of the results page.

Is the shipping part of the price?+

The tool returns the sold price and the shipping separately, so you can add them yourself.

How many sold listings can I get?+

count sets the number per run, and the run cap max_results goes up to 500.

Do I need a subscription?+

No. You add credit to a prepaid balance and each run draws it down. Failed runs pay only for the results they delivered, and nothing renews automatically.

Pricing a catalog? See e-commerce intelligence, research agents and the tool catalog.

One prepaid key for models, data and agents

No subscription. Top up, use what you need, see every charge in your logs.