---
title: "List an eBay Live stream's featured items"
method: GET
path: "/ebay/live/streams/{id}/items"
tags: ["eBay"]
---

# List an eBay Live stream's featured items

`GET /ebay/live/streams/{id}/items`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/ebay/live/streams/{id}/items`
- Auth: API key in header `x-api-key`

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.

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- EbayLiveStreamItemsResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` EbayLiveStreamItemsResp
    - `event_id` string
    - `items` EbayLiveStreamItem[]
      - `auction_currency` string
      - `auction_ending_at` string
      - `auction_price` number
      - `auction_status` string: 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.
      - `bid_count` integer
      - `currency` string
      - `end_date` string
      - `image_url` string
      - `is_exclusive` boolean: 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).
      - `is_visible` boolean
      - `leader_username` string
      - `listing_id` string
      - `pin` boolean
      - `price` number
      - `purchasable` boolean
      - `sale_type` string
      - `status` string
      - `title` string
      - `winner_username` string
    - `next_cursor` string: 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

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)