# eBay API

> eBay returns public listings, item details, and seller feedback, available as a workflow and API.

Search listings returns displayed listing details and needs a search query, with optional filters such as condition, price, and country. Get listing returns public item details and needs an eBay item number or listing link. Get seller returns public reputation details and recent feedback comments and needs a seller username or store link.

- Page: https://fous.com/workflows/ebay
- Handle: `@ebay`
- Category: [Commerce](https://fous.com/workflows/category/commerce)
- Source website: https://ebay.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with eBay.

## Methods

### Get listing

Operation `get_listing`, version 1. 1 credit per call.

Get full public details for an eBay listing by link or item number. Shipping and delivery text may vary by destination; unavailable details are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `listing` | string | yes | `"https://www.ebay.com/itm/376273226616"` | An eBay item number or listing link, such as https://www.ebay.com/itm/376273226616. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "listing"
  ],
  "properties": {
    "listing": {
      "type": "string",
      "description": "An eBay item number or listing link, such as https://www.ebay.com/itm/376273226616.",
      "examples": [
        "https://www.ebay.com/itm/376273226616",
        "188984621331"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "listing": "https://www.ebay.com/itm/376273226616"
    },
    {
      "listing": "188984621331"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `bids` | integer or null | `0` |  |
| `price` | number or null | `315.48` |  |
| `title` | string or null | `"LEGO 21302 Ideas The Big Bang Theory / New / Factory Sealed"` |  |
| `currency` | string or null | `"GBP"` |  |
| `watchers` | integer or null | `37` |  |
| `condition` | string or null | `"New"` |  |
| `page_link` | string | `"https://www.ebay.com/itm/376273226616"` |  |
| `sale_type` | string or null | `"Buy It Now"` |  |
| `time_left` | string or null | `"6d 21h"` |  |
| `item_number` | string | `"376273226616"` |  |
| `photo_links` | array |  |  |
| `seller_name` | string or null | `"yooyooshop"` |  |
| `item_location` | string or null | `"Bucheon-si, Gyeonggi-do, South Korea"` |  |
| `quantity_sold` | integer or null | `5` |  |
| `shipping_cost` | string or null | `"US $10.48"` |  |
| `item_specifics` | array |  |  |
| `item_specifics[].name` | string | `"Condition"` |  |
| `item_specifics[].value` | string | `"New: A brand-new, unused, unopened and undamaged item in original retail packaging (where packaging is applicable). If ` |  |
| `listing_status` | string | `"active"` |  |
| `returns_policy` | string or null | `"30 days return . Buyer pays for return postage. If you use an eBay delivery label, it will be deducted from your refund` |  |
| `condition_notes` | string or null |  |  |
| `delivery_estimate` | string or null | `"Estimated between Mon, 19 Oct and Mon, 2 Nov to 30144"` |  |
| `seller_description` | string or null | `"The product is a bulk lot of over 50 LEGO sets, including various bricks and building pieces. The sets come in a multic` |  |
| `seller_feedback_score` | integer or null | `2824` |  |
| `seller_positive_percent` | number or null | `99.5` |  |

**Example input**

```json
{
  "listing": "https://www.ebay.com/itm/376273226616"
}
```

**Example output**

```json
{
  "bids": null,
  "price": 315.48,
  "title": "LEGO 21302 Ideas The Big Bang Theory / New / Factory Sealed",
  "currency": "GBP",
  "watchers": 37,
  "condition": "New",
  "page_link": "https://www.ebay.com/itm/376273226616",
  "sale_type": "Buy It Now",
  "time_left": null,
  "item_number": "376273226616",
  "photo_links": [
    "https://i.ebayimg.com/images/g/o6QAAOSwFMNoLX9~/s-l1600.webp",
    "https://i.ebayimg.com/images/g/fzIAAOSwyk9oLX95/s-l1600.webp",
    "https://i.ebayimg.com/images/g/Ui4AAOSwmH1oLX98/s-l1600.webp"
  ],
  "seller_name": "yooyooshop",
  "item_location": "Bucheon-si, Gyeonggi-do, South Korea",
  "quantity_sold": 5,
  "shipping_cost": "US $10.48",
  "item_specifics": [
    {
      "name": "Condition",
      "value": "New: A brand-new, unused, unopened and undamaged item in original retail packaging (where packaging is applicable). If the item comes direct from a manufacturer, it may be delivered in non-retail pack…"
    },
    {
      "name": "Brand",
      "value": "LEGO"
    },
    {
      "name": "LEGO Theme",
      "value": "Ideas"
    }
  ],
  "listing_status": "active",
  "returns_policy": "30 days return . Buyer pays for return postage. If you use an eBay delivery label, it will be deducted from your refund amount .",
  "condition_notes": null,
  "delivery_estimate": "Estimated between Mon, 19 Oct and Mon, 2 Nov to 30144",
  "seller_description": "LEGO 21302 Ideas The Big Bang Theory / New / Factory Sealed We only handle genuine products. Bring home the iconic living room from The Big Bang Theory with this official LEGO Ideas set ! It includes …",
  "seller_feedback_score": 2824,
  "seller_positive_percent": 99.5
}
```

### Get seller

Operation `get_seller`, version 1. 1 credit per call.

Check an eBay seller’s public reputation and newest feedback comments from a username or store link. Store names and item counts are included when shown; abbreviated sold totals are approximate, and the items-for-sale count may be unavailable.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `seller` | string | yes | `"carlylenutritionals"` | The eBay username or store link, for example carlylenutritionals or https://www.ebay.com/str/carlylenutritionals. |
| `max_feedback` | integer | no | `10` | Maximum newest feedback comments to return, for example 10. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "seller"
  ],
  "properties": {
    "seller": {
      "type": "string",
      "description": "The eBay username or store link, for example carlylenutritionals or https://www.ebay.com/str/carlylenutritionals.",
      "examples": [
        "carlylenutritionals",
        "https://www.ebay.com/str/carlylenutritionals",
        "bestbuy"
      ]
    },
    "max_feedback": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum newest feedback comments to return, for example 10.",
      "x-fous-developer": true,
      "examples": [
        10,
        50,
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "seller": "carlylenutritionals",
      "max_feedback": 10
    },
    {
      "seller": "https://www.ebay.com/str/carlylenutritionals",
      "max_feedback": 50
    },
    {
      "seller": "bestbuy",
      "max_feedback": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `location` | string or null | `"United States"` |  |
| `store_name` | string or null |  |  |
| `seller_name` | string | `"carlylenutritionals"` |  |
| `member_since` | string or null | `"Dec-04-19"` |  |
| `profile_link` | string | `"https://www.ebay.com/usr/carlylenutritionals"` |  |
| `feedback_score` | integer or null | `145266` |  |
| `recent_feedback` | array |  |  |
| `recent_feedback[].date` | string or null | `"Past month"` |  |
| `recent_feedback[].rating` | string or null | `"positive"` |  |
| `recent_feedback[].comment` | string or null | `"Thank you"` |  |
| `recent_feedback[].item_link` | string or null | `"https://www.ebay.com/itm/385610287037"` |  |
| `recent_feedback[].item_title` | string or null | `"Red Marine Algae \| 1600 mg \| 200 Capsules \| Vegetarian, Non-GMO \| by Carlyle (#385610287037)"` |  |
| `items_sold_count` | integer or null |  |  |
| `items_for_sale_count` | integer or null |  |  |
| `neutral_ratings_12_months` | integer or null | `115` |  |
| `positive_feedback_percent` | number or null | `99.9` |  |
| `negative_ratings_12_months` | integer or null | `51` |  |
| `positive_ratings_12_months` | integer or null | `62538` |  |

**Example input**

```json
{
  "seller": "carlylenutritionals",
  "max_feedback": 10
}
```

**Example output**

```json
{
  "location": "United States",
  "store_name": null,
  "seller_name": "carlylenutritionals",
  "member_since": "Dec-04-19",
  "profile_link": "https://www.ebay.com/usr/carlylenutritionals",
  "feedback_score": 145266,
  "recent_feedback": [
    {
      "date": "Past month",
      "rating": "positive",
      "comment": "Thank you",
      "item_link": "https://www.ebay.com/itm/385610287037",
      "item_title": "Red Marine Algae | 1600 mg | 200 Capsules | Vegetarian, Non-GMO | by Carlyle (#385610287037)"
    },
    {
      "date": "Past month",
      "rating": "positive",
      "comment": "Great Quality, Thx You.",
      "item_link": "https://www.ebay.com/itm/385932449591",
      "item_title": "Fenugreek Capsules 3000mg | 150 Count | Non-GMO & Gluten Free | by Horbaach (#385932449591)"
    },
    {
      "date": "Past month",
      "rating": "positive",
      "comment": "Arrived quickly. Packaged well. Just what I ordered.",
      "item_link": "https://www.ebay.com/itm/800161205127",
      "item_title": "Olive Leaf Extract Capsules | 70 Count | Non-GMO, Gluten Free | by Carlyle (#800161205127)"
    }
  ],
  "items_sold_count": null,
  "items_for_sale_count": null,
  "neutral_ratings_12_months": 115,
  "positive_feedback_percent": 99.9,
  "negative_ratings_12_months": 51,
  "positive_ratings_12_months": 62538
}
```

### Search listings

Operation `search_listings`, version 1. 1 credit per call.

Search eBay listings in best-match order by keyword, condition, price, format, and site country. Results reflect the public search page and may omit details not shown there.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | Search results page number, such as 2. |
| `query` | string | yes | `"antique clock"` | What to search for, such as Nintendo Switch OLED. |
| `country` | string | no | `"Germany"` | eBay site country name or code, such as United Kingdom or GB. |
| `condition` | string | no | `"used"` | Item condition, such as used. |
| `max_price` | number | no | `150` | Maximum item price, such as 300.00. |
| `min_price` | number | no | `20` | Minimum item price, such as 100.00. |
| `max_results` | integer | no | `10` | Maximum listings to return per page, such as 25. |
| `buying_format` | string | no | `"auction"` | Buying format, such as auction. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Search results page number, such as 2.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    },
    "query": {
      "type": "string",
      "description": "What to search for, such as Nintendo Switch OLED.",
      "examples": [
        "antique clock",
        "lego star wars",
        "Nintendo Switch OLED"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "eBay site country name or code, such as United Kingdom or GB.",
      "examples": [
        "Germany"
      ]
    },
    "condition": {
      "enum": [
        "any",
        "new",
        "used",
        "refurbished"
      ],
      "type": "string",
      "default": "any",
      "description": "Item condition, such as used.",
      "examples": [
        "used"
      ]
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum item price, such as 300.00.",
      "examples": [
        150
      ]
    },
    "min_price": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum item price, such as 100.00.",
      "examples": [
        20
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum listings to return per page, such as 25.",
      "x-fous-developer": true,
      "examples": [
        10
      ]
    },
    "buying_format": {
      "enum": [
        "any",
        "buy_it_now",
        "auction"
      ],
      "type": "string",
      "default": "any",
      "description": "Buying format, such as auction.",
      "examples": [
        "auction"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "antique clock",
      "max_results": 10,
      "buying_format": "auction"
    },
    {
      "page": 2,
      "query": "lego star wars",
      "country": "Germany",
      "condition": "used",
      "max_price": 150,
      "min_price": 20,
      "max_results": 10
    },
    {
      "query": "Nintendo Switch OLED"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `listings` | array |  |  |
| `listings[].price` | number | `14.95` | Item price. |
| `listings[].title` | string | `"10 - Antique Clock Movements for parts or Repair"` | Listing title. |
| `listings[].currency` | string | `"USD"` | Price currency code. |
| `listings[].condition` | string or null | `"Pre-Owned"` | Item condition as displayed. |
| `listings[].time_left` | string or null | `"2m left"` | Auction time remaining as text, or null when not displayed. |
| `listings[].photo_link` | string or null | `"https://i.ebayimg.com/images/g/T9UAAeSwSyBqscVZ/s-l500.webp"` | Listing photo link, when displayed. |
| `listings[].item_number` | string or null | `"137764531393"` | eBay item number. |
| `listings[].seller_name` | string or null | `"aboxintheattic09"` | Seller name, when displayed. |
| `listings[].listing_link` | string | `"https://www.ebay.com/itm/137764531393"` | Link to the item page. |
| `listings[].buying_format` | string | `"Auction"` | Auction or Buy It Now. |
| `listings[].item_location` | string or null | `"United States"` | Item location as displayed. |
| `listings[].shipping_cost` | number or null | `16.5` | Shipping price, 0 for free or null when unavailable. |
| `listings[].number_of_bids` | integer or null | `0` | Auction bid count, or null when not displayed. |
| `listings[].seller_positive_feedback_percent` | number or null | `99.7` | Seller positive feedback percentage, when displayed. |

**Example input**

```json
{
  "query": "antique clock",
  "max_results": 10,
  "buying_format": "auction"
}
```

**Example output**

```json
{
  "listings": [
    {
      "price": 14.95,
      "title": "10 - Antique Clock Movements for parts or Repair",
      "currency": "USD",
      "condition": "Pre-Owned",
      "time_left": "2m left",
      "photo_link": "https://i.ebayimg.com/images/g/T9UAAeSwSyBqscVZ/s-l500.webp",
      "item_number": "137764531393",
      "seller_name": "aboxintheattic09",
      "listing_link": "https://www.ebay.com/itm/137764531393",
      "buying_format": "Auction",
      "item_location": "United States",
      "shipping_cost": 16.5,
      "number_of_bids": 0,
      "seller_positive_feedback_percent": 99.7
    },
    {
      "price": 25,
      "title": "Antique Gilbert Clock Co. mantle clock",
      "currency": "USD",
      "condition": "Parts Only",
      "time_left": "4d 23h left",
      "photo_link": "https://i.ebayimg.com/images/g/3yIAAeSwgeNquvuA/s-l500.webp",
      "item_number": "189007107601",
      "seller_name": "chrisdcooke70",
      "listing_link": "https://www.ebay.com/itm/189007107601",
      "buying_format": "Auction",
      "item_location": "United States",
      "shipping_cost": 27.64,
      "number_of_bids": 0,
      "seller_positive_feedback_percent": 97.7
    },
    {
      "price": 88.88,
      "title": "Vintage Antique  Germany Striking Vienna Clock,2 Brass Weight,porcelain Dial",
      "currency": "USD",
      "condition": "Pre-Owned",
      "time_left": "5d 20h left",
      "photo_link": "https://i.ebayimg.com/images/g/aYsAAeSwaHNqtYBz/s-l500.webp",
      "item_number": "147596831938",
      "seller_name": "9skystar",
      "listing_link": "https://www.ebay.com/itm/147596831938",
      "buying_format": "Auction",
      "item_location": "United States",
      "shipping_cost": 150,
      "number_of_bids": 6,
      "seller_positive_feedback_percent": 100
    }
  ]
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@ebay",
  "visibility": "public",
  "operation": "get_listing",
  "version": 1,
  "input": {
    "listing": "https://www.ebay.com/itm/376273226616"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@ebay\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_listing\",\n  \"version\": 1,\n  \"input\": {\n    \"listing\": \"https://www.ebay.com/itm/376273226616\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@ebay",
  "visibility": "public",
  "operation": "get_listing",
  "version": 1,
  "input": {
    "listing": "https://www.ebay.com/itm/376273226616"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@ebay","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Compare listing prices and conditions across search results
- Find auctions and check their remaining time
- Review an item's shipping, returns, and condition details
- Check a seller's feedback and recent comments

## FAQ

### Is Fous affiliated with eBay?

No. Fous is not affiliated with eBay. This workflow reads the public ebay.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a eBay account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from ebay.com when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

### What listings match a search query?

Search listings returns matching listings with displayed titles, prices, conditions, and other details.

### What are the details of an eBay item?

Get listing returns public item details from an eBay item number or listing link.

### What feedback has a seller received recently?

Get seller returns public seller details and newest feedback comments from a username or store link.

## Related

- [Etsy API](https://fous.com/workflows/etsy.md): Etsy provides current listings and prices, shop ratings and shipping, plus public item and shop details; some review counts or listings may be unavailable.
- [Amazon API](https://fous.com/workflows/amazon.md): Amazon returns publicly shown product listings, prices, details, ratings, reviews, current best sellers, and Today's Deals; availability and content vary by store, location, and access.
- [Mercari API](https://fous.com/workflows/mercari.md): Search secondhand and sold listings on Mercari US.
- [AliExpress API](https://fous.com/workflows/aliexpress.md): AliExpress returns product listings and selected product details, including prices, variants, reviews, and destination-specific shipping options shown for the displayed variant.
- [Mercado Libre API](https://fous.com/workflows/mercado-libre.md): Search public marketplace listings in Latin America.
- [Craigslist API](https://fous.com/workflows/craigslist.md): Craigslist offers local ads and searches public listings newest by search order; available listing details omit hidden contacts, and renewals may have older dates.
- [Best Buy API](https://fous.com/workflows/best-buy.md): Best Buy returns US electronics and appliance listings, prices, deals, specifications, images, reviews, and nearby store pickup and shipping details; prices and availability can change by location and before checkout.
- [Airbnb API](https://fous.com/workflows/airbnb.md): Airbnb returns public stays, listing details, dated trip prices, and night availability, which depend on dates and may be limited, unavailable, or change.
- [All Commerce workflows](https://fous.com/workflows/category/commerce)