eBay API endpoint
Returns summaries for several eBay Live streams in one call. `ids` is required and takes up to 9 stream ids, comma-separated or repeated. Each stream has its title, state, watch count, hosts, tags and preview media, without the per-host feedback summary. Ids that do not resolve are silently omitted, and the order may differ from the request.
/ebay/live/streams/batchQuery parameters:
ids: one or more eBay Live stream/event ids (from LiveStream.id in an ebay-live-streams or ebay-live-stream response), up to 9 per request. Comma-separated (ids=a,b,c) or repeated (ids=a&ids=b&ids=c) query values are both accepted.Returns summaries for multiple eBay Live streams/events in a single call, useful for looking up several known ids at once instead of issuing one ebay-live-stream request per id. An id that does not currently resolve to a real event is silently omitted from the response rather than causing an error; the response order is not guaranteed to match the requested id order.
The stream summaries returned here carry the same fields as the ebay-live-streams hub feed (title, state, watch count, hosts, tags, preview media) but do not include the per-host feedback summary that ebay-live-stream (single-stream detail) returns.
| Field | Filled in, of 1 checked | Values in the sample |
|---|---|---|
| id | 1 | |
| title | 1 | “Jules' Tools - Milwaukee, DeWALT, Ryobi Power TOOLS!!!” |
| state | 1 | “RECORDED” |
| start_time | 1 | 2026-08-09 |
| hosts | 1 | median 1 entry |
| tags | 1 | median 2 entries |
| preview_image_url | 1 | i.ebayimg.com |
| preview_stream_url | 1 | live.us.shoplive.cloud |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| ids | string | Yes | One or more eBay Live stream/event ids, up to 9. Comma-separated or repeated query values are both accepted. | FncRQ8VJGxKzLase | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/ebay/live/streams/batch?ids=FncRQ8VJGxKzLase" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"streams": [
{
"id": "FncRQ8VJGxKzLase",
"title": "$500K+ $1 START SINGLES-GIVEAWAYS-HIGH END FLOORS W/ JOSH 08/10",
"state": "LIVE",
"start_time": "2026-08-10T15:59:10Z",
"watched_count": 121,
"hosts": [
{
"id": "UpO5wCULTye",
"username": "filthbombbreaks",
"store_name": "Filthbombbreaks"
}
],
"tags": [
"$1 Starts",
"Baseball"
],
"preview_image_url": "https://i.ebayimg.com/00/s/ODg4WDU5Mg==/z/8zoAAeSwNz9qdOYW/$_45.JPG",
"preview_stream_url": "https://live.us.shoplive.cloud/live-p/45-5zBlMTqjPZvFoNPWb-ue2_480p/playlist.m3u8?preview=1"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/ebay.liveStreamsBatchResponseDoc
| 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.LiveStreamsBatchResp | No | ||||
| data.streams | array | No | Streams preserves the order returned by upstream, which is not guaranteed to match the requested id order. An id that does not resolve to a real event is silently omitted -- confirmed live that upstream returns 200 with a shorter events array rather than an error for unknown ids, matching the plural-lookup semantics of a batch endpoint rather than the single-id GetLiveStream's typed 404. LiveStream record, 28 fields: channels, description, end_time, hosts, id, is_case_break, is_user_registered, like_count, live_stream_url, preview_image_url, preview_stream_url, start_time and 4 more. Described under eBay Live Streams API. | |||
| 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/batch?ids=FncRQ8VJGxKzLase" \
-H "x-api-key: $CRAWLORA_API_KEY"