eBay Store Items API
List or search the items in one eBay store, page by page.
- 1 credit per call
- Failed calls are free
- Updated
- ebay.store.items.list
{ "has_more": true, "next_page": 2, "listings": [ { "title": "Bluefin 32\" Touchscreen BrightSign XT1144-PP Built-In Display Very Good", "price": "$164.99", "location": "United States", "condition": "Very Good - Refurbished", "item_id": "198561319388", "promoted": false, "rank": 0, "seller_name": "sunnking", "sold": false, "url": "https://www.ebay.com/itm/198561319388" }, { "title": "Bluefin 32\" Touchscreen BrightSign XT1144-PP Built-In Display", "price": "$149.99", "location": "United States", "condition": "Pre-Owned", "item_id": "198608660898", "promoted": false, "rank": 1, "seller_name": "sunnking", "sold": false, "url": "https://www.ebay.com/itm/198608660898" } ]}
| # | Title | Price | Condition | Location | Item ID | Promoted | Rank | Seller name | Sold | Url |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | Bluefin 32" Touchscreen BrightSign XT1144-PP Built-In Display V… | $164.99 | Very Good - Refurbished | United States | 198561319388 | false | 0 | sunnking | false | https://www.ebay.com/itm/198561319388 |
| 2 | Bluefin 32" Touchscreen BrightSign XT1144-PP Built-In Display | $149.99 | Pre-Owned | United States | 198608660898 | false | 1 | sunnking | false | https://www.ebay.com/itm/198608660898 |
| 3 | Ripple Zero Nicotine Mint 4-Pack Diffusers Minty Flavor | $24.99 | Brand New | United States | 366598852640 | false | 2 | sunnking | false | https://www.ebay.com/itm/366598852640 |
| 4 | Hitachi / HGST Travelstar HTS541010B7E610 1TB 2.5" SATA III HDD | $29.99 | Excellent - Refurbished | United States | 366685706640 | false | 3 | sunnking | false | https://www.ebay.com/itm/366685706640 |
| 5 | Intel Xeon W-2255 SRGV8 3.7GHz 10-Core LGA2066 Server CPU Proce… | $249.99 | Pre-Owned | United States | 206337321458 | false | 4 | sunnking | false | https://www.ebay.com/itm/206337321458 |
| 6 | Full Motion Articulating Gas Spring TV Wall Mount 23-55 inch 66… | $23.99 | Brand New | United States | 366206152658 | false | 5 | sunnking | false | https://www.ebay.com/itm/366206152658 |
| 7 | Intel Core i3-8300 SR3XY 3.7GHz 4-Core LGA 1151 CPU Processor | $16.99 | Excellent - Refurbished | United States | 366487971413 | false | 6 | sunnking | false | https://www.ebay.com/itm/366487971413 |
| 8 | TP-Link TL-SG105 5-Port Gigabit Ethernet Unmanaged Metal Deskto… | $19.99 | Brand New | United States | 198561532762 | false | 7 | sunnking | false | https://www.ebay.com/itm/198561532762 |
| 9 | Cisco Catalyst WS-C2960+24TC-S 24-Port Gigabit Managed SFP Swit… | $39.99 | Pre-Owned | United States | 206516962626 | false | 8 | sunnking | false | https://www.ebay.com/itm/206516962626 |
| 10 | Hisense 40" 1080p 60Hz FHD LED Roku Smart TV 40H4030F4 | $129.99 | Pre-Owned | United States | 206316851344 | false | 9 | sunnking | false | https://www.ebay.com/itm/206316851344 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| store | string | yes | The store's name from its eBay store URL (ebay.com/str/<store>). | sunnking |
| limit | integer | no | Items per page: 60, 120 or 240. | 60 |
| page | integer | no | Which page of the store to return, starting at 1. | 1 |
| query | string | no | Only the store's items matching these words. |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| listings[].title | string | The listing title as the seller wrote it. | Bluefin 32" Touchscreen BrightSign XT1144-PP Built-In Display V… |
| listings[].price | string | The price as eBay shows it, with its currency sign. | $164.99 |
| listings[].condition | string | The item's condition as the seller lists it. | Very Good - Refurbished |
| listings[].location | string | Where the item ships from. | United States |
| listings[].item_id | string | eBay's ID for the listing. | 198561319388 |
| listings[].promoted | boolean | Whether the listing is a paid placement. | false |
| listings[].rank | integer | The listing's place in the results, starting at 0. | 0 |
| listings[].seller_name | string | The seller's eBay name. | sunnking |
| listings[].sold | boolean | Whether the listing has sold. | false |
| listings[].url | string | The page on eBay. | https://www.ebay.com/itm/198561319388 |
| has_more | boolean | Whether another page follows. | true |
| listings | array | The listings. | 60 records |
| next_page | integer | Send it as page to get the next page. | 2 |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "ebay.store.items.list", "input": { "limit": 60, "page": 1, "store": "sunnking" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "ebay.store.items.list", "input": { "limit": 60, "page": 1, "store": "sunnking" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "ebay.store.items.list", "input": { "limit": 60, "page": 1, "store": "sunnking" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
Using Upscrape, list the items in the eBay store sunnking and group them by condition, with the price range of each group.
More from the eBay API
- eBay Listings Search API1 credit
- eBay Item API1 credit
- eBay Deals API1 credit
- eBay Store API1 credit
- eBay Seller Feedback API1 credit
- eBay Product Reviews API1 credit
- eBay Ranking Search API1 credit
- eBay Promotions Search API1 credit
- eBay Item Recommendations API1 credit
- eBay Additional Item Recommendations API1 credit
- eBay Categories API1 credit
The same data from other platforms
eBay Store Items API FAQ
The short answers. The docs have the long ones.
How much does the eBay Store Items API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send store. The input fields below list every option with its type and limits.
Do I need an eBay login?
No. It reads public eBay data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds ebay.store.items.list, checks its price and runs it with the same credits as the REST API.
Your first eBay call is free.
Up to 100 free credits to start, no card needed.