Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$3.5 / 1k listings Get confirmed eBay sold prices and detailed listing data by keyword across 8 marketplaces

Endpoint

POST /api/v1/agents/ebay/sold-listings/run

Parameters

keywords
array
required
List · eBay search keywords. Each runs as a separate search with the same filters. One per line.
maxResults
integer
default:100
Number · Listings per keyword. Use 0 for all.
daysBack
integer
default:30
Number · How far back to search sold listings.
ebaySite
string
default:"ebay.com"
Dropdown · eBay site to scrape from.
ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.ca, ebay.com.auLegend: ebay.com = eBay.com (US), ebay.co.uk = eBay.co.uk (UK), ebay.de = eBay.de (Germany), ebay.fr = eBay.fr (France), ebay.it = eBay.it (Italy), ebay.es = eBay.es (Spain), ebay.ca = eBay.ca (Canada), ebay.com.au = eBay.com.au (Australia)View all 8 as a structured list →
categoryId
string
default:"0"
Dropdown · Filter to one eBay category.View all 35 options →
subcategoryId
string
default:""
Dropdown · Filter to a specific subcategory (overrides Category if set).View all 1343 options →
itemCondition
string
default:"any"
Dropdown · Filter by item condition.Options: any, new, usedLegend: any = Any, new = New, used = Used
itemLocation
string
default:"default"
Dropdown · Filter by item location.Options: default, domestic, worldwideLegend: default = Default, domestic = Domestic only, worldwide = Worldwide
sortOrder
string
default:"endedRecently"
Dropdown · Sort order for results.Options: endedRecently, timeNewlyListed, pricePlusPostageLowest, pricePlusPostageHighest, distanceNearestLegend: endedRecently = Ended recently, timeNewlyListed = Time: newly listed, pricePlusPostageLowest = Price + postage: lowest first, pricePlusPostageHighest = Price + postage: highest first, distanceNearest = Distance: nearest first
minPrice
number
Number · Minimum sold price.
maxPrice
number
Number · Maximum sold price.
currencyMode
string
default:"USD"
Dropdown · How to display prices.Options: USD, localizedLegend: USD = Convert all to USD, localized = Keep marketplace currency

Response columns

FieldDisplay nameType
searchKeywordSearch Keywordtext
listingUrlListing URLurl
titleTitletext
soldPriceSold Pricecurrency
currencyCurrencytext
soldDateSold Datetext
categoryCategorytext
sellerSellertext
sellerFeedbackScoreSeller Feedback Scorenumber
sellerPositiveSeller Positive %percentage

Example

curl -X POST https://api.mindcase.co/api/v1/agents/ebay/sold-listings/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "keywords": [
      "iPhone 17 Pro Max"
    ],
    "maxResults": 10
  }
}'

Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "searchKeyword": "iPhone 17 Pro Max",
      "listingUrl": "https://www.ebay.com/itm/389835550348?_skw=iPhone+17+Pro+Max&itmmeta=01KQKN15Q5BS2XD6M4GWDSY6WS&hash=item5ac4026e8c:g:4-EAAeSw5yJpzlqZ&itmprp=enc%3AAQALAAAA0GfYFPkwiKCW4ZNSs2u11xC6xNYFG04ZQM4Ws4c2eXYI%2BFfbBK5LNJPHgSBtJS84C8OTFWT92x0dqxX65UKTRBRTmxBX2CBEOLAyuw3sNxDupFZjVZuJZBXws38K5xW%2B89edtM7pSJeptHdVnTdcUmbEWm9gkbKPta22Zso7hN68Jce3tGZ8ycHeoR3CEjpW%2B9A8hq7y1H3foRbsMgSTxjyou7BIX7C4boiCn6ydhbbMoo30lRrFbjV66wnTsc8GShk5UtGvhtZ7ig8OUzfuPZw%3D%7Ctkp%3ABk9SR4TchPW8Zw",
      "title": "3-Pack Screen and Camera Lens Protector for iPhone 17 Pro Max - 6.9\" Size",
      "soldPrice": "13.68",
      "currency": "USD",
      "soldDate": "2026-04-10T00:00:00.000Z",
      "category": "All Categories",
      "seller": "mindverge",
      "sellerFeedbackScore": 295,
      "sellerPositive": 99.7
    }
  ]
}