Item Detail

eBay

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

Capability: eBay product research
Current price: $0.0025/request
Availability: Ready to run

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 check its current inputs and price before a run.

Inputs and outputs

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

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

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
}

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.

Use Item Detail with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.