# eBay API: Get listing details

> Gets the full public details of an eBay listing by link or item number: price, sale type, bids, condition, shipping, delivery, returns, location, item specifics, the seller's description, photos, seller and listing status. Shipping and delivery text may vary by destination; unavailable details are null.

Unofficial. Not affiliated with or endorsed by eBay.

- Page: https://fous.com/methods/ebay.com/get-listing
- Method: `ebay.com/get_listing`, version 1
- Website: ebay.com
- Returns: title, price, currency, sale type, bids, time left, condition, shipping, delivery, returns, location, item specifics, description, photos, seller, feedback, sold, watchers, status, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | 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. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

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

Its 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 packaging, such as a plain or unprinted box or plastic bag. See the seller's listing for full details."
    },
    {
      "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 detailed minifigures of your favorite characters and fun show references — a perfect gift for fans o…",
  "seller_feedback_score": 2824,
  "seller_positive_percent": 99.5
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"ebay.com/get_listing","input":{"listing":"https://www.ebay.com/itm/376273226616"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's the current bid and time left on eBay item 285647193021?
- Can you pull up everything about this listing: https://www.ebay.com/itm/394812736650 — condition, shipping cost, and return policy?
- I'm looking at item #176509823344 — who's the seller, what's their feedback score, and is it still active?
- Show me the item specifics, seller description, and photos for https://www.ebay.com/itm/226043918577 on eBay
- Is listing 305512847769 an auction or buy it now, and where does it ship from and how long is delivery?

## Input schema

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

## Output schema

```json
{
  "type": "object",
  "required": [
    "title",
    "price",
    "currency",
    "sale_type",
    "bids",
    "time_left",
    "condition",
    "condition_notes",
    "shipping_cost",
    "delivery_estimate",
    "returns_policy",
    "item_location",
    "item_specifics",
    "seller_description",
    "photo_links",
    "seller_name",
    "seller_feedback_score",
    "seller_positive_percent",
    "quantity_sold",
    "watchers",
    "listing_status",
    "item_number",
    "page_link"
  ],
  "properties": {
    "bids": {
      "type": [
        "integer",
        "null"
      ]
    },
    "price": {
      "type": [
        "number",
        "null"
      ]
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "currency": {
      "type": [
        "string",
        "null"
      ]
    },
    "watchers": {
      "type": [
        "integer",
        "null"
      ]
    },
    "condition": {
      "type": [
        "string",
        "null"
      ]
    },
    "page_link": {
      "type": "string"
    },
    "sale_type": {
      "enum": [
        "Auction",
        "Buy It Now",
        null
      ],
      "type": [
        "string",
        "null"
      ]
    },
    "time_left": {
      "type": [
        "string",
        "null"
      ]
    },
    "item_number": {
      "type": "string"
    },
    "photo_links": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "seller_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "item_location": {
      "type": [
        "string",
        "null"
      ]
    },
    "quantity_sold": {
      "type": [
        "integer",
        "null"
      ]
    },
    "shipping_cost": {
      "type": [
        "string",
        "null"
      ]
    },
    "item_specifics": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "value"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    "listing_status": {
      "enum": [
        "active",
        "ended"
      ],
      "type": "string"
    },
    "returns_policy": {
      "type": [
        "string",
        "null"
      ]
    },
    "condition_notes": {
      "type": [
        "string",
        "null"
      ]
    },
    "delivery_estimate": {
      "type": [
        "string",
        "null"
      ]
    },
    "seller_description": {
      "type": [
        "string",
        "null"
      ]
    },
    "seller_feedback_score": {
      "type": [
        "integer",
        "null"
      ]
    },
    "seller_positive_percent": {
      "type": [
        "number",
        "null"
      ]
    }
  },
  "additionalProperties": false
}
```

## See more

- [eBay API: Get seller reputation](https://fous.com/methods/ebay.com/get-seller.md): Checks an eBay seller's public feedback profile and newest feedback comments from a username or store link. Store details are included when eBay shows them.
- [Craigslist API: Get listing details](https://fous.com/methods/craigslist.org/get-listing.md): Gets the public details of a Craigslist listing from its link. Deleted or expired listings are not returned, and hidden contact details are not included.
- [Airbnb API: Get listing](https://fous.com/methods/airbnb.com/get-listing.md): Gets public details for one Airbnb listing from its link. When dates are given, it also returns dated prices and cancellation terms if Airbnb offers a quote.
- [Newegg API: Get product details](https://fous.com/methods/newegg.com/get-product.md): Gets full details for a Newegg US product by name, product link, or item number. Seller, price, stock and shipping reflect the selected public offer; shipping may be unavailable when not displayed.
- [Audible API: Get audiobook details](https://fous.com/methods/audible.com/get-audiobook.md): Looks up an audiobook in an Audible store by title (optionally narrowed by author) or by Audible book link, and returns its details, narrators, length, rating, visitor price, series, publisher summary and whether that store's Plus Catalog includes it.
- [Google API: Get Chrome extension details](https://fous.com/methods/chromewebstore.google.com/get-extension.md): Looks up a Chrome Web Store extension by name or store link and returns its public listing: developer, users, rating, version, update date, size, category, description, declared privacy practices, website and store link. Permissions are null when the listing does not show them.
- [Mercari API: Search listings](https://fous.com/methods/mercari.com/search-listings.md): Searches Mercari US listings for items for sale or sold, with condition, price and sorting filters, and adds seller, size and shipping details from each item page. Sold prices are displayed listing prices.
- [Realtor.com API: Get home details](https://fous.com/methods/realtor.com/get-home.md): Gets a home's details from Realtor.com by street address or Realtor.com property link: status, list price, value estimate, beds, baths, size, year built, HOA fee, property and tax history, nearby schools, flood risk and photos.
- [All eBay methods](https://fous.com/methods/ebay.com.md)