---
title: "List eBay Live streams"
method: GET
path: "/ebay/live/streams"
tags: ["eBay"]
---

# List eBay Live streams

`GET /ebay/live/streams`

## Request

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

Lists live and upcoming eBay Live streams for one category channel, set with `category` (default `explore`; other values are channel ids such as `IPqZx79LNuwFcSVt` for Sports Singles). Each stream has its title, state, start time, watch count, hosts, tags and preview media. Host feedback is not included. Page on with `next_request_number` and `session_id`, passed back as `request_number` and `session_id`.

## Query parameters

- `category` 'explore' | 'IPqZx79LNuwFcSVt' | 'oHjQFTlZ5cYgWkjB' | 'l68DJtBAVZge4x4n' | '2Nk3OYiOJHfXqpWG' | '5quuEnjO3axyz46U' | 'nGpMTpm13Q86Eaoo' | 'sYRxeaskGmNC6xaB' | 'iYaYo88zN2vtQorh' | 'GYAbsFw6onSNloAb' | 'WJ9zLwYjK8njaBtN' | 'rALkRyk8gXHzIBR6' | 'DNta0sJ8Y6NXZsC9' | 'GU4UfBzZSF4jiteS' | 'IO7Oih07PtNJSWhU' | 'cF4xtF8z9riubmLh' | 'bywKDIdtxhi4hUSO'
- `request_number` integer
- `session_id` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- EbayLiveStreamsResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` EbayLiveStreamsResp
    - `category` string
    - `next_request_number` integer: NextRequestNumber and SessionID feed back into a follow-up call's request_number/session_id to fetch the next page.
    - `session_id` string
    - `streams` EbayLiveStream[]
      - `channels` string[]
      - `description` string
      - `end_time` string
      - `hosts` EbayLiveStreamHost[]
        - `communication_rating` number
        - `feedback_negative_count` integer
        - `feedback_neutral_count` integer
        - `feedback_positive_count` integer: Feedback* / *Rating fields are only populated by Service.GetLiveStream (single-stream detail); Service.ListLiveStreams' hub feed does not request this data, so these are zero/omitted there. All scores are scoped to the seller's last 365 days of feedback.
        - `feedback_positive_percent` number
        - `id` string
        - `item_as_described_rating` number
        - `profile_picture_url` string
        - `shipping_cost_rating` number
        - `shipping_time_rating` number
        - `store_name` string
        - `username` string
      - `id` string
      - `is_case_break` boolean
      - `is_user_registered` boolean
      - `like_count` integer
      - `live_stream_url` string
      - `preview_image_url` string
      - `preview_stream_url` string
      - `start_time` string
      - `state` string
      - `tags` string[]
      - `title` string
      - `watched_count` integer
  - `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/0497899e2016?raw)