eBay API endpoint

Get eBay item details

Returns normalized details for a public eBay item listing.

GETapiKey2 credits/requestebay.itemResponseDoc/ebay/item/{item_id}

Parameters

NameInTypeRequiredEnumExampleDescription
item_idpathstringYeseBay item ID
x-api-keyheaderstringYesAPI key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost
2 credits/request
Charged response
Successful 2xx responses
PlanPriceIncluded creditsDaily capRate limitOverage
Free$0/mo2,000500 daily credits5/minNo overage
Starter$9/mo20,0005,000 daily credits15/min$0.75/1,000 overage credits when enabled
Growth$29/mo100,00025,000 daily credits45/min$0.45/1,000 overage credits when enabled
Pro$79/mo400,000No daily cap120/min$0.30/1,000 overage credits
Business$199/mo1,200,000No daily cap300/min$0.20/1,000 overage credits
Enterprise$499/mo5,000,000No daily cap1,000/min$0.12/1,000 overage credits

Catalog quality warnings

  • missing example for required path param: item_id

Failure responses

StatusDescriptionSchema
400Bad Request#/definitions/app.Response
404Not Found#/definitions/app.Response
429Too Many Requests#/definitions/app.Response
500Internal Server Error#/definitions/app.Response
502Bad Gateway#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "item_id": "196435705622",
    "title": "1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE",
    "link": "https://www.ebay.com/itm/196435705622",
    "images": [
      "https://i.ebayimg.com/images/g/4yUAAOSwsV9ns4CY/s-l1600.jpg"
    ],
    "price": 49.95,
    "price_text": "US $49.95",
    "condition": "Pre-Owned",
    "availability": "In Stock",
    "sale_status": "Available",
    "shipping": "+$4.95 shipping",
    "location": "Canada",
    "seller_name": "soonerfan1949",
    "seller_link": "https://www.ebay.com/usr/soonerfan1949",
    "seller_store_name": "POLOBLADE COLLECTIBLES",
    "seller_member_since": "Mar 1998",
    "seller_feedback_score": 2067,
    "seller_positive_feedback": 100,
    "rating": 4.8,
    "rating_count": 12,
    "item_specifics": {
      "Card Number": "311",
      "Manufacturer": "Topps"
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/ebay.itemResponseDoc

FieldTypeRequiredEnumBoundsExampleDescription
codeintegerNoCode is the HTTP status code or a custom code used to indicate the result of the request @example 200
dataebay.ItemNo
data.availabilitystringNoIn Stock
data.conditionstringNoPre-Owned
data.descriptionstringNo
data.imagesarrayNo
data.item_feedback_countintegerNo80
data.item_idstringNo196435705622
data.item_specificsobjectNo
data.linkstringNohttps://www.ebay.com/itm/196435705622
data.locationstringNoCanada
data.pricenumberNo49.95
data.price_textstringNoUS $49.95
data.ratingnumberNo4.8
data.rating_countintegerNo12
data.sale_statusstringNoAvailable
data.seller_categoriesarrayNo
data.seller_descriptionstringNo
data.seller_detailed_ratingsobjectNo
data.seller_feedback_scoreintegerNo2067
data.seller_followersintegerNo13000
data.seller_items_soldintegerNo814000
data.seller_linkstringNohttps://www.ebay.com/usr/soonerfan1949
data.seller_logo_urlstringNohttps://i.ebayimg.com/images/g/4yUAAOSwsV9ns4CY/s-l140.jpg
data.seller_member_sincestringNoMar 1998
data.seller_namestringNosoonerfan1949
data.seller_positive_feedbacknumberNo100
data.seller_store_namestringNoPOLOBLADE COLLECTIBLES
data.seller_total_feedback_countintegerNo291075
data.shippingstringNo+$4.95 shipping
data.titlestringNo1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE
msgunknownNoMsg is the message that describes the result of the request @example "Request successful"

Example request

curl -X GET "https://api.crawlora.net/api/v1/ebay/item/%3Citem_id%3E" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/ebay/item/%3Citem_id%3E");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();