eBay Search
eBay Search API: search listings on supported eBay sites. Returns price, seller, and pagination (3 credits).
Credit cost: 3 credits per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringKeyword on www.ebay.com, or a search URL on a supported eBay site.
Example (keyword):
laptopExample (search URL):
https://www.ebay.fr/sch/i.html?_nkw=ordinateurNotes:
- A keyword always searches
www.ebay.com. - A URL must start with
/sch. An/itm/URL returns 400. ebay.beand any other host return 400.
page?numberPage number, sent as _pgn. Default 1 for a keyword. On a URL, the page already in the URL is kept when this is empty. Below 1 returns 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}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/ebay/search?query=string'{ "results": [ { "url": "https://www.ebay.com/itm/336517253224", "bids": null, "price": 399.99, "title": "Dell Latitude 5520 i5 15.6\" Touchscreen Laptop 16GB 512GB SSD Win 11 Pro", "rating": null, "seller": { "name": "aaa_pcs", "feedback": "8.4K", "positive_feedback_percent": 100 }, "item_id": "336517253224", "reviews": null, "currency": "USD", "location": null, "position": 31, "shipping": "Shipping not specified", "subtitle": "Dell", "watchers": null, "condition": "Excellent - Refurbished", "image_url": "https://i.ebayimg.com/images/g/~n4AAeSwxEBpXWER/s-l140.webp", "old_price": 474.99, "price_max": null, "time_left": null, "items_sold": 299, "buying_format": "Buy It Now", "is_best_offer": false, "price_display": "$399.99", "is_free_return": false, "is_new_listing": false, "discount_percent": 16, "old_price_display": "$474.99", "items_sold_display": "299 sold" } ], "pagination": { "next": "https://www.ebay.com/sch/i.html?_nkw=laptop&_ipg=60&_pgn=2", "page": 1, "per_page": 60, "total_pages": null, "total_results": 190000 }}