---
title: "Get Job Videos"
method: GET
path: "/api/jobs/{job_id}/videos"
tags: ["Scraping"]
---

# Get Job Videos

`GET /api/jobs/{job_id}/videos`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/api/jobs/{job_id}/videos`
- Auth: HTTP bearer

List videos discovered by a single job.

``sort``: ``views`` (default) | ``likes`` | ``recent``.
``role``: optional filter on analyzer's user_role tag
          (``kol`` | ``seller`` | ``other``).
Output is intentionally a slim dict per video — the grid view only
needs thumbnail/url/caption/views/author, so we don't pay for full
VideoOut serialization on 200-row payloads.

## Path parameters

- `job_id` string, required

## Query parameters

- `sort` string
- `role` string, nullable
- `limit` integer
- `offset` integer

## Headers

- `x-kolens-user-id` string, nullable

## Response `200`

Successful Response

- object[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)