eBay Product
GET
eBay Product API: one listing on a supported eBay site, by URL or item id (3 credits).
Credit cost: 3 credits per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringItem id, or an item URL on a supported eBay site.
Example (item id):
257758922911Example (item URL):
https://www.ebay.de/itm/257758922911Notes:
- A bare id is loaded on
www.ebay.com. - A keyword or a
/schURL returns 400. ebay.beand the placeholder id123456return 400.
return_page_source?booleanWhen true, return raw HTML.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
mpn?unknownurl?stringgtin?unknownbrand?stringmodel?stringprice?numbertitle?stringimages?array<>seller?item_id?stringreturns?currency?stringshipping?watchers?integercondition?stringimage_url?stringitems_sold?unknowndescription?unknownavailability?stringis_best_offer?booleanis_buy_it_now?booleanprice_display?stringspecifications?array<>payment_methods?array<string>quantity_available?unknowncondition_description?stringcurl -X GET 'https://api.piloterr.com/v2/ebay/product?query=string'Example Response
{ "mpn": null, "url": "https://www.ebay.com/itm/336517253224", "gtin": null, "brand": "Dell", "model": "Dell Latitude 5520", "price": 399.99, "title": "Dell Latitude 5520 i5 15.6\" Touchscreen Laptop 16GB 512GB SSD Win 11 Pro", "images": [ { "url": "https://i.ebayimg.com/images/g/~n4AAeSwxEBpXWER/s-l1600.png", "position": 1 }, { "url": "https://i.ebayimg.com/images/g/RPgAAOSwLcBieqIK/s-l1600.jpg", "position": 2 }, { "url": "https://i.ebayimg.com/images/g/76UAAeSwmRFqyRth/s-l1600.png", "position": 3 } ], "seller": { "name": "AAA PCs Store", "feedback": "8442", "thumbnail": "https://i.ebayimg.com/images/g/hBUAAOSw6WZndu3y/s-l64.jpg", "positive_feedback_percent": 100 }, "item_id": "336517253224", "returns": { "summary": "30 days returns . Buyer pays for return shipping. If you use an eBay shipping label, it will be deducted from your refund amount . See details - for more information about returns", "accepts_returns": true }, "currency": "USD", "shipping": { "summary": "May not ship to France. Read item description or contact seller for shipping options. See details for shipping Located in: Fort Myers, Florida, United States", "ships_to": "Varies", "handling_time": null, "seller_location": null }, "watchers": 383, "condition": "Excellent - Refurbished", "image_url": "https://i.ebayimg.com/images/g/~n4AAeSwxEBpXWER/s-l1600.png", "items_sold": null, "description": null, "availability": "InStock", "is_best_offer": false, "is_buy_it_now": true, "price_display": "US $399.99", "specifications": [ { "name": "Processor", "value": "Intel Core i5 11th Gen." }, { "name": "Graphics Processing Type", "value": "Integrated/On-Board Graphics" }, { "name": "SSD Capacity", "value": "512 GB" }, { "name": "Most Suitable For", "value": "Casual Computing, Graphic Design, Workstation" }, { "name": "GPU", "value": "Intel Iris Xe Graphics" }, { "name": "Getting started with your laptop", "value": "Essential Setup Guide included in the box!" }, { "name": "SSD Speed", "value": "This is an NVMe SSD installed which is x4 faster than SATA 3!" }, { "name": "Release Year", "value": "Refurbished in 2026. (New: RAM/SSD/OS)" } ], "payment_methods": [ "PayPal", "Google Pay", "Visa", "Master Card", "Discover", "Diners Club", "PAYPAL_CREDIT" ], "quantity_available": null, "condition_description": "AAA PCs is a partner of a Microsoft Authorized Refurbisher. (MAR) Your computer will ship securely"}