Piloterr

eBay Search

GET
/v2/ebay/search

eBay Search API: search listings on supported eBay sites. Returns price, seller, and pagination (3 credits).

Credit cost: 3 credits per call

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Keyword or eBay search URL on a supported site (ebay.com, ebay.co.uk, ebay.fr, ebay.de, ebay.it, ebay.es, ebay.at, ebay.ch, ebay.nl, ebay.pl, ebay.ie, ebay.ca, ebay.com.au). Other hosts return 400.

page?number

Page override. Sets _pgn.

return_page_source?boolean

When true, return raw HTML.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.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  }}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}