Saltar al contenido principal
POST
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

post
string
requerido
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.
platforms
array
requerido
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.
mediaUrls
array
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.
isVideo
boolean
predeterminado:false
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.
scheduleDate
string
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.
validateScheduled
boolean
predeterminado:true
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.
firstComment
object
Añade automáticamente un primer comentario tras publicar. Consulta primer comentario para más detalles.
disableComments
boolean
predeterminado:false
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.
autoSchedule
object
Consulta auto-schedule para más detalles.
autoRepost
object
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.
autoHashtag
object
Consulta auto hashtags para más detalles.
unsplash
string
Consulta unsplash para más detalles.
blueskyOptions
object
Consulta los detalles de Bluesky.
faceBookOptions
object
Consulta los detalles de Facebook.
gmbOptions
object
instagramOptions
object
Consulta los detalles de Instagram.
linkedInOptions
object
Consulta los detalles de LinkedIn.
pinterestOptions
object
Consulta los detalles de Pinterest.
redditOptions
object
Consulta los detalles de Reddit.
snapChatOptions
object
Consulta los detalles de Snapchat.
telegramOptions
object
Consulta los detalles de Telegram.
threadsOptions
object
Consulta los detalles de Threads.
tikTokOptions
object
Consulta los detalles de TikTok.
twitterOptions
object
Consulta los detalles de X/Twitter.
youTubeOptions
object
Consulta los detalles de YouTube.
requiresApproval
boolean
predeterminado:false
Consulta flujo de aprobación para más detalles.
randomPost
boolean
predeterminado:false
Genera texto aleatorio para pruebas. randomPost: true ignorará el campo post.
randomMediaUrl
boolean
predeterminado:false
Genera una imagen aleatoria para pruebas. randomMediaUrl: true ignorará el campo mediaUrls.
idempotencyKey
string
Un ID único opcional asociado a la publicación. Los IDs duplicados se rechazarán. Consulta idempotencia para más detalles.
notes
string
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.