The eBay Product API returns one eBay listing. Pass an item URL on a supported site, or a numeric item id (resolved on www.ebay.com).
Piloterr uses the webunlocker. Costs 3 credits per successful call.
Any other host, including ebay.be, returns 400.
| Site |
Currency |
www.ebay.com |
USD |
www.ebay.co.uk |
GBP |
www.ebay.fr |
EUR |
www.ebay.de |
EUR |
www.ebay.it |
EUR |
www.ebay.es |
EUR |
www.ebay.at |
EUR |
www.ebay.ch |
CHF |
www.ebay.nl |
EUR |
www.ebay.pl |
PLN |
www.ebay.ie |
EUR |
www.ebay.ca |
CAD |
www.ebay.com.au |
AUD |
GET https://api.piloterr.com/v2/ebay/product?query=256684557194
GET https://api.piloterr.com/v2/ebay/product?query=https://www.ebay.de/itm/257758922911
Example (item id):
257758922911
Example (item URL):
https://www.ebay.de/itm/257758922911
query is required. Two forms work.
| Form |
Example |
What happens |
| Item URL |
https://www.ebay.de/itm/257758922911 |
Host kept when it is in the supported list. The id is read from /itm/ |
| Numeric id |
257758922911 |
At least 6 digits. The listing is loaded on www.ebay.com |
A keyword, a search URL (/sch/), or the placeholder id 123456 returns 400. Any host outside the list returns 400, including ebay.be.
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Item URL on a supported site, or a numeric item id (6 digits or more) |
return_page_source |
boolean |
no |
Raw HTML as {"result": "..."} |
| Code |
Meaning |
400 |
Empty query, or eBay host not in the supported list |
403 |
Page blocked |
404 |
Listing not parseable |
500 |
Fetch failed |