OfferUp

Search OfferUp listings

get/offerup/search

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/offerup/search
  • Auth: API key in header X-API-KEY

Query parameters

qstring nullable

Keyword search, e.g. "iphone".

cidstring nullable

Category id from the categories endpoint, e.g. "5.1". Use this for keyword-free category browsing.

category_idstring nullable

Category filter. Requires q; without a keyword OfferUp drops it silently. Cannot be combined with cid.

zipcodestring nullable

5-digit US zip code to search around. Required unless lat and lon are given.

latnumber nullable

Latitude. Must be sent together with lon.

lonnumber nullable

Longitude. Must be sent together with lat.

radius'5' | '10' | '20' | '30' | '50' | 'null' nullable

Search radius in miles around the location. OfferUp only honours 5, 10, 20, 30 or 50; any other value is snapped to a different distance behind a 200, so it is rejected.

price_minnumber nullable

Minimum price in USD.

price_maxnumber nullable

Maximum price in USD.

condition'NEW' | 'OPEN_BOX' | 'REFURBISHED' | 'USED' | 'BROKEN' | 'OTHER' | 'null' nullable

Condition filter: NEW, OPEN_BOX, REFURBISHED, USED, BROKEN, OTHER.

sort'best_match' | '-posted' | 'distance' | 'price' | '-price' | 'null' nullable

Sort order: best_match, -posted, distance, price, -price.

page_cursorstring nullable

Opaque cursor from a previous page. Never construct this yourself.

search_session_idstring nullable

Session id from a previous page. Keep it stable across a paginated sweep.

Response

string required

Changes

No recorded changes to this operation across all 3 revisions of this API.