Skip to main content
GET
Get a clip

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

clip_id
string
required

Clip ID. Format: clip_ followed by 32 lowercase hexadecimal characters.

Example:

"clip_5b6c7d8e9f0a4b1c8d2e3f4a5b6c7d8e"

Response

Successful response

A clip submitted to a campaign.

id
string
required

Clip ID.

Pattern: ^clip_[0-9a-f]{32}$
Example:

"clip_5b6c7d8e9f0a4b1c8d2e3f4a5b6c7d8e"

campaign_id
string
required

Campaign ID.

Pattern: ^cmp_[0-9a-f]{32}$
Example:

"cmp_8a1d4e2f6b7c4d9e8f0a1b2c3d4e5f60"

platform
string
required

The platform of the clip: instagram, x, tiktok or youtube. More values can be added. Accept values that you do not know.

Example:

"instagram"

status
enum<string>
required

pending: the clip waits for review. approved: the clip earns from its views. paid: a payout was released for the clip, and it can still earn. rejected: the clip does not earn. not_qualified: the clip does not meet the campaign rules. initial_account_verification: the creator's account must be checked before review. disconnected: the creator removed the account that posted the clip, so the clip stopped earning.

Available options:
pending,
approved,
rejected,
not_qualified,
paid,
initial_account_verification,
disconnected
Example:

"approved"

views
integer
required

Every view on the clip, from every country, at the last reading.

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

48200

likes
integer
required

Likes on the clip at the last reading.

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

2600

comments
integer
required

Comments on the clip at the last reading.

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

140

shares
integer
required

Shares of the clip at the last reading.

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

95

posted_at
string<date-time> | null
required

When the creator posted the clip. Null if it is not known.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Example:

"2026-09-18T17:05:00.000Z"

created_at
string<date-time>
required

When the creator submitted the clip to the campaign.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Example:

"2026-09-18T18:30:00.000Z"

post_url
string
required

The public link to the clip.

Example:

"https://www.instagram.com/reel/C9xYz12AbCd/"

thumbnail_url
string | null
required

A preview image of the clip. Null if there is none. The link can expire.

Example:

"https://cdn.clipstake.example/thumbnails/C9xYz12AbCd.jpg"

creator_handle
string | null
required

The public handle of the account that posted the clip, without the @. Null if it is not known.

Example:

"northwind.reels"