Saltar al contenido principal
Si tienes problemas para conectar Instagram, consulta la guía de solución de problemas.
Si tu contenido está alojado en un servidor o CDN que tú controlas, asegúrate de que el crawler de publicación de Meta pueda descargarlo. Consulta Meta Media Crawler Blocked si ves el código de error 440 de Ayrshare (“social network could not download media from this URL”) o el código 138 con “Restricted by robots.txt” en los detalles.
La API de Instagram tiene los siguientes requisitos y restricciones.
  • Cuenta de Instagram Business o Creator conectada con una Página de Facebook: consulta aquí.
  • Solo se permiten 50 publicaciones de Instagram en un período de 24 horas. Consulta a continuación usedQuota.
  • El texto de post puede contener hasta 5 hashtags (p. ej. #wildtimes) y 3 menciones de nombre de usuario (p. ej. @natgeo).
  • Los usuarios de Instagram @mencionados recibirán una notificación.
  • Máximo 2200 caracteres por publicación.
  • Las publicaciones con varias imágenes/videos son compatibles y se envían como carrusel. Puedes enviar hasta 10 videos e imágenes.
  • Instagram no admite eliminaciones a través de una API. Las eliminaciones deben realizarse manualmente en la app de Instagram.
  • Si tu video de Reel no termina con una extensión de video conocida como mp4, usa el parámetro isVideo. Consulta el endpoint /post para más detalles.
  • Instagram también admite el envío de medios sin texto de publicación. Si no quieres incluir texto en la publicación, envía una cadena vacía post: "".
  • Consulta las Directrices de medios de Instagram y la Autorización de Instagram para más información.

Publicar en Instagram

JSON para una publicación básica con imagen y hashtags en Instagram:
Instagram Post
Los hashtags son clicables en las publicaciones de Instagram, pero los enlaces no.
La relación de aspecto de las imágenes y videos y la duración del video son muy importantes para publicar correctamente en Instagram. Si no cumplen con los requisitos, la publicación será rechazada.Consulta la sección de Instagram en las Directrices de imagen y video.

Cuenta de Instagram Business o Creator

Tu cuenta de Instagram debe ser Business o Creator y estar conectada con una Página de Facebook. La configuración es gratuita y sencilla. Consulta aquí las instrucciones detalladas:

Vinculación de Instagram

Carrusel de imágenes y videos

Puedes publicar varias imágenes o videos de Reel en Instagram como un carrusel; hasta un total combinado de 10 imágenes o videos en un carrusel. Simplemente agrega tus imágenes o videos adicionales al arreglo mediaUrls y el carrusel se creará automáticamente.
Instagram Carousel Post
Las URLs de video deben terminar con una extensión conocida como mp4. El parámetro isVideo no es compatible con los carruseles de Instagram.

Instagram Reels

En Instagram, una publicación de video se llama Reel. Puedes publicar un video en la API de Instagram Reels con las siguientes opciones opcionales en instagramOptions.
Instagram Reels Options
  • Consulta los requisitos de video de la API de Reels para más detalles sobre los requisitos de video.
  • shareReelsFeed: Boolean con valor true para indicar que el Reel puede aparecer en las pestañas Feed y Reels, o false para indicar que el Reel solo puede aparecer en la pestaña Reels. Este valor es una sugerencia para Instagram sobre dónde te gustaría que apareciera el Reel, pero ninguno de los valores determina si el Reel realmente aparece en la pestaña Reels o Feed porque puede que el Reel no cumpla con los requisitos de elegibilidad o no sea seleccionado por el algoritmo de Instagram.
  • audioName: nombre en String del audio o música de tu Reel. Solo puedes renombrarlo una vez, ya sea al crear el reel o después desde la página de audio. Por ejemplo, "The Weeknd - Blinding Lights".
  • thumbNail: URL en String de la imagen de portada (thumbnail) del Reel. Consulta aquí los detalles sobre thumbNail.
  • thumbNailOffset: desplazamiento entero en milisegundos del frame de la miniatura. Consulta aquí los detalles sobre thumbNailOffset.
Consulta los requisitos de video de la API de Reels o un ejemplo de uso de la API de Instagram Reels. También puedes establecer una URL de portada de Reels y etiquetas de ubicación y usuarios.

Trial Reels

Un trial reel es un Reel que se publica únicamente para no seguidores cuando se publica por primera vez, lo que te permite probar cómo funciona un Reel con una audiencia nueva antes de que llegue a tus seguidores existentes. Establece trialParams.graduationStrategy en instagramOptions para publicar un Reel como trial.
Instagram Trial Reel
graduationStrategy controla cómo un trial reel más tarde “gradúa” — es decir, se vuelve visible también para tus seguidores. Es obligatorio cuando se proporciona trialParams y debe ser uno de:
  • “MANUAL” — la publicación permanece como trial reel hasta que la gradúes manualmente desde la app de Instagram.
  • “SS_PERFORMANCE” — Meta gradúa automáticamente el Reel según el rendimiento inicial frente a no seguidores.
La graduación en sí (promover un trial reel publicado a los seguidores) no está expuesta actualmente por la API de Meta y debe realizarse manualmente en la app de Instagram. Ayrshare añadirá un endpoint de graduación una vez que Meta lo exponga.

Restricciones de trial reels

La solicitud de trial reel se rechaza en el borde de Ayrshare — antes de cualquier llamada a Meta — cuando no se cumple alguna de estas condiciones:
  • Exactamente una URL de medio que termine en .mp4 o .mov (sin distinguir mayúsculas/minúsculas). Los carruseles no están admitidos.
  • instagramOptions.stories no debe ser true. Las Stories no pueden ser trial reels.
  • graduationStrategy debe estar presente y ser exactamente “MANUAL” o “SS_PERFORMANCE” (distingue mayúsculas/minúsculas).
Los fallos devuelven uno de tres códigos de error de Ayrshare — consulta Errores de Trial Reels de Instagram (447, 448, 449) para ver los payloads completos.

Instagram Stories

Puedes publicar una sola imagen o video como Story de Instagram con las siguientes instagramOptions. Las Stories de Instagram desaparecen después de 24 horas.
Stories Post
Consulta los requisitos de la API de Stories.
  • Las Stories de Instagram no admiten texto de publicación: cualquier texto proporcionado en el campo post, incluidas las menciones, será ignorado.
  • Las Stories expiran después de 24 horas.
  • Instagram actualmente solo admite la publicación de Stories en cuentas de Instagram Business y no en cuentas Creator.
  • Las Stories de Instagram no admiten colaboradores.
  • Instagram no admite la publicación de stickers (por ejemplo, enlace, encuesta, ubicación).

Miniaturas de Reels

Puedes seleccionar un frame del Reel como imagen de miniatura o tu propia imagen de portada (thumbnail) desde una URL externa.
Instagram Thumbnail
El offset es la ubicación en milisegundos del frame de miniatura del video del Reel. El valor por defecto es 0, que corresponde al primer frame del Reel. Si especificas tanto una URL de miniatura como un offset de miniatura, el offset será ignorado. La miniatura del Reel debe cumplir con los requisitos de miniatura de Reels. No se garantiza que las URLs firmadas con redirecciones sean compatibles con URLs de portada. Recomendamos usar una URL no firmada o el endpoint /media.

Texto alternativo

Añade texto alternativo de Instagram, también conocido como alt text, a una imagen. El alt text de Instagram es una función de accesibilidad utilizada para brindar información adicional al usuario y para lectores de pantalla.
  • El alt text admite hasta 1000 caracteres por imagen.
  • Instagram no admite alt text para Reels o Stories.
Usa altText dentro del objeto instagramOptions.
Instagram Alt Text
Cada alt text debe corresponder a una imagen o video del arreglo mediaUrls. El alt text se aplicará a cada imagen en orden.

Etiquetas de usuario y ubicaciones

El usuario de Instagram será notificado cuando uses su nombre de usuario en una publicación. Ten cuidado de no hacer spam a los usuarios ni publicar su nombre de usuario repetidamente. Si lo haces, Instagram podría suspender o desactivar tu cuenta.
Se puede etiquetar una imagen o un Reel con usuarios de Instagram, y una imagen, video o Reel con una ubicación usando el parámetro instagramOptions.

Ubicación

Una ubicación se especifica mediante un locationId, que es un ID de Página de Facebook o un nombre de Página de Facebook. Por ejemplo, el ID de página de Facebook del Museo Guggenheim es 7640348500 o el nombre de página de Facebook "@guggenheimmuseum". Las páginas deben estar asociadas con una ubicación física.
Instagram Location
Puedes buscar el locationId (Page Id) con el endpoint brand. Ten en cuenta que la Página debe tener una ubicación listada o el locationId devolverá un error.
No admitido en imágenes o videos dentro de carruseles.

Etiquetas de usuario

Las etiquetas de Instagram te permiten etiquetar a otros usuarios de Instagram en tu publicación. Los usuarios se especifican mediante userTags, que contiene un arreglo de objetos con un nombre de usuario de Instagram y coordenadas x/y (solo imagen). Las etiquetas de usuario se pueden agregar a imágenes individuales o Reels, pero no a videos normales, imágenes múltiples o Stories.
  • Los nombres de usuario deben ser cuentas públicas de Instagram. No incluyas el @ del handle del usuario.
  • Los valores x e y deben ser números float que se originen desde la esquina superior izquierda de la imagen, con un rango de 0.01.0. Solo para imágenes individuales. No incluyas con Reels o se producirá un error.
Instagram User Tags

Menciones en Instagram

Menciona a otro handle de Instagram agregando @handle en el texto de la publicación. Por ejemplo, puedes mencionar al handle @ayrshare en el texto de la publicación:
Instagram Mentions
El usuario @mencionado será notificado de la mención. Consulta las reglas importantes sobre menciones.

Colaboración

La colaboración de Instagram te permite ser coautor de contenido con otras cuentas de Instagram etiquetando a otros como colaboradores. Esto te permite designar a otros usuarios de Instagram como creadores en tu publicación. Al ser etiquetados, estos usuarios reciben una invitación para colaborar en la app móvil. Si aceptan, la publicación también aparecerá en su feed y será visible para sus seguidores, ampliando el alcance y el potencial de interacción de la publicación.

Colaboradores

El autor original público puede etiquetar a otra cuenta pública como colaborador de Instagram. La otra cuenta recibirá un mensaje que le permitirá aceptar o rechazar la solicitud. Si la otra cuenta acepta, la publicación también aparecerá en su perfil y se distribuirá a sus seguidores en el feed de Instagram. El encabezado de la publicación atribuirá el contenido a ambas cuentas. Puedes añadir colaboradores a un Reel, imagen o carrusel. Etiquetar a un colaborador privado no está permitido a través de la API de Instagram. Aunque esta funcionalidad existe dentro de la app de Instagram, las plataformas y sus APIs a menudo no están a la paridad de funciones.
Las Stories de Instagram no admiten colaboradores.
  • Solo invita a colaboradores que esperes que acepten tu invitación.
  • Si el colaborador responde con una solicitud de colaboración declined, no lo invites de nuevo hasta que contactes con él para entender la razón del rechazo.
  • Los rechazos repetidos del mismo usuario o de varios pondrán tu cuenta de Instagram y de Ayrshare en riesgo de cancelación.
  • El autor original puede añadir o quitar un colaborador en cualquier momento.
Invita a hasta tres colaboradores usando un arreglo de nombres de usuario públicos de Instagram.
Instagram Collaborators
Estos tres colaboradores recibirán una invitación por mensaje en su app móvil de Instagram y podrán aceptar o rechazar la invitación; luego podrás comprobar el estado de la solicitud del usuario invitado. Invita solo a colaboradores que sepas que aceptarán tu solicitud o tu cuenta de Instagram podría verse afectada negativamente.
Nota sobre los colaboradores invitados: con algunas excepciones, los datos sobre el contenido coautorado solo pueden ser accedidos a través de la API por el usuario que publicó el contenido; los colaboradores no pueden acceder a estos datos a través de la API.

Obtener el estado de la solicitud de colaborador

Después de invitar a un colaborador de Instagram, puedes verificar el estado de la solicitud usando la API para obtener el estado de la solicitud de colaborador.

Redimensionamiento automático de imagen

Se requiere Max Pack
Las imágenes se redimensionan automáticamente a 1080 x 1080 px para funcionar con Instagram usando el parámetro autoResize. Ten en cuenta que esto redimensionará la imagen para todas las plataformas incluidas, por lo que recomendamos hacer una llamada para Instagram y una llamada /post diferente para otras plataformas.
Instagram Auto Image Resize

Cuota utilizada

La respuesta de Instagram incluirá el usedQuota actual con el número de publicaciones de Instagram realizadas durante un período móvil de 24 horas. Instagram solo permite 50 publicaciones de Instagram en un período móvil de 24 horas.
Instagram Used Quota
Si se ha alcanzado la cuota, se devolverá un mensaje de error.

Problemas de contenido

Ayrshare incluye protección de medios integrada que puede detectar y resolver ciertos problemas de entrega de medios durante la publicación. Cuando una publicación tiene éxito pero se detectó y resolvió un problema de contenido, la respuesta incluye un objeto opcional contentIssues. Esto te permite identificar y solucionar de forma proactiva los problemas con el hosting de tus medios. El objeto contentIssues solo está presente cuando se detectó y resolvió un problema — las publicaciones exitosas normales no lo incluyen.
CampoTipoDescripción
originMediaHostFailedbooleanLa red social no pudo obtener el medio desde la URL proporcionada. La protección automatizada de medios de Ayrshare resolvió el problema y completó la publicación con éxito. Considera revisar tu configuración de hosting de medios — consulta Meta Media Crawler Blocked para causas comunes.
detailsarray of stringsDescripciones legibles por humanos de cada problema detectado.
Content Issues Response Example
Si ves originMediaHostFailed en tus respuestas, puede haber un problema con el hosting de tus medios que impide que las redes sociales accedan a ellos. Consulta Meta Media Crawler Blocked para los pasos detallados de solución de problemas.

Detalles de errores

Cuando falla una publicación de medios en Instagram, el objeto de error ahora expone el texto de error subyacente de Meta en el campo details, junto con el code y message de Ayrshare. Esto te permite distinguir entre distintas causas raíz (por ejemplo, un rechazo por relación de aspecto frente a un fallo de descarga de medios) sin tener que contactar con soporte.
Instagram Publish Error
El message es el resumen estable y legible por humanos de Ayrshare, mientras que details refleja el texto sin procesar devuelto por Meta para la publicación fallida.

Agregar saltos de línea o texto enriquecido a una publicación de Instagram

Se pueden agregar saltos de línea de Instagram a una publicación con un carácter especial de nueva línea. Se puede añadir texto enriquecido, como letras en negrita o cursiva, a una publicación de Instagram con algunos elementos HTML.

Límites de caracteres

Consulta Límites de caracteres de Instagram para más información.

Endpoints adicionales

Obtener el estado de la solicitud de colaborador