Conecta tus cuentas de redes sociales
Inicia sesión o regístrate para obtener una cuenta de Ayrshare. En la página Social Account, haz clic en las redes sociales que quieras conectar. Asegúrate de otorgar todos los permisos.
Obtén tu API Key
Se requiere una API Key para autorizar el acceso a los endpoints de la API. Esta clave se usa en la cabecera de tus solicitudes y debe ir precedida por la palabra claveBearer.
Tu API Key se encuentra en el Dashboard de Ayrshare, en la página API Key. Si es necesario, cambia a tu ‘Primary Profile’ desde la página User Profiles.
Desde ahí, puedes encontrar la página API Key en el panel lateral izquierdo.

Bearer. Incluye también el Content-Type con valor application/json.
Header
Envía tu primera publicación por API
Publicar el post
A continuación se muestran ejemplos de código en distintos lenguajes que ilustran cómo realizar una publicación con nuestra API. Para una integración aún más sencilla, puedes usar uno de nuestros paquetes SDK predefinidos. Para hacer una publicación necesitarás:- Tu API Key para la autenticación.
- El contenido de texto de tu publicación.
- Las plataformas de redes sociales en las que quieres publicar (incluye solo plataformas que hayas vinculado).
- Opcional: URLs de las imágenes o videos que quieras incluir.
¿Publicando en X/Twitter? X requiere tus propias credenciales de API. Añade 2 cabeceras BYO (
X-Twitter-OAuth1-Api-Key y X-Twitter-OAuth1-Api-Secret) a tu solicitud. Esto es una configuración única por cuenta de Ayrshare, y el mismo par de claves funciona para cada sub-perfil / usuario final. Consulta la guía de configuración para más detalles.Respuesta de la publicación
Recibirás una respuesta con unstatus de “success” cuando nuestra API procese correctamente tu publicación. La respuesta incluye:
status: Estado general de la llamada a la API (“success” o “error”)errors: Arreglo con los errores encontrados (vacío si fue exitoso)postIds: Arreglo de objetos con los detalles específicos de cada plataforma:- Nombre de la plataforma
- ID de la publicación en esa plataforma
- URL para ver la publicación
- Información adicional específica de la plataforma
postIds tendrá su propio status, lo que te permite verificar qué plataformas recibieron correctamente tu publicación.
Revisa tus páginas de redes sociales para asegurarte de que la publicación se procesó correctamente y está en vivo. Ten en cuenta que algunas plataformas pueden tener una ligera demora antes de que las publicaciones aparezcan públicamente.
Aquí tienes una respuesta de ejemplo:
Post Response
Post
Profundicemos un poco
Analicemos el proceso de lo que acaba de pasar cuando hicimos esta llamada a la API.Configura la cabecera
Configuramos el token bearer de autorización en la cabecera (API Key) y el content type
json.
Crea un objeto en el cuerpo
Luego, creamos un objeto en el body:
- Post con el texto “Today is a great day!”.
- Plataformas de redes sociales: Facebook, Instagram y LinkedIn. Debes incluir únicamente las plataformas que hayas vinculado en la página de Social Linkage.
- Añadimos una imagen en mediaUrls.
Antes de irte, algunas buenas prácticas
Lee la documentación
Mantenemos documentación extensa y actualizada. Ya que estás aquí, dedica un rato a revisar las secciones de la documentación en la navegación de la izquierda.Los códigos de error son importantes
Debes manejarlos para que tus usuarios tengan una excelente experiencia.Errores
Mantén tu API Key segura
Nos tomamos la seguridad muy en serio, y tú deberías hacer lo mismo. Tienes control total sobre la conexión entre Ayrshare y tus cuentas de redes sociales. Una vez conectadas las cuentas, la API Key de Ayrshare se convierte en el modo de autenticación. Por favor, mantén esta clave secreta y segura.Publica posts de prueba
Puedes publicar posts de prueba con una cita, imagen o video aleatorios usando los parámetrosrandomPost, randomMediaUrl, e isLandscapeVideo o isPortraitVideo en el endpoint /post. Si usas randomPost, el parámetro post no es obligatorio.
Cita aleatoria
Envía una cita aleatoria para probar la publicación agregandorandomPost: true.
Se usa con el endpoint /post.
Imagen aleatoria
Envía una imagen aleatoria agregandorandomMediaUrl: true.
Se usa con el endpoint /post.
Video aleatorio
Envía un video horizontal aleatorio agregandoisVideo: true e isLandscapeVideo: true.
El video tendrá el tamaño estándar horizontal.
Se usa con el endpoint /post.
isVideo: true e isPortraitVideo: true.
Se usa con el endpoint /post.
Comentario aleatorio
Envía un comentario aleatorio para probar la publicación de un comentario agregandorandomComment: true.
Se usa con el endpoint /comment.
