curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"post": "Today is a great day!",
"platforms": ["twitter", "facebook", "instagram", "linkedin"],
"mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"]
}' \
-X POST https://api.ayrshare.com/api/post
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/post", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": `Bearer ${API_KEY}`
},
body: JSON.stringify({
post: "Today is a great day!", // required
platforms: ["bluesky", "facebook", "instagram", "linkedin", "twitter"], // required
mediaUrls: ["https://img.ayrshare.com/012/gb.jpg"] //optional
}),
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
payload = {'post': 'Today is a great day!',
'platforms': ['bluesky', 'facebook', 'instagram', 'linkedin', 'twitter'],
'mediaUrls': ['https://img.ayrshare.com/012/gb.jpg']}
headers = {'Content-Type': 'application/json',
'Authorization': 'Bearer API_KEY'}
r = requests.post('https://api.ayrshare.com/api/post',
json=payload,
headers=headers)
print(r.json())
<?php
$curl = curl_init();
$data = [
"post" => "Today is a great day!",
"platforms" => ["bluesky", "facebook", "instagram", "linkedin", "pinterest", "twitter"],
"mediaUrls" => ["https://img.ayrshare.com/012/gb.jpg"]
];
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.ayrshare.com/api/post',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($data),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer API_KEY', // Replace 'API_KEY' with your actual API key
'Content-Type: application/json'
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
package main
import (
"bytes"
"encoding/json"
"log"
"net/http"
)
func main() {
message := map[string]interface{}{
"post": "Today is a great day!",
"platforms": []string{"bluesky", "facebook", "instagram", "linkedin", "twitter"},
"mediaUrls": []string{"https://img.ayrshare.com/012/gb.jpg"}
}
bytesRepresentation, err := json.Marshal(message)
if err != nil {
log.Fatalln(err)
}
req, _ := http.NewRequest("POST", "https://api.ayrshare.com/api/post",
bytes.NewBuffer(bytesRepresentation))
req.Header.Add("Content-Type", "application/json; charset=UTF-8")
req.Header.Add("Authorization", "Bearer API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal("Error:", err)
}
res.Body.Close()
}
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
namespace PostPOSTRequest_csharp
{
class Post
{
private static readonly HttpClient client = new HttpClient();
static async Task Main(string[] args)
{
string API_KEY = "API_KEY";
string url = "https://api.ayrshare.com/api/post";
// Set up request headers
client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
// Prepare JSON content
string json = "{\"post\" : \"Today is a great day!\","
+ "\"platforms\" : [ \"bluesky\", \"facebook\", \"instagram\", \"linkedin\", \"twitter\" ],"
+ "\"mediaUrls\" : [ \"https://img.ayrshare.com/012/gb.jpg\" ]}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
try
{
// Send POST request
HttpResponseMessage response = await client.PostAsync(url, content);
response.EnsureSuccessStatusCode();
// Read response
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseBody);
}
catch (HttpRequestException e)
{
Console.WriteLine($"Error: {e.Message}");
}
}
}
}
require 'httparty' # gem install httparty
res = HTTParty.post("https://api.ayrshare.com/api/post",
headers: {Authorization: "Bearer API_KEY"},
body: {
post: "Today is a great day!",
platforms: ['bluesky', 'facebook', 'instagram', 'linkedin', 'twitter'],
mediaUrls: ["https://img.ayrshare.com/012/gb.jpg"]
}).body
puts res
{
"status": "success",
"errors": [],
"postIds": [
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/bluesky
"status": "success",
"id": "at://did:plc:n7atrjd22xgkmgwig6dzlhzd/app.bsky.feed.post/3lez7fwx452", // Bluesky Social Post ID
"cid": "bafyreie6n475cd3ynr6sfacvohu5qgjibcooxnug6zcbghkwnrwi5stafy", // Bluesky Content ID
"postUrl": "https://bsky.app/profile/madworlds.bsky.social/post/3lez7fwx4572",
"platform": "bluesky"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/facebook
"status": "success",
"id": "104923907983682_108329000309742", // Facebook Social Post ID
"platform": "facebook",
"postUrl": "https://www.facebook.com/104923907983682_108329000309742",
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/google
"status": "success",
"id": "3837985438581442258", // Google Business Profile Social Post ID
"postUrl": "https://local.google.com/place?id=5229466225881728772&use=posts&lpsid=CM",
"type": "localPosts",
"platform": "gmb"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/instagram
"status": "success",
"platform": "instagram", // Instagram Social Post ID
"id": "17878176260289172",
"postUrl": "https://www.instagram.com/p/CP1dI9Hp_WO/",
"usedQuota": 12,
"contentIssues": { // Optional — only present when Ayrshare detected and resolved a content issue
"originMediaHostFailed": true,
"details": ["Media URL could not be retrieved by the social network. Successfully posted using Ayrshare automated media protection."]
}
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/linkedin
"status": "success",
"id": "urn:li:share:7282181682126807041", // LinkedIn Social Post ID
"postUrl": "https://www.linkedin.com/feed/update/urn:li:share:7282181682126807041",
"owner": "urn:li:organization:77682157",
"platform": "linkedin"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/pinterest
"status": "success",
"id": "42995371460659062", // Pinterest Social Post ID
"postUrl": "https://www.pinterest.com/pin/429953714606062/",
"platform": "pinterest"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/reddit
"status": "success",
"id": "1hvdvof", // Reddit Social Post ID
"postUrl": "https://www.reddit.com/r/test/comments/1hvdvof/reddit_post_title/",
"platform": "reddit"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/snapchat
"status": "success",
"id": "921ed204-e123-5b08-a9ce-zx489f1f38c5", // Snapchat Social Post ID
"mediaId": "V6noC6UOQgOcABCDEgFZEwAAgd3F0cnp1eWtxZAb9PsH-MXb9PsIWAAAAAA", // Snapchat Media ID
"postUrl": "https://www.snapchat.com/add/samsmith1920/921ed204-e123-5b08-a9ce-zx489f1f38c5",
"type": "stories",
"ended": "2025-05-23T13:04:30.545Z",
"platform": "snapchat"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/telegram
"status": "success",
"id": 635, // Telegram Social Post ID
"postUrl": "https://t.me/c/1424847122/635",
"platform": "telegram"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/tiktok
"status": "success",
"idShare": "v_pub_url~v2.7456954878846683182",
"id": "pending", // TikTok Social Post ID - see https://www.ayrshare.com/docs/apis/post/social-networks/tiktok
"isVideo": true,
"platform": "tiktok"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/twitter
"status": "success",
"id": "1288899996423983105", // X/Twitter Social Post ID
"platform": "twitter",
"postUrl": "https://x.com/handle/status/1288899996423983105"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/youtube
"status": "success",
"id": "3oQeP-kTsbo", // YouTube Social Post ID
"postUrl": "https://youtu.be/3oQeP-kTo",
"platform": "youtube"
}
],
"id": "RhrbDtYh7hdSMc67zC8H" // Ayrshare Post ID used for delete, analytics, comments, etc.
}
{
"status": "scheduled",
"scheduleDate": "2023-04-01T10:04:12Z",
"id": "IUiaqFkQP96UJJXYjRpv", // Ayrshare Post ID used for delete, comment, analytics, etc.
"refId": "9abf1426d6ce9122effdeeddfdfdfd",
"post": "Genius is eternal patience. - Michelangelo"
}
{
"status": "success",
"posts": [
{
"status": "success",
"errors": [],
"postIds": [
{
"status": "success",
"id": "1869166036466991888",
"postUrl": "https://twitter.com/wondrouswaffles/status/1869",
"platform": "twitter"
},
{
"status": "success",
"id": "106638148652344_601623445855888",
"postUrl": "https://www.facebook.com/106638148652329/posts/6016",
"platform": "facebook"
}
],
"id": "bVQotNtxgXAUmLtqmw2",
"refId": "b68bdcabb379be2cf1186c1e595449804b232sa",
"profileTitle": "The Best Profile",
"post": "Formal education will make you a living. Self education will make you a fortune. - Jim Rohn"
}
]
}
{
"status": "success",
"posts": [
{
"status": "scheduled",
"scheduleDate": "2023-04-01T10:04:12Z",
"id": "qvu8gysraodz2WFZgRX7", // Ayrshare Post ID used for delete, comment, analytics, etc.
"refId": "9abf1426d6ce9122effdeeddfdfdfd",
"profileTitle": "Best Profile",
"post": "I never thought of myself as being handsome or good-looking or whatever. I always felt like an outsider. - Elton John"
}
]
}
{
"status": "error",
"errors": [
{
"action": "post",
"status": "error",
"code": 156,
"message": "Youtube does not seem to be linked with Ayrshare. Please confirm the linkage on the Social Accounts page in your dashboard. .../ayrshare.com/additional-info/troubleshooting",
"platform": "youtube"
},
{
"action": "post",
"status": "error",
"code": 110,
"message": "Status is a duplicate.",
"post": "Today is a great day",
"platform": "twitter"
}
],
"postIds": [],
"id": "0OGBzZssN5hxy8dMSRaD" // Ayrshare Post ID used for delete, comment, analytics, etc.
}
{
"status": "error",
"posts": [
{
"status": "error",
"errors": [
{
"action": "post",
"status": "error",
"code": 156,
"message": "Instagram is not linked.
Please confirm the linkage on the Social Accounts page in the dashboard. https://www.ayrshare.com/docs/help-center/overview",
"platform": "instagram"
}
],
"postIds": [],
"id": "ekftQJ0hFB1Fx6bnM33",
"refId": "9abf1426d6ce9122effdeeddfdfdfd",
"profileTitle": "Best Profile",
"post": "The most common way people give up their power is by thinking they don't have any. - Alice Walker"
}
]
}
{
"status": "error",
"errors": [
{
"action": "post",
"status": "error",
"code": 107,
"message": "Facebook Error: This status update is identical to the last one you posted. Try posting something different, or delete your previous update.",
"platform": "facebook"
}
],
"postIds": [],
"id": "6APU4qqI7XO7JM3BOy6B" // Ayrshare Post ID used for delete, comment, analytics, etc.
}
Post
API para publicar posts: publica en cualquier red social | Ayrshare Docs
Publica en Facebook, Instagram, X, LinkedIn, TikTok, YouTube y más con una sola llamada a la API de Ayrshare. Consulta parámetros, ejemplos de código y medios admitidos.
POST
/
post
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"post": "Today is a great day!",
"platforms": ["twitter", "facebook", "instagram", "linkedin"],
"mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"]
}' \
-X POST https://api.ayrshare.com/api/post
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/post", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": `Bearer ${API_KEY}`
},
body: JSON.stringify({
post: "Today is a great day!", // required
platforms: ["bluesky", "facebook", "instagram", "linkedin", "twitter"], // required
mediaUrls: ["https://img.ayrshare.com/012/gb.jpg"] //optional
}),
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
payload = {'post': 'Today is a great day!',
'platforms': ['bluesky', 'facebook', 'instagram', 'linkedin', 'twitter'],
'mediaUrls': ['https://img.ayrshare.com/012/gb.jpg']}
headers = {'Content-Type': 'application/json',
'Authorization': 'Bearer API_KEY'}
r = requests.post('https://api.ayrshare.com/api/post',
json=payload,
headers=headers)
print(r.json())
<?php
$curl = curl_init();
$data = [
"post" => "Today is a great day!",
"platforms" => ["bluesky", "facebook", "instagram", "linkedin", "pinterest", "twitter"],
"mediaUrls" => ["https://img.ayrshare.com/012/gb.jpg"]
];
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.ayrshare.com/api/post',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($data),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer API_KEY', // Replace 'API_KEY' with your actual API key
'Content-Type: application/json'
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
package main
import (
"bytes"
"encoding/json"
"log"
"net/http"
)
func main() {
message := map[string]interface{}{
"post": "Today is a great day!",
"platforms": []string{"bluesky", "facebook", "instagram", "linkedin", "twitter"},
"mediaUrls": []string{"https://img.ayrshare.com/012/gb.jpg"}
}
bytesRepresentation, err := json.Marshal(message)
if err != nil {
log.Fatalln(err)
}
req, _ := http.NewRequest("POST", "https://api.ayrshare.com/api/post",
bytes.NewBuffer(bytesRepresentation))
req.Header.Add("Content-Type", "application/json; charset=UTF-8")
req.Header.Add("Authorization", "Bearer API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal("Error:", err)
}
res.Body.Close()
}
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
namespace PostPOSTRequest_csharp
{
class Post
{
private static readonly HttpClient client = new HttpClient();
static async Task Main(string[] args)
{
string API_KEY = "API_KEY";
string url = "https://api.ayrshare.com/api/post";
// Set up request headers
client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
// Prepare JSON content
string json = "{\"post\" : \"Today is a great day!\","
+ "\"platforms\" : [ \"bluesky\", \"facebook\", \"instagram\", \"linkedin\", \"twitter\" ],"
+ "\"mediaUrls\" : [ \"https://img.ayrshare.com/012/gb.jpg\" ]}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
try
{
// Send POST request
HttpResponseMessage response = await client.PostAsync(url, content);
response.EnsureSuccessStatusCode();
// Read response
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseBody);
}
catch (HttpRequestException e)
{
Console.WriteLine($"Error: {e.Message}");
}
}
}
}
require 'httparty' # gem install httparty
res = HTTParty.post("https://api.ayrshare.com/api/post",
headers: {Authorization: "Bearer API_KEY"},
body: {
post: "Today is a great day!",
platforms: ['bluesky', 'facebook', 'instagram', 'linkedin', 'twitter'],
mediaUrls: ["https://img.ayrshare.com/012/gb.jpg"]
}).body
puts res
{
"status": "success",
"errors": [],
"postIds": [
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/bluesky
"status": "success",
"id": "at://did:plc:n7atrjd22xgkmgwig6dzlhzd/app.bsky.feed.post/3lez7fwx452", // Bluesky Social Post ID
"cid": "bafyreie6n475cd3ynr6sfacvohu5qgjibcooxnug6zcbghkwnrwi5stafy", // Bluesky Content ID
"postUrl": "https://bsky.app/profile/madworlds.bsky.social/post/3lez7fwx4572",
"platform": "bluesky"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/facebook
"status": "success",
"id": "104923907983682_108329000309742", // Facebook Social Post ID
"platform": "facebook",
"postUrl": "https://www.facebook.com/104923907983682_108329000309742",
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/google
"status": "success",
"id": "3837985438581442258", // Google Business Profile Social Post ID
"postUrl": "https://local.google.com/place?id=5229466225881728772&use=posts&lpsid=CM",
"type": "localPosts",
"platform": "gmb"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/instagram
"status": "success",
"platform": "instagram", // Instagram Social Post ID
"id": "17878176260289172",
"postUrl": "https://www.instagram.com/p/CP1dI9Hp_WO/",
"usedQuota": 12,
"contentIssues": { // Optional — only present when Ayrshare detected and resolved a content issue
"originMediaHostFailed": true,
"details": ["Media URL could not be retrieved by the social network. Successfully posted using Ayrshare automated media protection."]
}
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/linkedin
"status": "success",
"id": "urn:li:share:7282181682126807041", // LinkedIn Social Post ID
"postUrl": "https://www.linkedin.com/feed/update/urn:li:share:7282181682126807041",
"owner": "urn:li:organization:77682157",
"platform": "linkedin"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/pinterest
"status": "success",
"id": "42995371460659062", // Pinterest Social Post ID
"postUrl": "https://www.pinterest.com/pin/429953714606062/",
"platform": "pinterest"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/reddit
"status": "success",
"id": "1hvdvof", // Reddit Social Post ID
"postUrl": "https://www.reddit.com/r/test/comments/1hvdvof/reddit_post_title/",
"platform": "reddit"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/snapchat
"status": "success",
"id": "921ed204-e123-5b08-a9ce-zx489f1f38c5", // Snapchat Social Post ID
"mediaId": "V6noC6UOQgOcABCDEgFZEwAAgd3F0cnp1eWtxZAb9PsH-MXb9PsIWAAAAAA", // Snapchat Media ID
"postUrl": "https://www.snapchat.com/add/samsmith1920/921ed204-e123-5b08-a9ce-zx489f1f38c5",
"type": "stories",
"ended": "2025-05-23T13:04:30.545Z",
"platform": "snapchat"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/telegram
"status": "success",
"id": 635, // Telegram Social Post ID
"postUrl": "https://t.me/c/1424847122/635",
"platform": "telegram"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/tiktok
"status": "success",
"idShare": "v_pub_url~v2.7456954878846683182",
"id": "pending", // TikTok Social Post ID - see https://www.ayrshare.com/docs/apis/post/social-networks/tiktok
"isVideo": true,
"platform": "tiktok"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/twitter
"status": "success",
"id": "1288899996423983105", // X/Twitter Social Post ID
"platform": "twitter",
"postUrl": "https://x.com/handle/status/1288899996423983105"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/youtube
"status": "success",
"id": "3oQeP-kTsbo", // YouTube Social Post ID
"postUrl": "https://youtu.be/3oQeP-kTo",
"platform": "youtube"
}
],
"id": "RhrbDtYh7hdSMc67zC8H" // Ayrshare Post ID used for delete, analytics, comments, etc.
}
{
"status": "scheduled",
"scheduleDate": "2023-04-01T10:04:12Z",
"id": "IUiaqFkQP96UJJXYjRpv", // Ayrshare Post ID used for delete, comment, analytics, etc.
"refId": "9abf1426d6ce9122effdeeddfdfdfd",
"post": "Genius is eternal patience. - Michelangelo"
}
{
"status": "success",
"posts": [
{
"status": "success",
"errors": [],
"postIds": [
{
"status": "success",
"id": "1869166036466991888",
"postUrl": "https://twitter.com/wondrouswaffles/status/1869",
"platform": "twitter"
},
{
"status": "success",
"id": "106638148652344_601623445855888",
"postUrl": "https://www.facebook.com/106638148652329/posts/6016",
"platform": "facebook"
}
],
"id": "bVQotNtxgXAUmLtqmw2",
"refId": "b68bdcabb379be2cf1186c1e595449804b232sa",
"profileTitle": "The Best Profile",
"post": "Formal education will make you a living. Self education will make you a fortune. - Jim Rohn"
}
]
}
{
"status": "success",
"posts": [
{
"status": "scheduled",
"scheduleDate": "2023-04-01T10:04:12Z",
"id": "qvu8gysraodz2WFZgRX7", // Ayrshare Post ID used for delete, comment, analytics, etc.
"refId": "9abf1426d6ce9122effdeeddfdfdfd",
"profileTitle": "Best Profile",
"post": "I never thought of myself as being handsome or good-looking or whatever. I always felt like an outsider. - Elton John"
}
]
}
{
"status": "error",
"errors": [
{
"action": "post",
"status": "error",
"code": 156,
"message": "Youtube does not seem to be linked with Ayrshare. Please confirm the linkage on the Social Accounts page in your dashboard. .../ayrshare.com/additional-info/troubleshooting",
"platform": "youtube"
},
{
"action": "post",
"status": "error",
"code": 110,
"message": "Status is a duplicate.",
"post": "Today is a great day",
"platform": "twitter"
}
],
"postIds": [],
"id": "0OGBzZssN5hxy8dMSRaD" // Ayrshare Post ID used for delete, comment, analytics, etc.
}
{
"status": "error",
"posts": [
{
"status": "error",
"errors": [
{
"action": "post",
"status": "error",
"code": 156,
"message": "Instagram is not linked.
Please confirm the linkage on the Social Accounts page in the dashboard. https://www.ayrshare.com/docs/help-center/overview",
"platform": "instagram"
}
],
"postIds": [],
"id": "ekftQJ0hFB1Fx6bnM33",
"refId": "9abf1426d6ce9122effdeeddfdfdfd",
"profileTitle": "Best Profile",
"post": "The most common way people give up their power is by thinking they don't have any. - Alice Walker"
}
]
}
{
"status": "error",
"errors": [
{
"action": "post",
"status": "error",
"code": 107,
"message": "Facebook Error: This status update is identical to the last one you posted. Try posting something different, or delete your previous update.",
"platform": "facebook"
}
],
"postIds": [],
"id": "6APU4qqI7XO7JM3BOy6B" // Ayrshare Post ID used for delete, comment, analytics, etc.
}
Publica en las redes sociales que tú o tus usuarios hayáis vinculado.
Si quieres publicar en User Profiles, consulta el endpoint /profiles para más detalles.
Asegúrate de añadir tu
API_KEY, y la PROFILE_KEY si publicas en un User Profile, en la cabecera Authorization.
El API Key se encuentra en el Ayrshare Developer Dashboard, en la página API Key.
Consulta la descripción general de la Post API para más detalles sobre las opciones de publicación.
Parámetros de cabecera
Parámetros del cuerpo
El texto de la publicación enviado a las redes sociales indicadas en el parámetro platforms.
Consulta opciones avanzadas, incluida la forma de incluir URLs y texto enriquecido.Puedes enviar una cadena vacía
"" para publicar sin texto.Plataformas de redes sociales en las que publicar. Acepta un array de Strings con los valores:
bluesky, facebook, gmb, instagram, linkedin, pinterest, reddit, snapchat, telegram, threads, tiktok, twitter o youtube.Nota: usa facebook para las Facebook Pages y gmb para Google Business Profile.Usa all para publicar en todas las redes sociales vinculadas. Incluye también los campos obligatorios para todas las redes.
Por ejemplo, title debe incluirse en youTubeOptions si youtube está vinculado.Un array de URLs de imagen o video a incluir en la publicación. Consulta el endpoint /media para más información.Las URLs deben ser seguras y comenzar con
https://. Si la URL contiene caracteres especiales, p. ej. ñ, codifícalos antes de enviarla.Los videos requieren un plan de pago.Consulta requisitos de imagen y video y otras opciones avanzadas.Ayrshare intentará determinar el tipo de medio basándose en la extensión del archivo en la URL (.mp4). Puedes indicar explícitamente que el medio es un video si la URL no termina en una extensión de video conocida, como los GIFs animados.Consulta extensión de video para más detalles.
Fecha y hora para programar una publicación futura. Acepta una fecha y hora UTC.Por ejemplo, usa el formato
YYYY-MM-DDThh:mm:ssZ y envíalo como 2026-07-08T12:30:00Z.
Consulta utctime para ver más ejemplos.Consulta también publicaciones programadas para más detalles.Por defecto, las publicaciones programadas se verifican (prevalidan) para detectar problemas como los requisitos de medios antes de aceptarse.
Si Ayrshare detecta algún problema durante estas comprobaciones, recibirás una respuesta de error inmediata y la publicación no se programará.
Cuando se alcance la fecha programada, la publicación se publicará y en ese momento se enviará la respuesta final de éxito o error vía webhook o a través del endpoint /history.Para omitir esta prevalidación, establece
validateScheduled a false.Recomendamos mantener la validación habilitada en las publicaciones programadas para detectar errores lo antes posible.
De lo contrario, la publicación se programará y solo recibirás un error cuando se publique.Consulta las acciones de webhook programadas para más detalles.Añade automáticamente un primer comentario tras publicar. Consulta primer comentario para más detalles.
Desactiva los comentarios en la publicación. Solo disponible para Instagram, LinkedIn y TikTok.
Acorta los enlaces de la publicación en todas las plataformas usando el acortador de enlaces de Ayrshare.Solo se acortarán las URLs que comiencen con https.Requiere Max Pack para el acortamiento de enlaces.Consulta cómo usar acortadores de enlaces de terceros.
Consulta auto-schedule para más detalles.
Vuelve a publicar automáticamente tu contenido varias veces a intervalos regulares, creando contenido evergreen que se mantiene fresco y visible para tu audiencia.Consulta auto repost para más detalles.
Consulta auto hashtags para más detalles.
Consulta los detalles de Bluesky.
Consulta los detalles de Facebook.
Consulta los detalles de Google Business Profile.
Consulta los detalles de Instagram.
Consulta los detalles de LinkedIn.
Consulta los detalles de Pinterest.
Consulta los detalles de Reddit.
Consulta los detalles de Snapchat.
Consulta los detalles de Telegram.
Consulta los detalles de Threads.
Consulta los detalles de TikTok.
Consulta los detalles de X/Twitter.
Consulta los detalles de YouTube.
Consulta flujo de aprobación para más detalles.
Genera texto aleatorio para pruebas.
randomPost: true ignorará el campo post.Genera una imagen aleatoria para pruebas.
randomMediaUrl: true ignorará el campo mediaUrls.Un ID único opcional asociado a la publicación. Los IDs duplicados se rechazarán. Consulta idempotencia para más detalles.
Establece notas en una publicación que pueden recuperarse mediante el endpoint /history. Las notas son solo de referencia y no afectan a la publicación.
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"post": "Today is a great day!",
"platforms": ["twitter", "facebook", "instagram", "linkedin"],
"mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"]
}' \
-X POST https://api.ayrshare.com/api/post
const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/post", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": `Bearer ${API_KEY}`
},
body: JSON.stringify({
post: "Today is a great day!", // required
platforms: ["bluesky", "facebook", "instagram", "linkedin", "twitter"], // required
mediaUrls: ["https://img.ayrshare.com/012/gb.jpg"] //optional
}),
})
.then((res) => res.json())
.then((json) => console.log(json))
.catch(console.error);
import requests
payload = {'post': 'Today is a great day!',
'platforms': ['bluesky', 'facebook', 'instagram', 'linkedin', 'twitter'],
'mediaUrls': ['https://img.ayrshare.com/012/gb.jpg']}
headers = {'Content-Type': 'application/json',
'Authorization': 'Bearer API_KEY'}
r = requests.post('https://api.ayrshare.com/api/post',
json=payload,
headers=headers)
print(r.json())
<?php
$curl = curl_init();
$data = [
"post" => "Today is a great day!",
"platforms" => ["bluesky", "facebook", "instagram", "linkedin", "pinterest", "twitter"],
"mediaUrls" => ["https://img.ayrshare.com/012/gb.jpg"]
];
curl_setopt_array($curl, [
CURLOPT_URL => 'https://api.ayrshare.com/api/post',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($data),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer API_KEY', // Replace 'API_KEY' with your actual API key
'Content-Type: application/json'
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
package main
import (
"bytes"
"encoding/json"
"log"
"net/http"
)
func main() {
message := map[string]interface{}{
"post": "Today is a great day!",
"platforms": []string{"bluesky", "facebook", "instagram", "linkedin", "twitter"},
"mediaUrls": []string{"https://img.ayrshare.com/012/gb.jpg"}
}
bytesRepresentation, err := json.Marshal(message)
if err != nil {
log.Fatalln(err)
}
req, _ := http.NewRequest("POST", "https://api.ayrshare.com/api/post",
bytes.NewBuffer(bytesRepresentation))
req.Header.Add("Content-Type", "application/json; charset=UTF-8")
req.Header.Add("Authorization", "Bearer API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal("Error:", err)
}
res.Body.Close()
}
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
namespace PostPOSTRequest_csharp
{
class Post
{
private static readonly HttpClient client = new HttpClient();
static async Task Main(string[] args)
{
string API_KEY = "API_KEY";
string url = "https://api.ayrshare.com/api/post";
// Set up request headers
client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
// Prepare JSON content
string json = "{\"post\" : \"Today is a great day!\","
+ "\"platforms\" : [ \"bluesky\", \"facebook\", \"instagram\", \"linkedin\", \"twitter\" ],"
+ "\"mediaUrls\" : [ \"https://img.ayrshare.com/012/gb.jpg\" ]}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
try
{
// Send POST request
HttpResponseMessage response = await client.PostAsync(url, content);
response.EnsureSuccessStatusCode();
// Read response
string responseBody = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseBody);
}
catch (HttpRequestException e)
{
Console.WriteLine($"Error: {e.Message}");
}
}
}
}
require 'httparty' # gem install httparty
res = HTTParty.post("https://api.ayrshare.com/api/post",
headers: {Authorization: "Bearer API_KEY"},
body: {
post: "Today is a great day!",
platforms: ['bluesky', 'facebook', 'instagram', 'linkedin', 'twitter'],
mediaUrls: ["https://img.ayrshare.com/012/gb.jpg"]
}).body
puts res
{
"status": "success",
"errors": [],
"postIds": [
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/bluesky
"status": "success",
"id": "at://did:plc:n7atrjd22xgkmgwig6dzlhzd/app.bsky.feed.post/3lez7fwx452", // Bluesky Social Post ID
"cid": "bafyreie6n475cd3ynr6sfacvohu5qgjibcooxnug6zcbghkwnrwi5stafy", // Bluesky Content ID
"postUrl": "https://bsky.app/profile/madworlds.bsky.social/post/3lez7fwx4572",
"platform": "bluesky"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/facebook
"status": "success",
"id": "104923907983682_108329000309742", // Facebook Social Post ID
"platform": "facebook",
"postUrl": "https://www.facebook.com/104923907983682_108329000309742",
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/google
"status": "success",
"id": "3837985438581442258", // Google Business Profile Social Post ID
"postUrl": "https://local.google.com/place?id=5229466225881728772&use=posts&lpsid=CM",
"type": "localPosts",
"platform": "gmb"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/instagram
"status": "success",
"platform": "instagram", // Instagram Social Post ID
"id": "17878176260289172",
"postUrl": "https://www.instagram.com/p/CP1dI9Hp_WO/",
"usedQuota": 12,
"contentIssues": { // Optional — only present when Ayrshare detected and resolved a content issue
"originMediaHostFailed": true,
"details": ["Media URL could not be retrieved by the social network. Successfully posted using Ayrshare automated media protection."]
}
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/linkedin
"status": "success",
"id": "urn:li:share:7282181682126807041", // LinkedIn Social Post ID
"postUrl": "https://www.linkedin.com/feed/update/urn:li:share:7282181682126807041",
"owner": "urn:li:organization:77682157",
"platform": "linkedin"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/pinterest
"status": "success",
"id": "42995371460659062", // Pinterest Social Post ID
"postUrl": "https://www.pinterest.com/pin/429953714606062/",
"platform": "pinterest"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/reddit
"status": "success",
"id": "1hvdvof", // Reddit Social Post ID
"postUrl": "https://www.reddit.com/r/test/comments/1hvdvof/reddit_post_title/",
"platform": "reddit"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/snapchat
"status": "success",
"id": "921ed204-e123-5b08-a9ce-zx489f1f38c5", // Snapchat Social Post ID
"mediaId": "V6noC6UOQgOcABCDEgFZEwAAgd3F0cnp1eWtxZAb9PsH-MXb9PsIWAAAAAA", // Snapchat Media ID
"postUrl": "https://www.snapchat.com/add/samsmith1920/921ed204-e123-5b08-a9ce-zx489f1f38c5",
"type": "stories",
"ended": "2025-05-23T13:04:30.545Z",
"platform": "snapchat"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/telegram
"status": "success",
"id": 635, // Telegram Social Post ID
"postUrl": "https://t.me/c/1424847122/635",
"platform": "telegram"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/tiktok
"status": "success",
"idShare": "v_pub_url~v2.7456954878846683182",
"id": "pending", // TikTok Social Post ID - see https://www.ayrshare.com/docs/apis/post/social-networks/tiktok
"isVideo": true,
"platform": "tiktok"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/twitter
"status": "success",
"id": "1288899996423983105", // X/Twitter Social Post ID
"platform": "twitter",
"postUrl": "https://x.com/handle/status/1288899996423983105"
},
{
// Details at https://www.ayrshare.com/docs/apis/post/social-networks/youtube
"status": "success",
"id": "3oQeP-kTsbo", // YouTube Social Post ID
"postUrl": "https://youtu.be/3oQeP-kTo",
"platform": "youtube"
}
],
"id": "RhrbDtYh7hdSMc67zC8H" // Ayrshare Post ID used for delete, analytics, comments, etc.
}
{
"status": "scheduled",
"scheduleDate": "2023-04-01T10:04:12Z",
"id": "IUiaqFkQP96UJJXYjRpv", // Ayrshare Post ID used for delete, comment, analytics, etc.
"refId": "9abf1426d6ce9122effdeeddfdfdfd",
"post": "Genius is eternal patience. - Michelangelo"
}
{
"status": "success",
"posts": [
{
"status": "success",
"errors": [],
"postIds": [
{
"status": "success",
"id": "1869166036466991888",
"postUrl": "https://twitter.com/wondrouswaffles/status/1869",
"platform": "twitter"
},
{
"status": "success",
"id": "106638148652344_601623445855888",
"postUrl": "https://www.facebook.com/106638148652329/posts/6016",
"platform": "facebook"
}
],
"id": "bVQotNtxgXAUmLtqmw2",
"refId": "b68bdcabb379be2cf1186c1e595449804b232sa",
"profileTitle": "The Best Profile",
"post": "Formal education will make you a living. Self education will make you a fortune. - Jim Rohn"
}
]
}
{
"status": "success",
"posts": [
{
"status": "scheduled",
"scheduleDate": "2023-04-01T10:04:12Z",
"id": "qvu8gysraodz2WFZgRX7", // Ayrshare Post ID used for delete, comment, analytics, etc.
"refId": "9abf1426d6ce9122effdeeddfdfdfd",
"profileTitle": "Best Profile",
"post": "I never thought of myself as being handsome or good-looking or whatever. I always felt like an outsider. - Elton John"
}
]
}
{
"status": "error",
"errors": [
{
"action": "post",
"status": "error",
"code": 156,
"message": "Youtube does not seem to be linked with Ayrshare. Please confirm the linkage on the Social Accounts page in your dashboard. .../ayrshare.com/additional-info/troubleshooting",
"platform": "youtube"
},
{
"action": "post",
"status": "error",
"code": 110,
"message": "Status is a duplicate.",
"post": "Today is a great day",
"platform": "twitter"
}
],
"postIds": [],
"id": "0OGBzZssN5hxy8dMSRaD" // Ayrshare Post ID used for delete, comment, analytics, etc.
}
{
"status": "error",
"posts": [
{
"status": "error",
"errors": [
{
"action": "post",
"status": "error",
"code": 156,
"message": "Instagram is not linked.
Please confirm the linkage on the Social Accounts page in the dashboard. https://www.ayrshare.com/docs/help-center/overview",
"platform": "instagram"
}
],
"postIds": [],
"id": "ekftQJ0hFB1Fx6bnM33",
"refId": "9abf1426d6ce9122effdeeddfdfdfd",
"profileTitle": "Best Profile",
"post": "The most common way people give up their power is by thinking they don't have any. - Alice Walker"
}
]
}
{
"status": "error",
"errors": [
{
"action": "post",
"status": "error",
"code": 107,
"message": "Facebook Error: This status update is identical to the last one you posted. Try posting something different, or delete your previous update.",
"platform": "facebook"
}
],
"postIds": [],
"id": "6APU4qqI7XO7JM3BOy6B" // Ayrshare Post ID used for delete, comment, analytics, etc.
}
⌘I
