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
headerx-api-key<token>

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

Query Parameters

query*string

Keyword on www.ebay.com, or a search URL on a supported eBay site.

Example (keyword):

laptop

Example (search URL):

https://www.ebay.fr/sch/i.html?_nkw=ordinateur

Notes:

  • A keyword always searches www.ebay.com.
  • A URL must start with /sch. An /itm/ URL returns 400.
  • ebay.be and any other host return 400.
page?number

Page 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?boolean

When true, return raw HTML.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/ebay/search?query=string'
Example Response
{  "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  }}