Reference example
# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
--url https://api.aisa.one/apis/v1/social/posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"content": "Our spring collection is live.",
"mediaItems": [
{
"mediaId": "med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6",
"type": "video"
}
],
"platforms": [
{
"accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3",
"platform": "tiktok",
"platformSpecificData": {
"privacyLevel": "PUBLIC_TO_EVERYONE"
}
}
],
"profileId": "prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4",
"scheduledFor": "2026-11-20T15:00:00Z",
"timezone": "America/New_York"
}'curl --request POST \
--url https://api.aisa.one/apis/v1/social/posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"content": "Our spring collection is live.",
"mediaItems": [
{
"mediaId": "med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6",
"type": "video"
}
],
"platforms": [
{
"accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3",
"platform": "tiktok",
"platformSpecificData": {
"privacyLevel": "PUBLIC_TO_EVERYONE"
}
}
],
"profileId": "prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4",
"scheduledFor": "2026-11-20T15:00:00Z",
"timezone": "America/New_York"
}
'import requests
url = "https://api.aisa.one/apis/v1/social/posts"
payload = {
"content": "Our spring collection is live.",
"mediaItems": [
{
"mediaId": "med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6",
"type": "video"
}
],
"platforms": [
{
"accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3",
"platform": "tiktok",
"platformSpecificData": { "privacyLevel": "PUBLIC_TO_EVERYONE" }
}
],
"profileId": "prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4",
"scheduledFor": "2026-11-20T15:00:00Z",
"timezone": "America/New_York"
}
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({
content: 'Our spring collection is live.',
mediaItems: [{mediaId: 'med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6', type: 'video'}],
platforms: [
{
accountId: 'acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3',
platform: 'tiktok',
platformSpecificData: {privacyLevel: 'PUBLIC_TO_EVERYONE'}
}
],
profileId: 'prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4',
scheduledFor: '2026-11-20T15:00:00Z',
timezone: 'America/New_York'
})
};
fetch('https://api.aisa.one/apis/v1/social/posts', 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://api.aisa.one/apis/v1/social/posts",
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([
'content' => 'Our spring collection is live.',
'mediaItems' => [
[
'mediaId' => 'med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6',
'type' => 'video'
]
],
'platforms' => [
[
'accountId' => 'acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3',
'platform' => 'tiktok',
'platformSpecificData' => [
'privacyLevel' => 'PUBLIC_TO_EVERYONE'
]
]
],
'profileId' => 'prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4',
'scheduledFor' => '2026-11-20T15:00:00Z',
'timezone' => 'America/New_York'
]),
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://api.aisa.one/apis/v1/social/posts"
payload := strings.NewReader("{\n \"content\": \"Our spring collection is live.\",\n \"mediaItems\": [\n {\n \"mediaId\": \"med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6\",\n \"type\": \"video\"\n }\n ],\n \"platforms\": [\n {\n \"accountId\": \"acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3\",\n \"platform\": \"tiktok\",\n \"platformSpecificData\": {\n \"privacyLevel\": \"PUBLIC_TO_EVERYONE\"\n }\n }\n ],\n \"profileId\": \"prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4\",\n \"scheduledFor\": \"2026-11-20T15:00:00Z\",\n \"timezone\": \"America/New_York\"\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://api.aisa.one/apis/v1/social/posts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"content\": \"Our spring collection is live.\",\n \"mediaItems\": [\n {\n \"mediaId\": \"med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6\",\n \"type\": \"video\"\n }\n ],\n \"platforms\": [\n {\n \"accountId\": \"acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3\",\n \"platform\": \"tiktok\",\n \"platformSpecificData\": {\n \"privacyLevel\": \"PUBLIC_TO_EVERYONE\"\n }\n }\n ],\n \"profileId\": \"prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4\",\n \"scheduledFor\": \"2026-11-20T15:00:00Z\",\n \"timezone\": \"America/New_York\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/social/posts")
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 \"content\": \"Our spring collection is live.\",\n \"mediaItems\": [\n {\n \"mediaId\": \"med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6\",\n \"type\": \"video\"\n }\n ],\n \"platforms\": [\n {\n \"accountId\": \"acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3\",\n \"platform\": \"tiktok\",\n \"platformSpecificData\": {\n \"privacyLevel\": \"PUBLIC_TO_EVERYONE\"\n }\n }\n ],\n \"profileId\": \"prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4\",\n \"scheduledFor\": \"2026-11-20T15:00:00Z\",\n \"timezone\": \"America/New_York\"\n}"
response = http.request(request)
puts response.read_body{
"content": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"mediaItems": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"notice": "<string>",
"platforms": [
{
"accountId": "<string>",
"customContent": "<string>",
"customMedia": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"error": {
"category": "platform_rate_limit",
"message": "<string>",
"platformError": {},
"retryHint": "never",
"retryable": true,
"source": "<string>"
},
"platform": "tiktok",
"platformPostId": "<string>",
"platformPostUrl": "<string>",
"platformSpecificData": {},
"publishedAt": "2023-11-07T05:31:56Z",
"removedAt": "2023-11-07T05:31:56Z",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>"
}
],
"profileId": "<string>",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>",
"timezone": "<string>",
"title": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"content": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"mediaItems": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"notice": "<string>",
"platforms": [
{
"accountId": "<string>",
"customContent": "<string>",
"customMedia": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"error": {
"category": "platform_rate_limit",
"message": "<string>",
"platformError": {},
"retryHint": "never",
"retryable": true,
"source": "<string>"
},
"platform": "tiktok",
"platformPostId": "<string>",
"platformPostUrl": "<string>",
"platformSpecificData": {},
"publishedAt": "2023-11-07T05:31:56Z",
"removedAt": "2023-11-07T05:31:56Z",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>"
}
],
"profileId": "<string>",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>",
"timezone": "<string>",
"title": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"content": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"mediaItems": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"notice": "<string>",
"platforms": [
{
"accountId": "<string>",
"customContent": "<string>",
"customMedia": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"error": {
"category": "platform_rate_limit",
"message": "<string>",
"platformError": {},
"retryHint": "never",
"retryable": true,
"source": "<string>"
},
"platform": "tiktok",
"platformPostId": "<string>",
"platformPostUrl": "<string>",
"platformSpecificData": {},
"publishedAt": "2023-11-07T05:31:56Z",
"removedAt": "2023-11-07T05:31:56Z",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>"
}
],
"profileId": "<string>",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>",
"timezone": "<string>",
"title": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"content": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"mediaItems": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"notice": "<string>",
"platforms": [
{
"accountId": "<string>",
"customContent": "<string>",
"customMedia": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"error": {
"category": "platform_rate_limit",
"message": "<string>",
"platformError": {},
"retryHint": "never",
"retryable": true,
"source": "<string>"
},
"platform": "tiktok",
"platformPostId": "<string>",
"platformPostUrl": "<string>",
"platformSpecificData": {},
"publishedAt": "2023-11-07T05:31:56Z",
"removedAt": "2023-11-07T05:31:56Z",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>"
}
],
"profileId": "<string>",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>",
"timezone": "<string>",
"title": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "<string>",
"details": {},
"message": "<string>",
"param": "<string>",
"retryHint": "never",
"retryable": true,
"type": "<string>"
}
}AIsa Social
Create a post
Creates a draft, a scheduled post, or publishes now. Drafts stay in AIsa until scheduled or published. Returns 201, 207 when some platforms failed synchronously, or 202 with status publishing or scheduled while the outcome is pending. A replay of an idempotent request returns 200 with the original post.
<!-- aisa-pricing:start -->
A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->
POST
https://api.aisa.one
/
apis
/
v1
/
social
/
posts
Reference example
# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
--url https://api.aisa.one/apis/v1/social/posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"content": "Our spring collection is live.",
"mediaItems": [
{
"mediaId": "med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6",
"type": "video"
}
],
"platforms": [
{
"accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3",
"platform": "tiktok",
"platformSpecificData": {
"privacyLevel": "PUBLIC_TO_EVERYONE"
}
}
],
"profileId": "prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4",
"scheduledFor": "2026-11-20T15:00:00Z",
"timezone": "America/New_York"
}'curl --request POST \
--url https://api.aisa.one/apis/v1/social/posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"content": "Our spring collection is live.",
"mediaItems": [
{
"mediaId": "med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6",
"type": "video"
}
],
"platforms": [
{
"accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3",
"platform": "tiktok",
"platformSpecificData": {
"privacyLevel": "PUBLIC_TO_EVERYONE"
}
}
],
"profileId": "prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4",
"scheduledFor": "2026-11-20T15:00:00Z",
"timezone": "America/New_York"
}
'import requests
url = "https://api.aisa.one/apis/v1/social/posts"
payload = {
"content": "Our spring collection is live.",
"mediaItems": [
{
"mediaId": "med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6",
"type": "video"
}
],
"platforms": [
{
"accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3",
"platform": "tiktok",
"platformSpecificData": { "privacyLevel": "PUBLIC_TO_EVERYONE" }
}
],
"profileId": "prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4",
"scheduledFor": "2026-11-20T15:00:00Z",
"timezone": "America/New_York"
}
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({
content: 'Our spring collection is live.',
mediaItems: [{mediaId: 'med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6', type: 'video'}],
platforms: [
{
accountId: 'acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3',
platform: 'tiktok',
platformSpecificData: {privacyLevel: 'PUBLIC_TO_EVERYONE'}
}
],
profileId: 'prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4',
scheduledFor: '2026-11-20T15:00:00Z',
timezone: 'America/New_York'
})
};
fetch('https://api.aisa.one/apis/v1/social/posts', 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://api.aisa.one/apis/v1/social/posts",
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([
'content' => 'Our spring collection is live.',
'mediaItems' => [
[
'mediaId' => 'med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6',
'type' => 'video'
]
],
'platforms' => [
[
'accountId' => 'acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3',
'platform' => 'tiktok',
'platformSpecificData' => [
'privacyLevel' => 'PUBLIC_TO_EVERYONE'
]
]
],
'profileId' => 'prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4',
'scheduledFor' => '2026-11-20T15:00:00Z',
'timezone' => 'America/New_York'
]),
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://api.aisa.one/apis/v1/social/posts"
payload := strings.NewReader("{\n \"content\": \"Our spring collection is live.\",\n \"mediaItems\": [\n {\n \"mediaId\": \"med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6\",\n \"type\": \"video\"\n }\n ],\n \"platforms\": [\n {\n \"accountId\": \"acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3\",\n \"platform\": \"tiktok\",\n \"platformSpecificData\": {\n \"privacyLevel\": \"PUBLIC_TO_EVERYONE\"\n }\n }\n ],\n \"profileId\": \"prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4\",\n \"scheduledFor\": \"2026-11-20T15:00:00Z\",\n \"timezone\": \"America/New_York\"\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://api.aisa.one/apis/v1/social/posts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"content\": \"Our spring collection is live.\",\n \"mediaItems\": [\n {\n \"mediaId\": \"med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6\",\n \"type\": \"video\"\n }\n ],\n \"platforms\": [\n {\n \"accountId\": \"acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3\",\n \"platform\": \"tiktok\",\n \"platformSpecificData\": {\n \"privacyLevel\": \"PUBLIC_TO_EVERYONE\"\n }\n }\n ],\n \"profileId\": \"prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4\",\n \"scheduledFor\": \"2026-11-20T15:00:00Z\",\n \"timezone\": \"America/New_York\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/social/posts")
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 \"content\": \"Our spring collection is live.\",\n \"mediaItems\": [\n {\n \"mediaId\": \"med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6\",\n \"type\": \"video\"\n }\n ],\n \"platforms\": [\n {\n \"accountId\": \"acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3\",\n \"platform\": \"tiktok\",\n \"platformSpecificData\": {\n \"privacyLevel\": \"PUBLIC_TO_EVERYONE\"\n }\n }\n ],\n \"profileId\": \"prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4\",\n \"scheduledFor\": \"2026-11-20T15:00:00Z\",\n \"timezone\": \"America/New_York\"\n}"
response = http.request(request)
puts response.read_body{
"content": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"mediaItems": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"notice": "<string>",
"platforms": [
{
"accountId": "<string>",
"customContent": "<string>",
"customMedia": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"error": {
"category": "platform_rate_limit",
"message": "<string>",
"platformError": {},
"retryHint": "never",
"retryable": true,
"source": "<string>"
},
"platform": "tiktok",
"platformPostId": "<string>",
"platformPostUrl": "<string>",
"platformSpecificData": {},
"publishedAt": "2023-11-07T05:31:56Z",
"removedAt": "2023-11-07T05:31:56Z",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>"
}
],
"profileId": "<string>",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>",
"timezone": "<string>",
"title": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"content": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"mediaItems": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"notice": "<string>",
"platforms": [
{
"accountId": "<string>",
"customContent": "<string>",
"customMedia": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"error": {
"category": "platform_rate_limit",
"message": "<string>",
"platformError": {},
"retryHint": "never",
"retryable": true,
"source": "<string>"
},
"platform": "tiktok",
"platformPostId": "<string>",
"platformPostUrl": "<string>",
"platformSpecificData": {},
"publishedAt": "2023-11-07T05:31:56Z",
"removedAt": "2023-11-07T05:31:56Z",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>"
}
],
"profileId": "<string>",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>",
"timezone": "<string>",
"title": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"content": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"mediaItems": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"notice": "<string>",
"platforms": [
{
"accountId": "<string>",
"customContent": "<string>",
"customMedia": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"error": {
"category": "platform_rate_limit",
"message": "<string>",
"platformError": {},
"retryHint": "never",
"retryable": true,
"source": "<string>"
},
"platform": "tiktok",
"platformPostId": "<string>",
"platformPostUrl": "<string>",
"platformSpecificData": {},
"publishedAt": "2023-11-07T05:31:56Z",
"removedAt": "2023-11-07T05:31:56Z",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>"
}
],
"profileId": "<string>",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>",
"timezone": "<string>",
"title": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"content": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"mediaItems": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"notice": "<string>",
"platforms": [
{
"accountId": "<string>",
"customContent": "<string>",
"customMedia": [
{
"altText": "<string>",
"mediaId": "<string>",
"thumbnailUrl": "<string>",
"title": "<string>",
"type": "<string>",
"url": "<string>"
}
],
"error": {
"category": "platform_rate_limit",
"message": "<string>",
"platformError": {},
"retryHint": "never",
"retryable": true,
"source": "<string>"
},
"platform": "tiktok",
"platformPostId": "<string>",
"platformPostUrl": "<string>",
"platformSpecificData": {},
"publishedAt": "2023-11-07T05:31:56Z",
"removedAt": "2023-11-07T05:31:56Z",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>"
}
],
"profileId": "<string>",
"scheduledFor": "2023-11-07T05:31:56Z",
"status": "<string>",
"timezone": "<string>",
"title": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "<string>",
"details": {},
"message": "<string>",
"param": "<string>",
"retryHint": "never",
"retryable": true,
"type": "<string>"
}
}Request contract
- Method and path: POST /apis/v1/social/posts
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/social/posts - Idempotency-Key: header; optional
- Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
{
"operationId": "post_aisa_social_apis_v1_social_posts",
"method": "POST",
"path": "/apis/v1/social/posts",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"description": "Strongly recommended. Reusing a key within 24 hours returns the original result; a different body returns 409 idempotency_key_reused. Without a key the server derives one from the body in 10-minute buckets and echoes it in the response header.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"maxLength": 191,
"minLength": 1,
"type": "string"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"content": {
"application/json": {
"example": {
"content": "Our spring collection is live.",
"mediaItems": [
{
"mediaId": "med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6",
"type": "video"
}
],
"platforms": [
{
"accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3",
"platform": "tiktok",
"platformSpecificData": {
"privacyLevel": "PUBLIC_TO_EVERYONE"
}
}
],
"profileId": "prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4",
"scheduledFor": "2026-11-20T15:00:00Z",
"timezone": "America/New_York"
},
"schema": {
"additionalProperties": false,
"properties": {
"content": {
"type": [
"string",
"null"
]
},
"isDraft": {
"type": [
"boolean",
"null"
]
},
"mediaItems": {
"items": {
"additionalProperties": false,
"properties": {
"altText": {
"type": [
"string",
"null"
]
},
"mediaId": {
"pattern": "^med_[0-9A-Za-z]{22}$",
"type": [
"string",
"null"
]
},
"thumbnailUrl": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"type": [
"array",
"null"
]
},
"platforms": {
"items": {
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"platform": {
"enum": [
"tiktok"
]
}
},
"required": [
"platform"
]
},
"then": {
"properties": {
"platformSpecificData": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"description": "Required to schedule or publish: privacyLevel, allowComment. Also required for video: allowDuet, allowStitch. Must be true, from the user: contentPreviewConfirmed, expressConsentGiven.",
"properties": {
"allowComment": {
"description": "Allow comments. Must be false when creator-info reports commentDisabled.",
"type": "boolean"
},
"allowDuet": {
"description": "Allow duets; required for video. Must be false when creator-info reports duetDisabled.",
"type": "boolean"
},
"allowStitch": {
"description": "Allow stitches; required for video. Must be false when creator-info reports stitchDisabled.",
"type": "boolean"
},
"brandPartnerPromote": {
"description": "Also disclose a paid partnership; only alongside commercialContentType brand_organic.",
"type": "boolean"
},
"commercialContentType": {
"description": "Commercial content disclosure; one of commercialContentTypes from creator-info. brand_content cannot be SELF_ONLY.",
"enum": [
"none",
"brand_organic",
"brand_content"
],
"type": "string"
},
"contentPreviewConfirmed": {
"description": "The user previewed exactly this content. Must be true and must come from the user.",
"type": "boolean"
},
"description": {
"description": "Long caption for photo posts.",
"maxLength": 4000,
"minLength": 1,
"type": "string"
},
"expressConsentGiven": {
"description": "The user consented to posting. Must be true and must come from the user.",
"type": "boolean"
},
"isBrandOrganicPost": {
"description": "Also disclose the creator's own brand; only alongside commercialContentType brand_content.",
"type": "boolean"
},
"mediaType": {
"description": "Overrides the media type derived from the media items.",
"enum": [
"video",
"photo"
],
"type": "string"
},
"privacyLevel": {
"description": "One of privacyLevelOptions from GET /accounts/{accountId}/tiktok/creator-info for this mediaType.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"videoMadeWithAi": {
"description": "Label the post as AI-generated.",
"type": "boolean"
}
},
"type": "object"
}
]
}
}
}
},
{
"if": {
"properties": {
"platform": {
"enum": [
"instagram"
]
}
},
"required": [
"platform"
]
},
"then": {
"properties": {
"platformSpecificData": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"description": "",
"properties": {
"collaborators": {
"description": "Up to 3 usernames to invite as collaborators (feed and Reels).",
"items": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"maxItems": 3,
"type": "array"
},
"contentType": {
"description": "story publishes a Story.",
"enum": [
"story"
],
"type": "string"
},
"firstComment": {
"description": "First comment added after publishing (not on Stories).",
"maxLength": 2200,
"minLength": 1,
"type": "string"
},
"isAiGenerated": {
"description": "Label the post as containing AI-generated media.",
"type": "boolean"
},
"shareToFeed": {
"description": "Reels only: also show the Reel on the main feed (default true).",
"type": "boolean"
}
},
"type": "object"
}
]
}
}
}
},
{
"if": {
"properties": {
"platform": {
"enum": [
"twitter",
"x"
]
}
},
"required": [
"platform"
]
},
"then": {
"properties": {
"platformSpecificData": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"description": "",
"properties": {
"madeWithAi": {
"description": "Label the post as containing AI-generated media.",
"type": "boolean"
},
"poll": {
"additionalProperties": false,
"description": "A poll; cannot be combined with media or threadItems.",
"properties": {
"duration_minutes": {
"maximum": 10080,
"minimum": 5,
"type": "integer"
},
"options": {
"items": {
"maxLength": 25,
"minLength": 1,
"type": "string"
},
"maxItems": 4,
"minItems": 2,
"type": "array"
}
},
"required": [
"options",
"duration_minutes"
],
"type": "object"
},
"replySettings": {
"description": "Who can reply.",
"enum": [
"following",
"mentionedUsers",
"subscribers",
"verified"
],
"type": "string"
},
"threadItems": {
"description": "The whole thread; the first item is the root post. Cannot be combined with poll.",
"items": {
"additionalProperties": false,
"properties": {
"content": {
"description": "Text of this post.",
"maxLength": 25000,
"minLength": 1,
"type": "string"
}
},
"required": [
"content"
],
"type": "object"
},
"minItems": 1,
"type": "array"
}
},
"type": "object"
}
]
}
}
}
},
{
"if": {
"properties": {
"platform": {
"enum": [
"youtube"
]
}
},
"required": [
"platform"
]
},
"then": {
"properties": {
"platformSpecificData": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"description": "Required to schedule or publish: madeForKids.",
"properties": {
"containsSyntheticMedia": {
"description": "Label the video as containing synthetic (AI-generated) content.",
"type": "boolean"
},
"firstComment": {
"description": "First comment posted after upload.",
"maxLength": 10000,
"minLength": 1,
"type": "string"
},
"madeForKids": {
"description": "COPPA: whether the video is made for kids. Required, and must be the user's explicit choice.",
"type": "boolean"
},
"title": {
"description": "Video title.",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"visibility": {
"description": "Video visibility.",
"enum": [
"public",
"private",
"unlisted"
],
"type": "string"
}
},
"type": "object"
}
]
}
}
}
},
{
"if": {
"properties": {
"platform": {
"enum": [
"facebook"
]
}
},
"required": [
"platform"
]
},
"then": {
"properties": {
"platformSpecificData": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"description": "",
"properties": {
"contentType": {
"description": "story or reel; omitted is a feed post.",
"enum": [
"story",
"reel"
],
"type": "string"
},
"firstComment": {
"description": "First comment added after publishing (not on stories).",
"maxLength": 8000,
"minLength": 1,
"type": "string"
},
"pageId": {
"description": "Page to post to when the account manages several.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"type": "object"
}
]
}
}
}
},
{
"if": {
"properties": {
"platform": {
"enum": [
"linkedin"
]
}
},
"required": [
"platform"
]
},
"then": {
"properties": {
"platformSpecificData": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"description": "linkedin accepts no platformSpecificData yet.",
"properties": {},
"type": "object"
}
]
}
}
}
},
{
"if": {
"properties": {
"platform": {
"enum": [
"pinterest"
]
}
},
"required": [
"platform"
]
},
"then": {
"properties": {
"platformSpecificData": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"description": "",
"properties": {
"isAiGenerated": {
"description": "Label the Pin as AI modified.",
"type": "boolean"
}
},
"type": "object"
}
]
}
}
}
},
{
"if": {
"properties": {
"platform": {
"enum": [
"threads"
]
}
},
"required": [
"platform"
]
},
"then": {
"properties": {
"platformSpecificData": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"description": "threads accepts no platformSpecificData yet.",
"properties": {},
"type": "object"
}
]
}
}
}
},
{
"if": {
"properties": {
"platform": {
"enum": [
"reddit"
]
}
},
"required": [
"platform"
]
},
"then": {
"properties": {
"platformSpecificData": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"description": "reddit accepts no platformSpecificData yet.",
"properties": {},
"type": "object"
}
]
}
}
}
}
],
"properties": {
"accountId": {
"pattern": "^acc_[0-9A-Za-z]{22}$",
"type": [
"string",
"null"
]
},
"customContent": {
"type": [
"string",
"null"
]
},
"customMedia": {
"items": {
"additionalProperties": false,
"properties": {
"altText": {
"type": [
"string",
"null"
]
},
"mediaId": {
"pattern": "^med_[0-9A-Za-z]{22}$",
"type": [
"string",
"null"
]
},
"thumbnailUrl": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"type": [
"array",
"null"
]
},
"platform": {
"enum": [
"tiktok",
"instagram",
"twitter",
"youtube",
"facebook",
"linkedin",
"pinterest",
"threads",
"reddit",
"x",
null
],
"type": [
"string",
"null"
]
},
"platformSpecificData": {
"additionalProperties": {},
"description": "Platform options, checked against the platform registry: unknown fields are rejected with unknown_field. The accepted fields depend on platform; fields required to schedule or publish are named in each description.",
"type": [
"object",
"null"
]
},
"scheduledFor": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"type": [
"array",
"null"
]
},
"profileId": {
"pattern": "^prf_[0-9A-Za-z]{22}$",
"type": [
"string",
"null"
]
},
"publishNow": {
"type": [
"boolean",
"null"
]
},
"scheduledFor": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
}
},
"type": "object"
}
}
},
"required": true
},
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"description": "Each platform target that publishes successfully is metered once under social.post.published:<platform>, including after retries. Not charged in the current period.",
"kind": "metered_event",
"meter": "social.post.published"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Strongly recommended. Reusing a key within 24 hours returns the original result; a different body returns 409 idempotency_key_reused. Without a key the server derives one from the body in 10-minute buckets and echoes it in the response header.
Required string length:
1 - 191Body
application/json
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Pattern:
^prf_[0-9A-Za-z]{22}$Response
Success
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Pattern:
^prf_[0-9A-Za-z]{22}$