# eBay Search API (ebay.search)

- Canonical page: https://everyinfra.com/en/ebay-api/search
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "ebay", "action": "search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 50 per call
- Mode: sync; add "mode": "async" for slow tasks

eBay Search finds items for sale on eBay by `keyword` and returns each listing's item ID, title, link, price and the price text as shown, currency, condition, shipping terms, seller and image. Resellers, pricing analysts and collectors use it to check current asking prices for an item, spot listings priced below the market and compare sellers.

Condition drives eBay prices more than anything else, so filter with `condition` or group by it before you compare. `price` is a number, while `price_text` keeps the displayed text, which can be a range. The price filters bound the item price alone; shipping and taxes may come on top, so read `shipping`. These are asking prices, not sale prices: set `sold_only` to true for sold items. Auction prices move quickly, so judge how fresh one is from `scraped_at`, the time the row was read. Pick the eBay site with `domain`, such as ebay.co.uk.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=ebay&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Search term for active listings in `search` actions, or ended/sold listings in `sold` actions. Asking prices in active listings should not be assumed to match final transaction amounts. |
| condition | not declared | no | not declared | Filters search results by item condition. Preserve capitalization and spaces: New, Used, Refurbished, or For parts or not working. This is an item-condition filter, not a positive or negative review filter. |
| country | not declared | no | not declared | A compatibility input for domain that also takes an eBay site domain such as ebay.com, not a country code such as US or DE. When both are present, domain takes precedence. |
| domain | not declared | no | not declared | Selects the eBay site domain, such as ebay.com, ebay.de, or ebay.co.uk, without a scheme or path. It defaults to ebay.com and is used to build pages for search, store, and reviews. |
| max_price | not declared | no | not declared | Sets a numeric upper bound for item prices in search. Use it with min_price to define a range, and do not assume that shipping or taxes are included. |
| min_price | not declared | no | not declared | Sets a numeric lower bound for item prices. Filters active listing prices in `search` actions and ended/sold listing prices in `sold` actions. Currency is determined by the target marketplace site and listing data, not API billing. In `sold`, filtering uses whole numbers and decimals round down. |
| sold_only | not declared | no | not declared | Boolean toggle in `search` actions to return only completed sales when set to `true`. Must be passed as a JSON boolean, not a string (`"false"`). |
| limit | integer (1–50) | no | 20 | The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| item_id | platform-native meaning |
| title | Title. null when the platform has no titles (for example text-only posts). |
| url | Link to the record on the platform. |
| price | Price as a number without a currency symbol; see currency. |
| price_text | platform-native meaning |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| condition | platform-native meaning |
| shipping | platform-native meaning |
| seller | platform-native meaning |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| scraped_at | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "ebay",
  "action": "search",
  "params": {
    "keyword": "mechanical keyboard"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "ebay",
        "action": "search",
        "params": {
            "keyword": "mechanical keyboard",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 10. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "ebay",
  "action": "search",
  "results": [
    {
      "item_id": "•••",
      "title": "Lenovo ThinkBook 15-IIL Laptop 15.6” HD Core i5 16GB RAM 256GB SSD Win 11 Pro",
      "url": "https://www.ebay.com/itm/267594157065",
      "price": 319.99,
      "currency": "USD",
      "seller": {
        "name": null,
        "username": null,
        "feedbackScore": null,
        "feedbackPercentage": null
      },
      "image_url": "https://i.ebayimg.com/images/g/TnAAAeSwGRBqtbQP/s-l500.webp",
      "platform": "ebay"
    },
    {
      "item_id": "•••",
      "title": "Lenovo X1 Yoga Gen 3 2-in-1 Laptop 14” FHD Core i5 8GB RAM 512GB SSD Windows 11",
      "url": "https://www.ebay.com/itm/267147782259",
      "price": 242.22,
      "currency": "USD",
      "seller": {
        "name": null,
        "username": null,
        "feedbackScore": null,
        "feedbackPercentage": null
      },
      "image_url": "https://i.ebayimg.com/images/g/wDMAAeSwq8Rqq4ip/s-l500.webp",
      "platform": "ebay"
    }
  ],
  "count": 10,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### How do I get sold prices instead of asking prices?

Set `sold_only` to true, sent as a JSON boolean rather than a string, to request sold items only. The prices shown are what eBay displays for those items, not independently verified sale amounts. For completed sales over a chosen number of days, with the sale price and date, use eBay Sold listings.

### How do I search eBay's UK, German or other sites?

Set `domain` to that country's eBay site, such as ebay.de or ebay.co.uk, with no https:// prefix and no path; ebay.com is the default. `country` is an alternative name that also takes a site domain, not a country code such as DE, and `domain` wins when both are sent. Prices come in that site's currency, so read `currency` on each row.

### Which values does `condition` take?

New, Used, Refurbished or For parts or not working, written with exactly that capitalization and spacing. It filters by item condition, not by review sentiment. A used item and a new one are effectively different markets, so group listings by condition before you average or compare prices.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=ebay
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
