Skip to content

Clip

GET/v1/kick/clip1 credit

Returns a Kick clip: title, duration, views and likes, thumbnail, video playlist URL, creation date, category, and the channel and user who made it.

01Query parameters

NameTypeDescription
urlrequiredstringKick clip URL, e.g. `https://kick.com/xqc/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892`; a `kick.com/<channel>?clip=<id>` link or a bare `clip_…` id also works.

02Request

curl "https://api.scrapesocial.ai/v1/kick/clip?url=https%3A%2F%2Fkick.com%2Fxqc%2Fclips%2Fclip_01JGJHB6CEVFCQRYTVPM8DW892" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/kick/clip?url=https%3A%2F%2Fkick.com%2Fxqc%2Fclips%2Fclip_01JGJHB6CEVFCQRYTVPM8DW892

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "clip": {
    "id": "clip_01JGJHB6CEVFCQRYTVPM8DW892",
    "livestream_id": "45013036",
    "category_id": "15",
    "channel_id": 668,
    "user_id": 13035177,
    "title": "MonkaW",
    "clip_url": "https://clips.kick.com/clips/7a/clip_01JGJHB6CEVFCQRYTVPM8DW892/playlist.m3u8",
    "thumbnail_url": "https://clips.kick.com/clips/7a/clip_01JGJHB6CEVFCQRYTVPM8DW892/thumbnail.webp",
    "privacy": "public",
    "likes": 0,
    "liked": false,
    "views": 12401,
    "duration": 50,
    "started_at": "2025-01-02T03:34:52Z",
    "created_at": "2025-01-02T03:37:13.559618Z",
    "vod_starts_at": 0,
    "is_mature": false,
    "video_url": "https://clips.kick.com/clips/7a/clip_01JGJHB6CEVFCQRYTVPM8DW892/playlist.m3u8",
    "view_count": 12401,
    "likes_count": 0,
    "category": {
      "id": 15,
      "name": "Just Chatting",
      "slug": "just-chatting",
      "responsive": "https://files.kick.com/images/subcategories/15/banner/b697a8a3-62db-4779-aa76-e4e47662af97",
      "banner": "https://files.kick.com/images/subcategories/15/banner/b697a8a3-62db-4779-aa76-e4e47662af97",
      "parent_category": "irl"
    },
    "creator": {
      "id": 13035177,
      "username": "cskorm",
      "slug": "cskorm",
      "profile_picture": null
    },
    "channel": {
      "id": 668,
      "username": "xQc",
      "slug": "xqc",
      "profile_picture": "https://files.kick.com/images/user/676/profile_image/conversion/931b4e8f-5445-427c-bd82-b473530390cc-thumb.webp"
    }
  }
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

The clip is in the `clip` object; `clip_url` and `video_url` point to the clip's HLS playlist. An unknown clip is a free 404; a URL that is not a Kick clip is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

  • 400missing_parameter

    A required parameter is missing or invalid.

  • 403private_account

    The account is private or age-restricted.

  • 404not_found

    No such account.

  • 503upstream_error

    The platform did not answer; retry shortly.