Publish short video to YouTube Shorts, Instagram Reels, and/or TikTok

curl --request POST \
  --url https://www.citedy.com/api/agent/shorts/publish \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_url": "<string>",
  "speech_text": "<string>",
  "targets": [
    {
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "tiktok_title": "<string>",
  "tiktok_disable_comment": true,
  "tiktok_disable_duet": true,
  "tiktok_disable_stitch": true,
  "tiktok_brand_content_toggle": true,
  "tiktok_brand_organic_toggle": true,
  "tiktok_is_aigc": true
}
'

import requests

url = "https://www.citedy.com/api/agent/shorts/publish"

payload = {
    "video_url": "<string>",
    "speech_text": "<string>",
    "targets": [{ "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }],
    "tiktok_title": "<string>",
    "tiktok_disable_comment": True,
    "tiktok_disable_duet": True,
    "tiktok_disable_stitch": True,
    "tiktok_brand_content_toggle": True,
    "tiktok_brand_organic_toggle": True,
    "tiktok_is_aigc": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    video_url: '<string>',
    speech_text: '<string>',
    targets: [{account_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'}],
    tiktok_title: '<string>',
    tiktok_disable_comment: true,
    tiktok_disable_duet: true,
    tiktok_disable_stitch: true,
    tiktok_brand_content_toggle: true,
    tiktok_brand_organic_toggle: true,
    tiktok_is_aigc: true
  })
};

fetch('https://www.citedy.com/api/agent/shorts/publish', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.citedy.com/api/agent/shorts/publish",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'video_url' => '<string>',
    'speech_text' => '<string>',
    'targets' => [
        [
                'account_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
        ]
    ],
    'tiktok_title' => '<string>',
    'tiktok_disable_comment' => true,
    'tiktok_disable_duet' => true,
    'tiktok_disable_stitch' => true,
    'tiktok_brand_content_toggle' => true,
    'tiktok_brand_organic_toggle' => true,
    'tiktok_is_aigc' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.citedy.com/api/agent/shorts/publish"

	payload := strings.NewReader("{\n  \"video_url\": \"<string>\",\n  \"speech_text\": \"<string>\",\n  \"targets\": [\n    {\n      \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"tiktok_title\": \"<string>\",\n  \"tiktok_disable_comment\": true,\n  \"tiktok_disable_duet\": true,\n  \"tiktok_disable_stitch\": true,\n  \"tiktok_brand_content_toggle\": true,\n  \"tiktok_brand_organic_toggle\": true,\n  \"tiktok_is_aigc\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.citedy.com/api/agent/shorts/publish")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"video_url\": \"<string>\",\n  \"speech_text\": \"<string>\",\n  \"targets\": [\n    {\n      \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"tiktok_title\": \"<string>\",\n  \"tiktok_disable_comment\": true,\n  \"tiktok_disable_duet\": true,\n  \"tiktok_disable_stitch\": true,\n  \"tiktok_brand_content_toggle\": true,\n  \"tiktok_brand_organic_toggle\": true,\n  \"tiktok_is_aigc\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.citedy.com/api/agent/shorts/publish")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"video_url\": \"<string>\",\n  \"speech_text\": \"<string>\",\n  \"targets\": [\n    {\n      \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"tiktok_title\": \"<string>\",\n  \"tiktok_disable_comment\": true,\n  \"tiktok_disable_duet\": true,\n  \"tiktok_disable_stitch\": true,\n  \"tiktok_brand_content_toggle\": true,\n  \"tiktok_brand_organic_toggle\": true,\n  \"tiktok_is_aigc\": true\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "platform": "<string>",
      "ok": true,
      "post_id": "<string>",
      "error": {
        "code": "<string>",
        "message": "<string>"
      }
    }
  ],
  "metadata_provider": "<string>",
  "metadata_degraded": true,
  "timings": {
    "metadata_ms": 123,
    "total_ms": 123
  },
  "credits_charged": 123
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "credits_required": 123,
  "topup": {
    "recommended_package_credits": 123,
    "recommended_package_price_usd": 123,
    "topup_url": "<string>"
  },
  "message": "<string>",
  "breakdown": {}
}

