Everything one listing publishes: title, status, price in US dollars and in the seller's own currency, original price, availability and the exact quantity where eBay states a number, units sold, condition, the seller with their exact feedback score and store URL, shipping cost and service to the United States, where it ships from, the return policy, auction state (current bid, bid count, end time, whether there is a reserve), item specifics, the category path, full-size image URLs, brand, MPN and GTIN, accepted payment methods and when it was listed. An ended listing is a 200 with status ended and its final prices; a listing that does not exist is a 404.

POST /listing-details Listings

https://api.fetchlayer.dev/ebay/listing-details

OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

listing string required

eBay item number (for example 334140575100), or any eBay listing URL.

format string optional

json or markdown. Markdown returns the same result rendered for a model to read. (default: json)

timeoutMs number optional

Time limit for each eBay page read, in milliseconds (max 120000).

Response Fields

listing-details

Get one listing in full

resultType string

Which shape this response is: search-listings, listing-details, price-check, seller-feedback or product-reviews.

requestedUrl string

The eBay page this result corresponds to.

scrapedAt string

ISO 8601 timestamp of when the data was read.

transport string

The upstream source. Always "ebay".

notes string[]

Caveats about this particular result — converted prices, a walk that stopped early, a continuation that may repeat listings. Read it on every call: it is where an incomplete answer announces itself.

listing object

The listing.

listing.itemId string

Item number, with title and url alongside it.

listing.status string

active or ended.

listing.buyingFormat string

fixed_price or auction.

listing.acceptsOffers boolean

Whether offers are accepted.

listing.price object

Price as { amount, currency } in US dollars, as shown to a US buyer. A listing priced in another currency is converted at eBay's current rate.

listing.listingPrice object

The seller's own figure, in the seller's currency. Equal to price for a US-dollar listing. Compare this over time to tell a real price change from exchange-rate movement.

listing.originalPrice object

List or earlier price where shown, or null.

listing.availability string

in_stock, out_of_stock, or null.

listing.quantityAvailable number

Exact when eBay states a number; null for "More than 10 available".

listing.quantityText string

The quantity line as shown.

listing.soldCount number

Units sold.

listing.condition string

Condition as shown.

listing.seller object

username, exact feedbackScore, positivePercent and storeUrl.

listing.shipping object

cost (US dollars), listingCost (seller currency, when not US dollars), free, service and text.

listing.location string

Where it ships from, for example "Ontario, California, United States".

listing.returns string

Return policy as shown.

listing.auction object

For auctions: currentBid, listingCurrentBid, bidCount, endsAt (ISO 8601) and hasReservePrice. Null for fixed-price listings.

listing.itemSpecifics object[]

{ name, value } pairs as the seller entered them.

listing.categories object[]

Category path as { categoryId, name }.

listing.imageUrls string[]

Full-size image URLs.

listing.brand string

Brand, with mpn and gtin alongside it. Null when absent or "Does not apply".

listing.paymentMethods string[]

Accepted payment methods.

listing.listedAt string

When the listing went live, ISO 8601.

Request

curl -X POST "https://api.fetchlayer.dev/ebay/listing-details" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"334140575100"}'

Response

{
  "resultType": "listing-details",
  "requestedUrl": "https://www.ebay.com/itm/334140575100?_ul=US",
  "transport": "ebay",
  "notes": [],
  "listing": {
    "itemId": "334140575100",
    "title": "Anker Nano Pro 20W USB C Charger PIQ 3.0 Fast Charging for iPhone 14 13 iPad Pro",
    "url": "https://www.ebay.com/itm/334140575100",
    "status": "active",
    "buyingFormat": "fixed_price",
    "acceptsOffers": false,
    "price": {
      "amount": 11.99,
      "currency": "USD"
    },
    "listingPrice": {
      "amount": 11.99,
      "currency": "USD"
    },
    "originalPrice": null,
    "availability": "in_stock",
    "quantityAvailable": null,
    "quantityText": "More than 10 available",
    "soldCount": 1256,
    "condition": "New",
    "seller": {
      "username": "ankerdirect",
      "feedbackScore": 282091,
      "positivePercent": 99.8,
      "storeUrl": "https://www.ebay.com/str/ankerdirect"
    },
    "shipping": {
      "cost": null,
      "listingCost": null,
      "free": true,
      "service": "Standard Shipping",
      "text": "Free Standard Shipping"
    },
    "location": "Ontario, California, United States",
    "returns": "30 days returns. Buyer pays for return shipping.",
    "auction": null,
    "itemSpecifics": [
      {
        "name": "Items Included",
        "value": "Anker Nano Pro Charger"
      },
      {
        "name": "Material",
        "value": "Plastic"
      }
    ],
    "categories": [
      {
        "categoryId": "15032",
        "name": "Cell Phones & Accessories"
      },
      {
        "categoryId": "9394",
        "name": "Cell Phone Accessories"
      },
      {
        "categoryId": "123417",
        "name": "Chargers & Cradles"
      }
    ],
    "imageUrls": [
      "https://i.ebayimg.com/images/g/n4AAAOSwsOthODVm/s-l1600.jpg"
    ],
    "brand": "Anker",
    "mpn": "AKA2637",
    "gtin": null,
    "paymentMethods": [
      "PayPal",
      "Venmo",
      "Google Pay",
      "Visa",
      "Master Card",
      "Discover"
    ],
    "listedAt": "2021-09-08T04:09:32Z"
  }
}

{
  "error": "Invalid API key"
}