OfferUp

Search and fetch listings from the OfferUp marketplace

Overview

Search OfferUp classifieds by keyword and ZIP code, with filters for price, condition, and category. Fetch full listing details with /details. Results are paginated using nextPageToken.

Base path: https://api.datacaiman.com/v1/offerup

Cost: 1 credit per call

GET /v1/offerup/search

Parameters

Name Type Required Description
query string Yes Search keyword (e.g. iphone)
zipCode string Yes US ZIP code to anchor the search location (e.g. 90210)
sortBy string No bestMatch, recent, closest, lowPrice, highPrice (default: bestMatch)
category string No OfferUp category ID
minPrice number No Minimum price filter
maxPrice number No Maximum price filter
conditions string No Comma-separated condition values: new, openBox, reconditioned, used, forParts, other
pageToken string No Token from previous response for pagination

Response

{
  "hasNextPage": true,
  "nextPageToken": "eyJj...",
  "items": [
    {
      "listingId": "ac5f8f61-a479-3a3b-bd0b-6dbcea95ea9d",
      "title": "iPhone 14 Pro",
      "price": 750.00,
      "location": "Los Angeles, CA",
      "url": "https://offerup.com/item/detail/..."
    }
  ]
}

Examples

Search for used iPhones near Beverly Hills:

curl "https://api.datacaiman.com/v1/offerup/search?query=iphone&zipCode=90210&conditions=used&sortBy=lowPrice" \
  -H "X-API-Key: dc_your_key_here"

Search within a price range:

curl "https://api.datacaiman.com/v1/offerup/search?query=macbook&zipCode=10001&minPrice=500&maxPrice=1500&sortBy=recent" \
  -H "X-API-Key: dc_your_key_here"

Paginate to the next page:

curl "https://api.datacaiman.com/v1/offerup/search?query=iphone&zipCode=90210&pageToken=eyJj..." \
  -H "X-API-Key: dc_your_key_here"

GET /v1/offerup/details

Fetch full details for a single listing using its ID from /search results.

Parameters

Name Type Required Description
listingId string Yes Listing ID from a /search result
zipCode string No ZIP code to resolve device coordinates for the request

Example

curl "https://api.datacaiman.com/v1/offerup/details?listingId=ac5f8f61-a479-3a3b-bd0b-6dbcea95ea9d&zipCode=90210" \
  -H "X-API-Key: dc_your_key_here"
← Flight AwardFAQ →