{
  "error": "<string>",
  "retry_after": 123,
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

POST

api

agent

shorts

publish

Publish short video to YouTube Shorts, Instagram Reels, and/or TikTok

curl --request POST \
  --url https://www.citedy.com/api/agent/shorts/publish \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_url": "<string>",
  "speech_text": "<string>",
  "targets": [
    {
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "tiktok_title": "<string>",
  "tiktok_disable_comment": true,
  "tiktok_disable_duet": true,
  "tiktok_disable_stitch": true,
  "tiktok_brand_content_toggle": true,
  "tiktok_brand_organic_toggle": true,
  "tiktok_is_aigc": true
}
'

import requests

url = "https://www.citedy.com/api/agent/shorts/publish"

payload = {
    "video_url": "<string>",
    "speech_text": "<string>",
    "targets": [{ "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }],
    "tiktok_title": "<string>",
    "tiktok_disable_comment": True,
    "tiktok_disable_duet": True,
    "tiktok_disable_stitch": True,
    "tiktok_brand_content_toggle": True,
    "tiktok_brand_organic_toggle": True,
    "tiktok_is_aigc": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    video_url: '<string>',
    speech_text: '<string>',
    targets: [{account_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'}],
    tiktok_title: '<string>',
    tiktok_disable_comment: true,
    tiktok_disable_duet: true,
    tiktok_disable_stitch: true,
    tiktok_brand_content_toggle: true,
    tiktok_brand_organic_toggle: true,
    tiktok_is_aigc: true
  })
};

fetch('https://www.citedy.com/api/agent/shorts/publish', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.citedy.com/api/agent/shorts/publish",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'video_url' => '<string>',
    'speech_text' => '<string>',
    'targets' => [
        [
                'account_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
        ]
    ],
    'tiktok_title' => '<string>',
    'tiktok_disable_comment' => true,
    'tiktok_disable_duet' => true,
    'tiktok_disable_stitch' => true,
    'tiktok_brand_content_toggle' => true,
    'tiktok_brand_organic_toggle' => true,
    'tiktok_is_aigc' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.citedy.com/api/agent/shorts/publish"

	payload := strings.NewReader("{\n  \"video_url\": \"<string>\",\n  \"speech_text\": \"<string>\",\n  \"targets\": [\n    {\n      \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"tiktok_title\": \"<string>\",\n  \"tiktok_disable_comment\": true,\n  \"tiktok_disable_duet\": true,\n  \"tiktok_disable_stitch\": true,\n  \"tiktok_brand_content_toggle\": true,\n  \"tiktok_brand_organic_toggle\": true,\n  \"tiktok_is_aigc\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://www.citedy.com/api/agent/shorts/publish")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"video_url\": \"<string>\",\n  \"speech_text\": \"<string>\",\n  \"targets\": [\n    {\n      \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"tiktok_title\": \"<string>\",\n  \"tiktok_disable_comment\": true,\n  \"tiktok_disable_duet\": true,\n  \"tiktok_disable_stitch\": true,\n  \"tiktok_brand_content_toggle\": true,\n  \"tiktok_brand_organic_toggle\": true,\n  \"tiktok_is_aigc\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.citedy.com/api/agent/shorts/publish")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"video_url\": \"<string>\",\n  \"speech_text\": \"<string>\",\n  \"targets\": [\n    {\n      \"account_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"tiktok_title\": \"<string>\",\n  \"tiktok_disable_comment\": true,\n  \"tiktok_disable_duet\": true,\n  \"tiktok_disable_stitch\": true,\n  \"tiktok_brand_content_toggle\": true,\n  \"tiktok_brand_organic_toggle\": true,\n  \"tiktok_is_aigc\": true\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "platform": "<string>",
      "ok": true,
      "post_id": "<string>",
      "error": {
        "code": "<string>",
        "message": "<string>"
      }
    }
  ],
  "metadata_provider": "<string>",
  "metadata_degraded": true,
  "timings": {
    "metadata_ms": 123,
    "total_ms": 123
  },
  "credits_charged": 123
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "credits_required": 123,
  "topup": {
    "recommended_package_credits": 123,
    "recommended_package_price_usd": 123,
    "topup_url": "<string>"
  },
  "message": "<string>",
  "breakdown": {}
}

{
  "error": "<string>",
  "retry_after": 123,
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer citedy_agent_* key

Body

application/json

video_url

string<uri>

required

HTTPS URL of the video. Must be hosted on download.citedy.com (path must start with /agent/shorts/ or /agent/reels/) or Supabase storage. The R2 prefix restriction ensures Meta's facebookexternalhit crawler can fetch the video via our /media/shorts/... proxy on www.citedy.com — direct R2 URLs are blocked by the bucket's default Disallow: / robots.txt and cause Instagram Reel publish to fail.

speech_text

string

required

Spoken text from the video for metadata generation

Required string length: 5 - 2000

targets

object[]

required

Platforms to publish to (max 3). Duplicate platforms are rejected by runtime validation.

Required array length: 1 - 3 elements

Show child attributes

privacy_status

enum<string>

Publish privacy. YouTube supports public/unlisted/private. TikTok uses tiktok_privacy_level from the account's current creator_info options; privacy_status=private remains a compatibility fallback for SELF_ONLY. Instagram Reels ignores this field.

Available options:

public,

unlisted,

private

tiktok_privacy_level

enum<string>

TikTok-only visibility level selected from the account's current TikTok creator_info options.

Available options:

PUBLIC_TO_EVERYONE,

FOLLOWER_OF_CREATOR,

MUTUAL_FOLLOW_FRIENDS,

SELF_ONLY

tiktok_title

string

TikTok-only reviewed post title/caption.

Required string length: 1 - 2200

tiktok_disable_comment

boolean

TikTok-only flag to disable comments for the post.

tiktok_disable_duet

boolean

TikTok-only flag to disable duets for the post.

tiktok_disable_stitch

boolean

TikTok-only flag to disable stitches for the post.

tiktok_brand_content_toggle

boolean

TikTok-only commercial disclosure flag for third-party branded content. Branded content cannot use SELF_ONLY visibility.

tiktok_brand_organic_toggle

boolean

TikTok-only commercial disclosure flag for content promoting the creator's own brand.

tiktok_is_aigc

boolean

TikTok-only flag indicating AI-generated content.

Response

Publish completed (check per-platform results)

results

object[]

Show child attributes

metadata_provider

string

LLM provider used for metadata generation

metadata_degraded

boolean

True if AI metadata generation failed and static fallback was used

timings

object

Show child attributes

credits_charged

number

Overview

Health

Registration

Agent Info

Status

Settings

Personas

Content Creation

Social Adaptations

Autopilot Sessions

Publishing

Scheduling

Trend Scanning

Scout

Content Gaps

Competitors

Knowledge Base

Content Ingestion

Video (Shorts)

Lead Magnets

Webhooks

SEO Tools

Articles

Gsc

Warm Leads

Publish short video to YouTube Shorts, Instagram Reels, and/or TikTok

Authorizations

Body

Response