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
| Name | In | Type | Required | Enum | Example | Description |
|---|---|---|---|---|---|---|
| item_id | path | string | Yes | eBay item ID | ||
| x-api-key | header | string | Yes | API 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
| Plan | Price | Included credits | Daily cap | Rate limit | Overage |
|---|---|---|---|---|---|
| Free | $0/mo | 2,000 | 500 daily credits | 5/min | No overage |
| Starter | $9/mo | 20,000 | 5,000 daily credits | 15/min | $0.75/1,000 overage credits when enabled |
| Growth | $29/mo | 100,000 | 25,000 daily credits | 45/min | $0.45/1,000 overage credits when enabled |
| Pro | $79/mo | 400,000 | No daily cap | 120/min | $0.30/1,000 overage credits |
| Business | $199/mo | 1,200,000 | No daily cap | 300/min | $0.20/1,000 overage credits |
| Enterprise | $499/mo | 5,000,000 | No daily cap | 1,000/min | $0.12/1,000 overage credits |
Catalog quality warnings
- missing example for required path param: item_id
Failure responses
| 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 |
| 502 | Bad 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
| 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 | |||
| data.condition | string | No | Pre-Owned | |||
| data.description | string | No | ||||
| data.images | array | No | ||||
| data.item_feedback_count | integer | No | 80 | |||
| data.item_id | string | No | 196435705622 | |||
| data.item_specifics | object | No | ||||
| data.link | string | No | https://www.ebay.com/itm/196435705622 | |||
| data.location | string | No | Canada | |||
| data.price | number | No | 49.95 | |||
| data.price_text | string | No | US $49.95 | |||
| data.rating | number | No | 4.8 | |||
| data.rating_count | integer | No | 12 | |||
| data.sale_status | string | No | Available | |||
| data.seller_categories | array | No | ||||
| data.seller_description | string | No | ||||
| data.seller_detailed_ratings | object | No | ||||
| data.seller_feedback_score | integer | No | 2067 | |||
| data.seller_followers | integer | No | 13000 | |||
| data.seller_items_sold | integer | No | 814000 | |||
| data.seller_link | string | No | https://www.ebay.com/usr/soonerfan1949 | |||
| data.seller_logo_url | string | No | https://i.ebayimg.com/images/g/4yUAAOSwsV9ns4CY/s-l140.jpg | |||
| data.seller_member_since | string | No | Mar 1998 | |||
| data.seller_name | string | No | soonerfan1949 | |||
| data.seller_positive_feedback | number | No | 100 | |||
| data.seller_store_name | string | No | POLOBLADE COLLECTIBLES | |||
| data.seller_total_feedback_count | integer | No | 291075 | |||
| data.shipping | string | No | +$4.95 shipping | |||
| data.title | string | No | 1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE | |||
| msg | unknown | No | Msg 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();