Get a Kick clip

Try in Playground

Retrieve one public Kick clip from the public player metadata API with current counters. Media and thumbnail URLs are returned without downloading their contents.

GET/v1/kick/clipx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

urlstringrequiredquery

Required HTTPS Kick clip URL. Canonical /<channel>/clips/<clip_id> and legacy /<channel>?clip=<clip_id> forms are supported. Duplicate/conflicting clip IDs are rejected.

max 2048 chars · absolute HTTPS URL

Examplehttps://kick.com/example/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892

Response fields

requestIdstring

Operation identifier for correlation.

Upstream HTTP attempts, decoded response bytes and duration. DNS lookups are transport setup and are not counted as HTTP requests. Error response bodies are discarded.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True only when the complete supported clip object validates.

statusstring

success on complete retrieval; failed or challenged with a failure object otherwise.

Full public clip object, including source extensions and nested category, creator, channel and optional VOD metadata. Fields are not renamed or coerced.

clip.idstring

Kick clip ID; must match the requested clip.

clip.livestream_idstringnullable

Source livestream ID as a string, or null.

clip.category_idstringnullable

Source category ID as a string, or null; preserved separately from category.id.

clip.channel_idinteger

Numeric owner channel ID, verified against channel.id.

≥ 0

clip.user_idintegernullable

Numeric clip creator ID, verified against creator.id when available. Null is preserved.

clip.titlestring

Original clip title, including empty strings.

clip.clip_urlstringnullable

Published media URL; may be an HLS playlist or direct media. Returned as data without downloading.

clip.thumbnail_urlstringnullable

Source thumbnail URL; never fetched.

clip.privacyenum

Source public privacy representation, public or CLIP_PRIVACY_PUBLIC. Other privacy values are rejected.

one of: CLIP_PRIVACY_PUBLIC, public

clip.likesintegernullable

Source like count; explicit nulls are preserved.

clip.likedboolean

Upstream logged-out liked flag. No viewer session is supplied.

clip.viewsintegernullable

Source view count at retrieval time. Live counters can change between requests.

clip.durationnumbernullable

Source duration in seconds; fractional values and nulls are preserved.

clip.started_atstringnullable

Source start timestamp string, with original precision, or null.

clip.created_atstringnullable

Source creation timestamp string, with original precision, or null.

clip.vod_starts_atnumbernullableoptional

Optional source VOD offset. Omitted when Kick omits it; explicit nulls are preserved.

clip.is_matureboolean

Published maturity metadata; no age/consent flow is performed.

clip.video_urlstringnullable

Source media alias. Preserved independently from clip_url.

clip.view_countintegernullable

Source view-count alias, preserved independently from views.

clip.likes_countintegernullable

Source likes alias, preserved independently from likes.

Optional VOD object with id and any public source extensions, or null. Not synthesized when absent; no VOD lookup or media fetch.

clip.vod.idstring

Always included.

min 1 chars

Category id, name, slug, responsive, banner, parent_category and extensions, or null.

clip.category.idinteger

Always included.

≥ 0

clip.category.namestring

Always included.

clip.category.slugstring

Always included.

clip.category.responsivestringnullable

Always included.

clip.category.bannerstringnullable

Always included.

clip.category.parent_categorystringnullable

Always included.

Clip creator: id, username, slug, profile_picture and extensions, or null.

clip.creator.idinteger

Always included.

≥ 0

clip.creator.usernamestring

Always included.

clip.creator.slugstring

Always included.

min 1 chars

clip.creator.profile_picturestringnullable

Always included.

Owner channel: id, username, slug, profile_picture and extensions. The slug is checked against the requested channel.

clip.channel.idinteger

Always included.

≥ 0

clip.channel.usernamestring

Always included.

clip.channel.slugstring

Always included.

min 1 chars

clip.channel.profile_picturestringnullable

Always included.

sourceUrlstring

Canonical Kick clip page URL.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Complete validated public clip metadata. Missing required fields fail the request; no reduced-field success is returned.

coverage.sourcestring

Always included.

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

up to 0 items

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

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.

Code example

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"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/kick/clip?url=https%3A%2F%2Fkick.com%2Fexample%2Fclips%2Fclip_01JGJHB6CEVFCQRYTVPM8DW892",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/kick/clip?url=https%3A%2F%2Fkick.com%2Fexample%2Fclips%2Fclip_01JGJHB6CEVFCQRYTVPM8DW892",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Kick request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/kick/clip",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "url": "https://kick.com/example/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/kick/clip?url=https%3A%2F%2Fkick.com%2Fexample%2Fclips%2Fclip_01JGJHB6CEVFCQRYTVPM8DW892", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/kick/clip?url=https%3A%2F%2Fkick.com%2Fexample%2Fclips%2Fclip_01JGJHB6CEVFCQRYTVPM8DW892"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "clip": {
    "id": "clip_01JGJHB6CEVFCQRYTVPM8DW892",
    "livestream_id": "123",
    "category_id": "15",
    "channel_id": 10,
    "user_id": 20,
    "title": "Synthetic clip",
    "clip_url": "https://clips.kick.com/example/playlist.m3u8",
    "thumbnail_url": "https://clips.kick.com/example/thumbnail.webp",
    "privacy": "public",
    "likes": 0,
    "liked": false,
    "views": 42,
    "duration": 12.5,
    "started_at": "2026-09-10T00:00:00.123Z",
    "created_at": "2026-09-10T00:00:13.123456Z",
    "vod_starts_at": 15,
    "is_mature": false,
    "video_url": "https://clips.kick.com/example/playlist.m3u8",
    "view_count": 42,
    "likes_count": 0,
    "vod": {
      "id": "00000000-0000-4000-8000-000000000001"
    },
    "category": {
      "id": 15,
      "name": "Example category",
      "slug": "example-category",
      "responsive": "https://example.test/banner",
      "banner": "https://example.test/banner",
      "parent_category": "example"
    },
    "creator": {
      "id": 20,
      "username": "ExampleCreator",
      "slug": "examplecreator",
      "profile_picture": null
    },
    "channel": {
      "id": 10,
      "username": "Example",
      "slug": "example",
      "profile_picture": "https://example.test/avatar"
    }
  },
  "requestId": "00000000-0000-4000-8000-000000000099",
  "sourceUrl": "https://kick.com/example/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892",
  "fetchedAt": "2026-09-10T00:00:00.000Z",
  "coverage": {
    "source": "public_api",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 1500,
    "durationMs": 800
  }
}

Missing/unsafe clip URL, ambiguous clip IDs, duplicate URL or unsupported parameters.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}