eBay API endpoint
Lists the items currently featured in an eBay Live stream, identified by the required event `id`. Each item has its listing id, title, price and currency, bid count, sale type, leader and winner usernames, and `auction_status` (`READY`, `LIVE` or `ENDED`). A stream with no featured items, or an unknown id, returns an empty `items` array.
/ebay/live/streams/{id}/itemsPath parameters:
id: eBay Live stream/event id, from an ebay-live-streams response's streams[].idReturns the currently featured/auction items for an eBay Live stream, including live bidding state (price, bid count, leader/winner, auction status). auction_status is one of READY (queued, not yet started), LIVE (actively taking bids), or ENDED. An event with no currently featured items, or an unknown event id, both return a 200 with an empty items array.
| Field | Filled in, of 149 checked | Values in the sample |
|---|---|---|
| listing_id | 149 | |
| title | 149 | “#001 - Tool ONLY - Unless Specified! - Watch Auction - No C…” and 148 other values |
| status | 149 | ENDED in all 149 |
| price | 149 | 0.01 to 200, median 5 |
| currency | 149 | USD in all 149 |
| bid_count | 104 | 2 to 57, median 18 |
| sale_type | 149 | Auction in all 149 |
| image_url | 149 | i.ebayimg.com |
| end_date | 104 | 2026-08-09 |
| is_exclusive | 149 | true in 149 of 149 |
| auction_status | 149 | ENDED in all 149 |
| auction_price | 149 | 5 to 441, median 50 |
| auction_currency | 149 | USD in all 149 |
| winner_username | 104 | |
| is_visible | 149 | true in 149 of 149 |
| pin | 1 | true in 1 of 1 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | eBay Live stream/event id | qrJnMkM8X2hJuIf3 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/ebay/live/streams/qrJnMkM8X2hJuIf3/items" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"event_id": "qrJnMkM8X2hJuIf3",
"items": [
{
"listing_id": "188766881103",
"title": "#001 - Tool ONLY - Unless Specified! - Watch Auction - No Cancellations! 8/9 1pm",
"status": "ENDED",
"price": 1,
"currency": "USD",
"bid_count": 22,
"sale_type": "Auction",
"end_date": "2026-08-09T17:05:26Z",
"is_exclusive": true,
"auction_status": "ENDED",
"auction_price": 19,
"auction_currency": "USD",
"winner_username": "angelina2026_4",
"is_visible": true
}
]
}
}Request schema
No body schema
Response schema
#/definitions/ebay.liveStreamItemsResponseDoc
| 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.LiveStreamItemsResp | No | ||||
| data.event_id | string | No | qrJnMkM8X2hJuIf3 | |||
| data.items | array | No | ||||
| data.items[].auction_currency | string | No | ||||
| data.items[].auction_ending_at | string | No | ||||
| data.items[].auction_price | number | No | ||||
| data.items[].auction_status | string | No | READY | Auction* fields reflect the live bidding state and are only meaningful for saleType Auction. AuctionStatus is one of READY (queued, not yet started), LIVE (actively taking bids), or ENDED. | ||
| data.items[].bid_count | integer | No | 22 | |||
| data.items[].currency | string | No | USD | |||
| data.items[].end_date | string | No | 2026-08-09T17:05:26Z | |||
| data.items[].image_url | string | No | ||||
| data.items[].is_exclusive | boolean | No | IsExclusive/Purchasable reflect eBay Live's own commerce-signal flags for this listing (e.g. whether it can be bought outright vs. only won via the live auction). | |||
| data.items[].is_visible | boolean | No | ||||
| data.items[].leader_username | string | No | ||||
| data.items[].listing_id | string | No | 188766881103 | |||
| data.items[].pin | boolean | No | ||||
| data.items[].price | number | No | 1 | |||
| data.items[].purchasable | boolean | No | ||||
| data.items[].sale_type | string | No | Auction | |||
| data.items[].status | string | No | ACTIVE | |||
| data.items[].title | string | No | #001 - Tool ONLY - Unless Specified! - Watch Auction | |||
| data.items[].winner_username | string | No | ||||
| data.next_cursor | string | No | NextCursor is upstream's own pagination cursor for this listing set. Cursor-based continuation is not yet exposed as a caller-facing input; this field is surfaced for forward compatibility and informational use. | |||
| 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 |
| 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/live/streams/qrJnMkM8X2hJuIf3/items" \
-H "x-api-key: $CRAWLORA_API_KEY"