Skip to main content
POST
Predict performance

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

A UUID. When present, deduplicates repeat submissions. See /api-reference/idempotency.

Body

application/json
format
enum<string>
required

video (a reel), text (text alone) or image (text with one or more pictures)

Available options:
video,
text,
image
platforms
enum<string>[]
required

Where it will be posted. video: instagram. text: x and/or linkedin. image: any of x, linkedin and instagram.

Required array length: 1 - 6 elements
Available options:
tiktok,
instagram,
facebook,
x,
linkedin,
youtube
text
string
default:""
required

The caption (video) or post text (text, image), hashtags included, as it will be posted

Maximum string length: 10000
accounts
object
required

Per platform: the account's follower count and posting history. Omit for a new account.

video_url
string<uri>

video: a public https URL of the finished MP4

image_urls
string<uri>[]

image: public https URLs of the pictures, in order. X and LinkedIn read the first four, Instagram the first ten; all are counted.

Maximum array length: 20
post_at
string<date-time>

When it will go out (ISO 8601); now when omitted

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|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$

Response

Success

data
object
required