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 -->
当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。
<!-- 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>"
}
}请求规范
- 方法与路径: POST /apis/v1/social/posts
- 可用状态: enabled
- 请求 URL 模板:
https://api.aisa.one/apis/v1/social/posts - Idempotency-Key: header; 可选
- Runtime 事实版本: 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"
}
}
}
}
费用与请求规则
当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求头
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 - 191请求体
application/json
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Pattern:
^prf_[0-9A-Za-z]{22}$响应
Success
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Pattern:
^prf_[0-9A-Za-z]{22}$