Live streaming
Kick API
Retrieve a public Kick clip with media URLs, counts, timestamps, category, creator, and channel details.
1 endpointx-api-key
Get the complete public clip object in one authenticated request. Source types, aliases, optional fields, and nested attributes are preserved.
API availability: Available
Base URL · local worker
http://localhost:3011Public API: https://api.scrapeatlas.com.Endpoints
Quick start
Create an API key on your account page, then call the public API. Values below are placeholders.
Terminal
curl "https://api.scrapeatlas.com/v1/kick/clip?url=https%3A%2F%2Fkick.com%2Fexample%2Fclips%2Fclip_01JGJHB6CEVFCQRYTVPM8DW892" \
-H "x-api-key: YOUR_API_KEY"Coverage & limits
- One clip per request; four concurrent requests per worker. Saturation returns 503 busy.
- 15-second total deadline, at most two upstream HTTP attempts including one transient network/5xx retry. Rate limits, challenges, redirects, and missing clips are not retried.
- 2 MiB total decoded JSON, depth 16, and 5,000 examined nodes. Oversized or complex payloads fail explicitly.
- Missing or malformed required fields and mismatched clip/channel/creator identity fail explicitly. Optional VOD fields retain source absence; known nulls and source extensions are preserved.
- Private or access-gated clips are reported as restricted. No login, cookies or private tokens are used. A public maturity flag is returned as metadata.
- Media, playlist, thumbnail and VOD URLs are returned as data, never downloaded.
- Views and likes are live source values and can change between requests.
- System DNS is the default. Operators can set KICK_DNS_SERVERS to one to three DNS server IP addresses for this worker only. HTTPS certificate verification remains enabled; no system DNS change or hardcoded Kick address is used.
Error codes
11
| HTTP | failure.code | Meaning |
|---|---|---|
| 400 | invalid_request | Missing/unsafe clip URL, ambiguous clip IDs, duplicate URL or unsupported parameters. |
| 401 | unauthorized | Missing or invalid worker API key. |
| 403 | restricted_page | The clip is private or requires access/consent. |
| 404 | not_found | Kick reports a missing or deleted clip. |
| 429 | upstream_rate_limited | Kick rate limited the request; no automatic retry. |
| 502 | upstream_challenged | Kick rejected or challenged the request. |
| 502 | unsupported_page | Malformed, incomplete, unexpected, or mismatched clip metadata. |
| 502 | response_too_large payload_too_complex | The JSON exceeded byte, depth or node limits. |
| 502 | unsafe_redirect request_limit upstream_error | The bounded request could not complete. |
| 503 | busy | All worker slots are in use. |
| 504 | timeout | The total retrieval deadline expired. |
