Scrape eBay search listings

curl --request POST \
  --url https://api.scrapeunblocker.com/marketplace/ebay-search \
  --header 'x-scrapeunblocker-key: <api-key>'

import requests

url = "https://api.scrapeunblocker.com/marketplace/ebay-search"

headers = {"x-scrapeunblocker-key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {'x-scrapeunblocker-key': '<api-key>'}};

fetch('https://api.scrapeunblocker.com/marketplace/ebay-search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Plugins

Scrape eBay search listings

Searches any regional eBay marketplace for keyword and returns the listings as JSON: title, price + currency, condition (with a normalised conditionCode), seller (username, feedback percentage and score), shippingCost, sold, watchers, bids, image and a clean item url. Filter with condition, listing_type, min_price/max_price, free_shipping, seller or category, sort with sort, and page with page/page_size (60, 120 or 240 per page). Set marketplace to search a specific site - prices, currency and availability differ between ebay.com, ebay.de, ebay.co.uk and the rest.

When eBay finds no exact match it still serves a full page of its own loosely-related suggestions. That case is reported honestly: exactMatches is false and a notice explains it, so those listings are never mistaken for real matches.

curl --request POST \
  --url https://api.scrapeunblocker.com/marketplace/ebay-search \
  --header 'x-scrapeunblocker-key: <api-key>'

import requests

url = "https://api.scrapeunblocker.com/marketplace/ebay-search"

headers = {"x-scrapeunblocker-key": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {'x-scrapeunblocker-key': '<api-key>'}};

fetch('https://api.scrapeunblocker.com/marketplace/ebay-search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

x-scrapeunblocker-key

string

header

required

Your ScrapeUnblocker API key. Apply on every request.

Query Parameters

keyword

string

required

Search phrase, e.g. 'iphone 13' or a part number like '1K0953519A'.

marketplace

string

default:ebay.com

Regional eBay site to search. Prices, currency and availability differ per marketplace. One of: ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.nl, ebay.pl, ebay.at, ebay.ch, ebay.be, ebay.ie, ebay.ca, ebay.com.au, ebay.in, ebay.ph, ebay.com.sg, ebay.com.my, ebay.com.hk.

page

integer

default:1

1-based page number.

Required range: x >= 1

page_size

integer

default:60

Listings per page - eBay's own page sizes: 60, 120, 240.

condition

string | null

Item condition filter: new, open_box, refurbished, used, for_parts. Omit for every condition.

sort

string

default:best_match

Ordering: best_match, newly_listed, ending_soon, price_asc, price_desc. Default 'best_match'.

listing_type

string

default:all

Listing format: all, buy_it_now, auction. Default 'all'.

min_price

number | null

Lowest price to include, in the marketplace's currency.

Required range: x >= 0

max_price

number | null

Highest price to include, in the marketplace's currency.

Required range: x >= 0

free_shipping

boolean

default:false

Only listings eBay marks as free delivery.

seller

string | null

Restrict the search to one seller's username.

Response

JSON with a results array of listings. A search that genuinely matches nothing returns 200 with an empty array, and eBay's relaxed suggestions are flagged with exactMatches: false.

Scrape oopbuy.com product-search listings

Overview

Scraping

Scrape eBay search listings

Authorizations

Query Parameters

Response