REreacherapp
Usage Rights

List a shop's videos and usage-rights state

Changed on

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).

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

Query parameters

statusstring nullable
searchstring nullable
sort_bystring nullable
sort_orderstring
pageinteger
page_sizeinteger
date_fromstring nullable
date_tostring nullable
gmv_minnumber nullable
gmv_maxnumber nullable
views_mininteger nullable
views_maxinteger nullable
creatorsstring nullable

Comma-separated creator handles.

product_idsstring 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_librarystring
transcript_keywordsstring nullable

Comma/newline-separated phrases matched against the spoken transcript.

transcript_modestring
transcript_scan_captionboolean
archivedstring

Response

Successful Response

dataobject required

Changes