eBay listings scraper API · Lovely Router

Price

$0.00375 / listing

Results per run

20 default · up to 60

Billing

Only results delivered are billed. Failed runs pay no call fee.

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.

Use the Lovely Router data tool "Search eBay listings" (id `ebay-listings`, eBay) to get data for me. It returns JSON.

- Docs (read first): https://lovelyrouter.com/docs/tools/run.md and https://lovelyrouter.com/docs/api/tools.md
- Input fields and price: GET https://lovelyrouter.com/v1/tools/ebay-listings (public, no key needed). Price: $0.00375 / listing.
- Run: POST https://lovelyrouter.com/v1/tools/ebay-listings/run with a body like `{"input":{"keywords":["mechanical keyboard"],"ebaySite":"www.ebay.com"},"max_results":10}`. 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 (up to 60 per run).
- If you support MCP, you can instead connect the server https://lovelyrouter.com/mcp (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool with tool "ebay-listings".
- 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: <describe the data you need, e.g. which places, profiles, keywords or URLs, and the output format>

Input

keywordsarray

Search terms — one per line. Each runs as a separate eBay search using the filters below. You can also enter an item number, or use eBay syntax like an "exact phrase" in quotes.

ebaySitestring

Which eBay country site to run the search on. This changes the marketplace itself — currency, language, and which listings appear (e.g. eBay Germany shows German listings in EUR). Only affects the advanced search above; pasted URLs in Option 2 keep their own site. Note: on non-English sites, a few text fields (item location, shipping, sold, watchers) may occasionally be empty.

www.ebay.com · www.ebay.co.uk · www.ebay.de · www.ebay.fr · www.ebay.it · www.ebay.es · www.ebay.ca · www.ebay.com.au

minPriceinteger

Lowest price to include, in the currency of the marketplace set by 'eBay site' above (e.g. USD on ebay.com, EUR on ebay.de).

maxPriceinteger

Highest price to include, in the currency of the marketplace set by 'eBay site' above (e.g. USD on ebay.com, EUR on ebay.de).

conditionstring

Item condition, matching eBay's advanced search. 'New' and 'Used' are broad and work across all categories.

· 1000 · 3000 · 10

Try it

Input (JSON)

Max results

Costs at most $0.0375

Call it from code

How runs, polling and billing work →

curl https://lovelyrouter.com/v1/tools/ebay-listings/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"input":{"keywords":["mechanical keyboard"],"ebaySite":"www.ebay.com"},"max_results":20}'

# MCP (agents): suggest_tools → get_tool → run_tool
run_tool({
  "tool": "ebay-listings",
  "input": {"keywords":["mechanical keyboard"],"ebaySite":"www.ebay.com"},
  "max_results": 20
})

What it costs

Results	Runs (at 60 per run)	Cost
100	2	$0.375
1,000	17	$3.75
10,000	167	$37.50

Prepaid, no subscription. Fewer results than requested cost less. Pricing

Used for

E-commerce intelligence Monitor competitor prices and seller offers on eBay by keyword Value used items and set resale prices from eBay sold comps Check used and resale prices on Facebook Marketplace

Frequently asked questions

How much does the Search eBay listings API cost?

$0.00375 / listing. 1,000 results, fetched in runs of up to 60, cost $3.75. There is no subscription: you pay from a prepaid balance.

Is this an eBay scraper?

Yes. If you searched for an eBay scraper, an eBay listings API or an eBay price scraper, this is it: eBay listings for keywords (first results page): price, condition, seller, shipping.

How many results does one run return?

20 by default and up to 60 per run. Set max_results to cap a run: you are billed only for the results it delivers.

Do I need a eBay account or API key?

No. You call the tool with your Lovely Router API key and get JSON back. There is nothing to set up on eBay.

Can an AI agent use this tool?

Yes. Connect Claude Code, Cursor or any MCP client to the Lovely Router MCP server: the agent finds the tool with suggest_tools and runs it with run_tool and the id ebay-listings.

What happens if a run fails?

A run that fails or is stopped pays only for the results it delivered, with no call fee. The most a run can cost is held when it starts and the rest is released when it settles.