Descripción general de la API de Ayrshare - Ayrshare API Documentation

La API REST para redes sociales ofrece a los desarrolladores acceso programático a múltiples redes sociales a través de una única interfaz unificada. Mediante la API social de Ayrshare, puedes gestionar actividades en redes sociales como crear y eliminar publicaciones, obtener analíticas, interactuar con comentarios y reseñas, gestionar mensajes directos, crear anuncios en Facebook y realizar otras acciones en redes sociales en varias plataformas. La API admite actualmente 13 grandes redes sociales: Bluesky, Facebook, Google Business Profile, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Telegram, Threads, TikTok, X (antes Twitter) y YouTube. Al integrarte con esta API, puedes automatizar las tareas de gestión de redes sociales en todas estas plataformas de forma simultánea. Los datos de solicitud y respuesta de la API están en formato JSON, lo que facilita su análisis y procesamiento en la mayoría de los lenguajes de programación. Si tienes el Launch Plan, Business Plan o Enterprise Plan, consulta la descripción general del Business Plan, la descripción general del Launch Plan y el endpoint /profiles de la API.

Funcionalidad clave

13 redes sociales admitidas.
Acceso seguro a la API usando tu API Key único.
Publicaciones programadas en las plataformas sociales conectadas.
Publicación automática según programaciones predefinidas.
Soporte para contenido de imagen y video, incluidos Reels, Stories y Spotlight.
Eliminación de publicaciones en las redes sociales vinculadas.
Analíticas completas de interacción con las publicaciones (me gusta, compartidos, etc.).
Métricas de las cuentas sociales, incluyendo número de seguidores y datos demográficos.
Gestión de comentarios: ver, añadir y eliminar comentarios de publicaciones.
Acortamiento de enlaces opcional para todos o para URLs específicas en las publicaciones.
Integración con Unsplash: añadir imágenes concretas o seleccionarlas aleatoriamente según palabras clave.
Opción de generación automática de hashtags a partir de palabras clave relevantes.
Seguimiento del historial de publicaciones, incluidas las que no se hicieron con Ayrshare.
Gestión de reseñas: obtener, responder y eliminar respuestas a reseñas.
Integración con feeds RSS para la publicación automática de contenido.
Biblioteca multimedia: sube y almacena fotos y videos para usar en las publicaciones.
Social Post Verification System para mantener seguras tus cuentas sociales.

Business Plan y Launch Plan

Funciones del Business Plan y del Launch Plan para gestionar múltiples usuarios y clientes:

Permite a los usuarios vincular sus propias cuentas de redes sociales a tu plataforma.
Inicio de sesión único seguro mediante OAuth para vincular cuentas rápidamente.
Crea y elimina perfiles de usuario de forma programática a través de la API.
Accede a analíticas avanzadas de usuarios.
Soporte de webhook para actualizaciones en tiempo real.
Gestión de mensajes directos en las plataformas admitidas.
Crea anuncios de Facebook a partir de publicaciones existentes.

Contáctanos para obtener más información sobre el Business Plan.

Ads API

La Ads API te permite crear anuncios de Facebook a partir de publicaciones existentes.

Impulsa publicaciones para llegar a más personas.
Gestiona anuncios y realiza un seguimiento de su rendimiento.
Analiza el gasto en anuncios y optimiza campañas.

Ads API

Explora la Ads API

Messages API

Una Messaging API unificada para interactuar con los usuarios en conversaciones a través de los principales canales de redes sociales: Facebook, Instagram y X.

Envío de mensajes de texto, imagen y video.
Obtención de historiales completos de conversaciones.
Configuración de respuestas automáticas a mensajes.
Recepción de actualizaciones en tiempo real mediante webhooks para mensajes recibidos, reacciones a mensajes y confirmaciones de lectura.

Esta API simplifica la interacción con los usuarios al centralizar las operaciones de mensajería para múltiples canales de redes sociales. Más información…

Messages API

Explora la API de mensajería unificada

Max Pack

Consigue aún más capacidades con el complemento Max Pack:

Max Pack

Desbloquea funciones avanzadas como generación de contenido con IA, analíticas mejoradas y soporte ampliado de plataformas con nuestro complemento Max Pack.

Si estás desarrollando en Node.js, consulta este video sobre cómo conectar y publicar en X y Facebook.

Si utilizas Node.js, consulta el código de demostración de la API social para empezar a construir tu propia integración.

Social API Demo

Explora nuestro código demo en Node.js para acelerar tu integración con la API social

URL base

La URL base de la API de Ayrshare es la misma para todos los endpoints. https://api.ayrshare.com/api

Autorización

