Item Detail

eBay

Retrieve one public eBay listing by exact item ID or URL with price, availability, shipping and seller details.

Current price
$0.0021/result
Availability
Ready to run
Last accepted verification

What this API does

Read one public eBay product page by an 8-19 digit item ID or canonical item URL. The normalized response includes stable item identity, marketplace, title, lifecycle and availability, exact price and currency, shipping, condition, seller summary, images and retrieval time. Item IDs default to eBay US; URLs support the listed US, UK, German, French, Italian, Spanish, Canadian and Australian marketplaces. This route does not search, bid, buy, message, authenticate or expose supplier controls.

Agents select this operation with tool ID ebay.item-detail, then inspect its current executable contract before a run.

Public input and output shape

Input

item_id_or_urlstring · required

An 8-19 digit eBay item ID or public HTTPS eBay /itm/ URL.

minLength: 1 · maxLength: 2048

marketplacestring · optional

Used for an item ID and required to match a supplied item URL when present.

enum: EBAY_US, EBAY_GB, EBAY_DE, EBAY_FR, EBAY_IT, EBAY_ES, EBAY_CA, EBAY_AU

Output

itemobject

Returned item value.

unavailablenull

Returned unavailable value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "ebay.item-detail",
  "input": {
    "marketplace": "EBAY_US",
    "item_id_or_url": "236749852278"
  }
}

Output

{
  "item": {
    "url": "https://www.ebay.com/itm/236749852278",
    "price": {
      "amount": "149.99",
      "currency": "USD"
    },
    "title": "Apple AirPods Pro 1st Gen w/ Wireless Charging Case ANC Earbuds NEW SEALED",
    "images": [
      "https://i.ebayimg.com/images/g/sbMAAeSw2L9p2e3w/s-l1600.webp",
      "https://i.ebayimg.com/images/g/rToAAeSwrq1p2e3x/s-l1600.webp",
      "https://i.ebayimg.com/images/g/8bIAAeSw7pFp2e3w/s-l1600.webp",
      "https://i.ebayimg.com/images/g/r4MAAeSwRPJp2e3x/s-l1600.webp",
      "https://i.ebayimg.com/images/g/yzQAAeSwCy1p2e3x/s-l1600.webp"
    ],
    "seller": {
      "url": "https://www.ebay.com/str/aapltree?_trksid=p4429486.m3561.l161211",
      "name": "aapltree",
      "rating": "100% positive feedback",
      "reviews": "12298"
    },
    "source": "ebay",
    "status": "available",
    "item_id": "236749852278",
    "shipping": {
      "amount": null,
      "service": null,
      "currency": "USD",
      "excludes": null,
      "ships_to": null
    },
    "condition": "New",
    "sold_count": "6",
    "marketplace": "EBAY_US",
    "availability": "in_stock",
    "retrieved_at": "2026-08-21T14:43:27.913Z",
    "item_location": "Sammamish, Washington, United States",
    "return_policy": "30 days returns . Buyer pays for return shipping. If you use an eBay shipping label, it will be deducted from your refund amount . See details - for more information about returns",
    "listing_format": "Buy It Now",
    "available_count": 2,
    "availability_date": "Get it between Mon, Aug 24 and Wed, Aug 26"
  },
  "unavailable": null
}
Teaching errors and limitations
  • invalid_input: item_id_or_url must be one eBay item ID or a supported public eBay item URL.example: {"item_id_or_url":"326972541236","marketplace":"EBAY_US"}
  • configuration_error: The eBay item-detail supplier is not configured on the server.The wallet was not charged.
Updated
21 August 2026

Use Item Detail with Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.