eBay API endpoint
Returns the details of one eBay listing by `item_id`: title, link, images, price and price text, condition, availability, item specifics, description, location and shipping. It also carries the seller's name, store, feedback score, followers and items sold, along with the listing's rating and rating count.
/ebay/item/{item_id}Path parameters:
item_id: eBay listing IDReturns details for a public eBay item page.
| Field | In the sample | Value in the sample |
|---|---|---|
| item_id | Has a value | |
| title | Has a value | “1930 Smith & Wesson Gun Pistol Revolver Firearm S&W Vintage…” |
| link | Has a value | ebay.com |
| images | Has a value | 5 entries |
| price | Has a value | 511.99 |
| price_text | Has a value | 511.99 |
| condition | Has a value | “Used” |
| availability | Has a value | “InStock” |
| shipping | Has a value | 118 characters |
| seller_name | Has a value | |
| seller_link | Has a value | ebay.com |
| seller_store_name | Has a value | |
| seller_description | Has a value | 504 characters |
| seller_member_since | Has a value | |
| seller_items_sold | Has a value | 3,100 |
| seller_logo_url | Has a value | i.ebayimg.com |
| seller_categories | Has a value | 15 entries |
| seller_detailed_ratings | Has a value | |
| seller_feedback_score | Has a value | 100 |
| seller_total_feedback_count | Has a value | 1,682 |
| seller_positive_feedback | Has a value | 100 |
| item_specifics | Has a value | |
| description | Has a value | 589 characters |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| item_id (path) | string | Yes | eBay item ID | 196435705622 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/ebay/item/196435705622" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"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
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | ebay.Item | No | ||||
| data.availability | string | No | In Stock | Stock status shown on the listing, such as `In Stock`. | ||
| data.condition | string | No | Pre-Owned | Item condition as listed, such as `Pre-Owned`. | ||
| data.description | string | No | Seller's description of the item. | |||
| data.images | array | No | URLs of the listing photos. | |||
| data.item_feedback_count | integer | No | 80 | Number of buyer feedback entries for this item. | ||
| data.item_id | string | No | 196435705622 | eBay item ID of the listing. Use it with the item endpoint. | ||
| data.item_specifics | object | No | Item specifics table of the listing, mapping each label to its value. | |||
| data.link | string | No | https://www.ebay.com/itm/196435705622 | URL of the listing on eBay. | ||
| data.location | string | No | Canada | Item location shown on the listing, such as `Canada`. | ||
| data.price | number | No | 49.95 | Item price as a number, in the listing's currency. | ||
| data.price_text | string | No | US $49.95 | Price as shown on the listing, such as `US $49.95`. | ||
| data.rating | number | No | 4.8 | Average product star rating. | ||
| data.rating_count | integer | No | 12 | Number of product ratings. | ||
| data.sale_status | string | No | Available | Approximate converted price or bid count shown on the listing, when present. | ||
| data.seller_categories | array | No | Names of the categories in the seller's store. | |||
| data.seller_description | string | No | Seller's own description of their store. | |||
| data.seller_detailed_ratings | object | No | Seller's detailed ratings, mapping each criterion such as `Communication` to its average score. | |||
| data.seller_feedback_score | integer | No | 2067 | Seller's feedback score. | ||
| data.seller_followers | integer | No | 13000 | Number of eBay users following the seller. | ||
| data.seller_items_sold | integer | No | 814000 | Number of items the seller has sold. | ||
| data.seller_link | string | No | https://www.ebay.com/usr/soonerfan1949 | URL of the seller's eBay profile. | ||
| data.seller_logo_url | string | No | https://i.ebayimg.com/images/g/4yUAAOSwsV9ns4CY/s-l140.jpg | URL of the seller's store logo. | ||
| data.seller_member_since | string | No | Mar 1998 | When the seller joined eBay, such as `Mar 1998`. | ||
| data.seller_name | string | No | soonerfan1949 | eBay username of the seller. | ||
| data.seller_positive_feedback | number | No | 100 | Share of the seller's feedback that is positive, as a percentage. | ||
| data.seller_store_name | string | No | POLOBLADE COLLECTIBLES | Name of the seller's eBay store. | ||
| data.seller_total_feedback_count | integer | No | 291075 | Total number of feedback entries the seller has received. | ||
| data.shipping | string | No | +$4.95 shipping | Shipping cost as shown on the listing, such as `+$4.95 shipping`. | ||
| data.title | string | No | 1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE | Listing title as shown on the item page. | ||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/ebay/item/196435705622" \
-H "x-api-key: $CRAWLORA_API_KEY"