> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# eBay Sold Listings

> Get confirmed eBay sold prices and detailed listing data by keyword across 8 marketplaces

`$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

<ParamField body="keywords" type="array" required>
  **List** · eBay search keywords. Each runs as a separate search with the same filters. One per line.
</ParamField>

<ParamField body="maxResults" type="integer" default={100}>
  **Number** · Listings per keyword. Use 0 for all.
</ParamField>

<ParamField body="daysBack" type="integer" default={30}>
  **Number** · How far back to search sold listings.
</ParamField>

<ParamField body="ebaySite" type="string" default="ebay.com">
  **Dropdown** · eBay site to scrape from.

  <Accordion title="Show all 8 options">
    `ebay.com`, `ebay.co.uk`, `ebay.de`, `ebay.fr`, `ebay.it`, `ebay.es`, `ebay.ca`, `ebay.com.au`

    *Legend: `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 →](/agents/ebay/sold-listings/values#ebaysite)
  </Accordion>
</ParamField>

<ParamField body="categoryId" type="string" default="0">
  **Dropdown** · Filter to one eBay category.

  [View all 35 options →](/agents/ebay/sold-listings/values#categoryid)
</ParamField>

<ParamField body="subcategoryId" type="string" default="">
  **Dropdown** · Filter to a specific subcategory (overrides Category if set).

  [View all 1343 options →](/agents/ebay/sold-listings/values#subcategoryid)
</ParamField>

<ParamField body="itemCondition" type="string" default="any">
  **Dropdown** · Filter by item condition.

  **Options:** `any`, `new`, `used`

  *Legend: `any` = Any, `new` = New, `used` = Used*
</ParamField>

<ParamField body="itemLocation" type="string" default="default">
  **Dropdown** · Filter by item location.

  **Options:** `default`, `domestic`, `worldwide`

  *Legend: `default` = Default, `domestic` = Domestic only, `worldwide` = Worldwide*
</ParamField>

<ParamField body="sortOrder" type="string" default="endedRecently">
  **Dropdown** · Sort order for results.

  **Options:** `endedRecently`, `timeNewlyListed`, `pricePlusPostageLowest`, `pricePlusPostageHighest`, `distanceNearest`

  *Legend: `endedRecently` = Ended recently, `timeNewlyListed` = Time: newly listed, `pricePlusPostageLowest` = Price + postage: lowest first, `pricePlusPostageHighest` = Price + postage: highest first, `distanceNearest` = Distance: nearest first*
</ParamField>

<ParamField body="minPrice" type="number">
  **Number** · Minimum sold price.
</ParamField>

<ParamField body="maxPrice" type="number">
  **Number** · Maximum sold price.
</ParamField>

<ParamField body="currencyMode" type="string" default="USD">
  **Dropdown** · How to display prices.

  **Options:** `USD`, `localized`

  *Legend: `USD` = Convert all to USD, `localized` = Keep marketplace currency*
</ParamField>

## Response columns

| Field                 | Display name          | Type       |
| --------------------- | --------------------- | ---------- |
| `searchKeyword`       | Search Keyword        | text       |
| `listingUrl`          | Listing URL           | url        |
| `title`               | Title                 | text       |
| `soldPrice`           | Sold Price            | currency   |
| `currency`            | Currency              | text       |
| `soldDate`            | Sold Date             | text       |
| `category`            | Category              | text       |
| `seller`              | Seller                | text       |
| `sellerFeedbackScore` | Seller Feedback Score | number     |
| `sellerPositive`      | Seller Positive %     | percentage |

## Example

<CodeGroup>
  ```bash curl theme={null}
  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
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/ebay/sold-listings/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "keywords": [
          "iPhone 17 Pro Max"
      ],
      "maxResults": 10
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "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
    }
  ]
}
```