Ayrshare autentica las peticiones a la API mediante un token de Authorization que se pasa en la cabecera HTTP. Asegúrate de enviar Bearer junto con el API Key. El API Key se encuentra en el Dashboard de Ayrshare al cambiar a tu Primary Profile. Si eres usuario Business o Enterprise, puedes crear User Profiles con Profile Keys para gestionar varios clientes. La Profile Key se utiliza en la cabecera de tus peticiones. El API Key también debe usarse en la cabecera de tus peticiones para los User Profiles.

Los planes Premium solo deben usar el API Key en la cabecera de sus peticiones. Los planes Business y Enterprise deben usar la Profile Key en la cabecera de sus peticiones cuando interactúan en nombre de un User Profile.

Formato del API Key

Authorization: Bearer API_KEY reemplazando API_KEY por el API Key de tu Primary Profile, que puedes encontrar en el Dashboard de Ayrshare.

curl -H "Authorization: Bearer API_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

$headers = ["Authorization" => "Bearer API_KEY"];

headers := map[string]string{"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

Obtén tu API Key secreto en el dashboard de Ayrshare, en la página API Key que se encuentra en el panel de navegación de la izquierda.Por ejemplo, si tu API Key es 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EATu cabecera debe incluir:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

Formato de la Profile Key

Una Profile Key se utiliza para interactuar en nombre de un User Profile. Solo está disponible para los planes Business o Enterprise. Profile-Key: PROFILE_KEY reemplazando PROFILE_KEY con la Profile Key del usuario. Es obligatorio incluir una Profile Key en la cabecera para interactuar en nombre de un User Profile. Si falta el API Key del Primary Profile o si usas la Profile Key en lugar del API Key en la cabecera, se producirá un error. Así se estructuran las cabeceras para las peticiones a la API:

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

Encuentra la Profile Key en el Dashboard de Ayrshare, en la página Profile Key que aparece en el panel de navegación de la izquierda. Cambia al Profile que quieras usar en la página User Profile. Además, la Profile Key se devuelve en la respuesta del endpoint Crear un User Profile.Después podrás usar la Profile Key en la cabecera de tus peticiones:Por ejemplo, si tu Profile Key es AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EATu cabecera debe incluir tanto el API Key como la Profile Key:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAProfile-Key: AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA

Credenciales BYO de X/Twitter

A partir del 31 de marzo de 2026, todas las operaciones en X/Twitter a través de Ayrshare requieren tus propias credenciales OAuth 1.0a. Después de vincular tu cuenta de X mediante OAuth, envía estas 2 cabeceras junto a tu cabecera Authorization (y la opcional Profile-Key) en cualquier petición dirigida a X/Twitter:

Cabecera	Descripción
`X-Twitter-OAuth1-Api-Key`	Tu API Key de OAuth 1.0a (Consumer Key)
`X-Twitter-OAuth1-Api-Secret`	Tu API Key Secret de OAuth 1.0a (Consumer Secret)

Estas cabeceras serán obligatorias después del 31 de marzo de 2026. Las peticiones a los endpoints de X/Twitter sin credenciales BYO válidas serán rechazadas.

Un único par de claves, usado para todas las peticiones. Creas una única X Developer App por cuenta de Ayrshare y usas los mismos valores de X-Twitter-OAuth1-Api-Key y X-Twitter-OAuth1-Api-Secret en todas las peticiones dirigidas a X, sin importar el subperfil (Profile-Key) al que corresponda la petición. No generas ni rotas claves por cliente ni por usuario final.

Consulta la Guía de configuración de claves BYO de X para ver instrucciones paso a paso, ejemplos de código y solución de problemas. Las mismas dos cabeceras se aplican cuando controlas X/Twitter a través del MCP Server; consulta Conectar y configurar.

Content Type

El Content Type siempre debe establecerse como Content-Type: "application/json", salvo que el endpoint especifique explícitamente lo contrario.

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

Compresión

Ayrshare admite compresión en todas las peticiones a la API. Para habilitar la compresión, establece la cabecera Accept-Encoding como deflate, gzip, br.

  Accept-Encoding: "deflate, gzip, br"

Se recomienda para llamadas que devuelven respuestas grandes, como el endpoint /history.

Solo se comprimen las respuestas de más de 1024 bytes (1KB).
El orden de compresión usado es: Brotli (br) primero, luego gzip y por último deflate. Brotli es el algoritmo de compresión más eficiente.
La cabecera de la respuesta contiene la codificación de contenido utilizada. Por ejemplo: content-encoding: br si se usó Brotli.
Aprende más sobre la compresión y sus beneficios en el Blog de Ayrshare.

No olvides descomprimir correctamente la respuesta usando la codificación de contenido indicada.

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -H "Accept-Encoding: deflate, gzip, br" \ 
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json",
  "Accept-Encoding" => "deflate, gzip, br"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

Tipos de ID

Hay varios tipos de IDs que se devuelven y pueden usarse en distintos endpoints:

Ayrshare Post ID

Este ID lo genera Ayrshare y se devuelve desde el endpoint /post en el campo id. Este ID facilita obtener analíticas de la publicación en varias redes sociales, añadir comentarios a la publicación, eliminar la publicación, etc. Es el ID que usarás con más frecuencia. Cada red social asigna su propio ID único a publicaciones y comentarios. Estos IDs se devuelven en el campo postIds de los endpoints /post o /comments. Puedes usar estos IDs, o los que obtengas directamente de las redes sociales, para recuperar datos, por ejemplo con el social post ID de analíticas.

Ayrshare Comment ID

Este ID lo genera Ayrshare y se devuelve desde el endpoint /comments en el campo id. Este ID facilita obtener analíticas del comentario en las distintas redes sociales, añadir respuestas al comentario, eliminarlo, etc. Es el ID que usarás con más frecuencia. Se suele usar cuando quieres obtener detalles de un comentario concreto publicado a través de Ayrshare. Cada red social asigna su propio ID único a los comentarios. Estos IDs se devuelven en el campo commentId del endpoint GET /comments. Se suele usar cuando quieres obtener detalles de un comentario concreto publicado fuera de Ayrshare.

Códigos de error

Los errores se devuelven con códigos de estado HTTP estándar. Para más información:

Códigos de estado HTTP

Aprende más sobre los códigos de estado HTTP

Los errores detallados se incluyen en la respuesta de la API REST específica para cada tipo de llamada. Para más información:

Códigos de error de Ayrshare

Aprende más sobre los códigos de error específicos de Ayrshare

Formato de marca de tiempo

Ayrshare utiliza la hora Zulu, también conocida como UTC (Tiempo Universal Coordinado), o una cadena de fecha con formato ISO 8601, para proporcionar referencias temporales precisas e inequívocas entre distintas zonas horarias. 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. Puedes convertir el formato UTC a tu hora local en el lenguaje de programación que prefieras. Por ejemplo, en JavaScript:

const convertToLocalTime = (isoString) => {
  // Create a new Date object from the ISO string
  const date = new Date(isoString);

  // Extract local time components
  const localDate = date.toLocaleDateString();
  const localTime = date.toLocaleTimeString();

  // Combine the local date and time
  const localDateTime = `${localDate} ${localTime}`;

  return localDateTime;
};

Postman

Puedes usar Postman para probar tus llamadas a la API REST.

Postman

Aprende a usar Postman con nuestra API

Publicaciones, imágenes y videos aleatorios

Consulta la guía de inicio rápido para saber cómo enviar publicaciones, imágenes o videos aleatorios al hacer pruebas.

Paquetes

Contamos con paquetes para Node.js y Python, así como guías para Bubble.io, Airtable y Make que facilitan las llamadas RESTful.

Paquete NPM para Node

Intégralo usando nuestro paquete de NodeJS

Paquete PyPI para Python

Intégralo usando nuestro paquete de Python

Guía de Airtable

Aprende a usar Ayrshare con Airtable

Plugin y guía de Bubble

Aprende a usar Ayrshare con Bubble.io

Guía de Make

Aprende a usar Ayrshare con Make

Guía de Notion

Aprende a usar Ayrshare con Notion

Guía de FlutterFlow

Aprende a usar Ayrshare con FlutterFlow

Guía de Retool

Aprende a usar Ayrshare con Retool

​Funcionalidad clave

​Business Plan y Launch Plan

​Ads API

Ads API

​Messages API

Messages API

​Max Pack

Max Pack

​Mira cómo usar la API social

​Demo de la API social

Social API Demo

​URL base

​Autorización

​Formato del API Key

​Formato de la Profile Key

​Credenciales BYO de X/Twitter

​Content Type

​Compresión

​Tipos de ID

​Ayrshare Post ID

​Social Post ID

​Ayrshare Comment ID

​Social Comment ID

​Códigos de error

Códigos de estado HTTP

Códigos de error de Ayrshare

​Formato de marca de tiempo

​Postman

Postman

​Publicaciones, imágenes y videos aleatorios

​Paquetes

Paquete NPM para Node

Paquete PyPI para Python

Guía de Airtable

Plugin y guía de Bubble

Guía de Make

Guía de Notion

Guía de FlutterFlow

Guía de Retool

Funcionalidad clave

Business Plan y Launch Plan

Ads API

Messages API

Max Pack

Mira cómo usar la API social

Demo de la API social

URL base

Autorización

Formato del API Key

Formato de la Profile Key

Credenciales BYO de X/Twitter

Content Type

Compresión

Tipos de ID

Ayrshare Post ID

Social Post ID

Ayrshare Comment ID

Social Comment ID

Códigos de error

Formato de marca de tiempo

Postman

Publicaciones, imágenes y videos aleatorios

Paquetes