eBay API endpoint
Lists the items in an eBay seller's shop, identified by the required `seller` username, one page at a time with `page` (default 1). Each result has its item id, title, link, image, price or price range, shipping note, location, bid count and watcher count. The response gives the `total` and a `has_more` flag.
/ebay/seller/{seller}/shopPath parameters:
seller: eBay seller usernameQuery parameters:
page: shop page number, defaults to 1Returns seller store listings.
| Field | Filled in, of 48 checked | Values in the sample |
|---|---|---|
| image | 48 | i.ebayimg.com |
| item_id | 48 | |
| title | 48 | |
| sub_title | 36 | |
| link | 48 | ebay.com |
| price | 48 | 16.95 to 399.95, median 34.95 |
| watcher_count | 48 | 3 to 1,305, median 74 |
| offer_note | 48 | |
| seller | 48 | |
| logistic | 48 | |
| location | 48 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| seller (path) | string | Yes | eBay seller username | poloblade | |
| page | integer | No | Shop page number | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/ebay/seller/poloblade/shop?page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"page": 1,
"total": 120,
"has_more": true,
"result": [
{
"item_id": "196435705622",
"title": "1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE",
"link": "https://www.ebay.com/itm/196435705622",
"price": 49.95,
"seller": "poloblade",
"logistic": "Free shipping"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/ebay.sellerShopResponseDoc
| 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.SearchResp | No | ||||
| data.has_more | boolean | No | true | Whether more results are available on later pages. | ||
| data.page | integer | No | 1 | Page number returned. | ||
| data.result | array | No | Listings on this page. | |||
| data.result[].bid_count | integer | No | 9 | Number of bids on an auction listing. | ||
| data.result[].caption | string | No | caption | Caption line shown on the search card. | ||
| data.result[].image | string | No | https://i.ebayimg.com/images/g/b6wAAOSwLRdmZeHS/s-l500.jpg | URL of the listing's thumbnail image. | ||
| data.result[].is_authenticity_guaranteed | boolean | No | false | Whether the listing carries eBay's Authenticity Guarantee. | ||
| data.result[].item_id | string | No | 196435705622 | eBay item ID of the listing. Use it with the item endpoint. | ||
| data.result[].link | string | No | https://www.ebay.com/itm/196435705622 | URL of the listing on eBay. | ||
| data.result[].location | string | No | Canada | Item location shown on the search card, such as `Canada`. | ||
| data.result[].logistic | string | No | +$4.95 shipping | Shipping information shown on the search card, such as `+$4.95 shipping`. | ||
| data.result[].offer_note | string | No | Buy It Now | Purchase option label shown on the card, such as `Buy It Now`. | ||
| data.result[].price | number | No | 49.95 | Listing price as a number. Set only when the card shows a single price, not a range. | ||
| data.result[].price_from | number | No | 10 | $10 to $20 | ||
| data.result[].price_to | number | No | 20 | Upper end of the price when the card shows a price range. | ||
| data.result[].rating | number | No | 5 | Average product star rating. | ||
| data.result[].rating_num | integer | No | 1 | Number of product ratings. | ||
| data.result[].seller | string | No | soonerfan1949 (998) 100% | Seller name with feedback count and positive percentage, as shown on the card, such as `soonerfan1949 (998) 100%`. | ||
| data.result[].sold_count | integer | No | 178 | Number of units sold, as shown on the card. | ||
| data.result[].sub_title | string | No | Pre-Owned | Subtitle line shown on the card, such as `Pre-Owned`. | ||
| data.result[].title | string | No | 1983 TOPPS BASEBALL - 1952 TOPPS REPRINTS #311 MICKEY MANTLE | Listing title as shown on the search card. | ||
| data.result[].watcher_count | integer | No | 26 | Number of users watching the listing. | ||
| data.total | integer | No | 120 | Total number of results eBay reports for the search. | ||
| 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/seller/poloblade/shop?page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"