---
title: "List a shop's videos and usage-rights state"
method: GET
path: "/usage-rights/videos"
tags: ["Usage Rights"]
---

# List a shop's videos and usage-rights state

`GET /usage-rights/videos`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/usage-rights/videos`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

The shop's videos with their usage-rights status (`requested`, `accepted`, `active`, `declined`, …), filterable by status, search, date, GMV/views, creators, products, and spoken-transcript keywords. Ordered and paginated. Single shop only (set `x-shop-id`).

## Query parameters

- `status` string, nullable
- `search` string, nullable
- `sort_by` string, nullable
- `sort_order` string
- `page` integer
- `page_size` integer
- `date_from` string, nullable
- `date_to` string, nullable
- `gmv_min` number, nullable
- `gmv_max` number, nullable
- `views_min` integer, nullable
- `views_max` integer, nullable
- `creators` string, nullable: Comma-separated creator handles.
- `product_ids` string, nullable: Comma-separated TikTok product ids. A video matches when the product is the one it is listed under, or appears anywhere in its product anchors.
- `in_library` string
- `transcript_keywords` string, nullable: Comma/newline-separated phrases matched against the spoken transcript.
- `transcript_mode` string
- `transcript_scan_caption` boolean
- `archived` string

## Response `200`

Successful Response

- UsageRightsVideosResponse
  - `data` object, required

## Other responses

- `422`: Validation Error

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-09-10** `7dad11366a32`: 1 info
  - added the new optional `query` request parameter `product_ids`
- **2026-09-03** `30786bf76d4b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/usage-rights/videos/get.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)