Saltar al contenido principal
Los siguientes cambios en la API entrarán en vigor en la fecha indicada. Revísalos cuidadosamente para detectar cualquier cambio potencialmente disruptivo. Consulta Novedades para ver todas las nuevas funciones.
​
15 de junio de 2026
  • Facebook: Meta ha retirado las métricas de Insights de impresiones únicas (reach) y de visualizaciones de video de 3 segundos. Meta eliminó estas métricas en todas las versiones de la Graph API, por lo que los campos afectados ya no se devuelven. Consulta el changelog de Meta Graph API v25 para más detalles.
    • GET analytics/post ya no devuelve los siguientes campos de Facebook:
      • impressionsUnique → migra a mediaView
      • impressionsFanUnique → migra a mediaView
      • impressionsOrganicUnique → migra a mediaView
      • impressionsPaidUnique → migra a mediaViewIsFromAds
      • videoViewsUnique → usa videoViews para vistas no únicas de 3 segundos
      • Las familias totalVideoViews*Unique y totalVideoImpressions* (por ejemplo, totalVideoViewsOrganicUnique, totalVideoViewsPaidUnique, totalVideoViewsUnique)
    • GET analytics/social ya no devuelve los siguientes campos de Facebook:
      • La familia pagePostsImpressions* (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*) → migra a pageMediaView
      • pagePostsServedImpressionsOrganicUnique → migra a pageMediaView
      • pageVideoViewsUnique → usa pageVideoViews para vistas no únicas de 3 segundos
    • Usa mediaView / pageMediaView para reach. Se planea una métrica sucesora de Total Unique Media Views. Los campos que se siguen admitiendo, como reactionsByType, videoViews, mediaView, pagePostEngagements, pageVideoViews y pageVideoViewsPaid, no se ven afectados.
​
11 de mayo de 2026
  • Los errores transitorios de YouTube ahora devuelven HTTP 503/504 en lugar de 500: algunos errores de subida de YouTube que antes aparecían como HTTP 500 (code: 176) ahora devuelven HTTP 503 (code: 454) o HTTP 504 (code: 453). Ambas respuestas incluyen retryAvailable: true. Las integraciones que filtran por HTTP 500 para reintentar subidas a YouTube deben pasar a filtrar por el campo retryAvailable del cuerpo de la respuesta. Consulta códigos de error para más detalles.
​
9 de abril de 2026
  • Analíticas vacías devuelven el error 187: solicitar Social Analytics o Post Analytics cuando ninguna plataforma devuelve datos ahora devuelve { "status": "error", "code": 187 } en lugar de { "status": "success" }. Actualiza cualquier código de cliente que dependa del comportamiento anterior de “success” vacío.
​
31 de marzo de 2026
  • Requisito de BYO Key para X/Twitter: todas las operaciones de X/Twitter a través de Ayrshare requerirán tus propias credenciales de API. Tras vincular tu cuenta de X mediante OAuth, incluye 2 cabeceras en cada solicitud de X/Twitter: X-Twitter-OAuth1-Api-Key y X-Twitter-OAuth1-Api-Secret. Las solicitudes sin credenciales válidas serán rechazadas. Consulta la guía de configuración de BYO Key para X para más instrucciones.
  • RSS-a-X deprecated: la publicación automática desde RSS a X/Twitter dejará de estar admitida después del 31 de marzo de 2026. Los feeds RSS se ejecutan de forma programada sin credenciales por solicitud, lo que es incompatible con el modelo BYO key. La publicación automática desde RSS al resto de plataformas no se ve afectada.
  • Webhook de X Account Activity deprecated: la acción de webhook de X Account Activity (accountActivity) dejará de estar disponible después del 31 de marzo de 2026. Esto incluye todas las notificaciones de eventos en tiempo real para cuentas de X vinculadas (publicaciones, menciones, DMs, likes, follows, blocks, etc.).
​
14 de noviembre de 2025
  • A partir del 14 de noviembre de 2025, Facebook depreciará los siguientes campos en GET analytics/social:
    • pageFans
    • pageFansCity
    • pageFansLocale
    • pageFansCountry
    • pageFansAdds
    • pageFanAddsUnique
    • pageFanRemoves
    • pageFanRemovesUnique
    • pageImpressions → migra a pageMediaView
    • pageImpressionsPaidUnique → migra a pageMediaViewIsFromAds
    • pageImpressionsUnique
    • pageImpressionsViral
    • pageImpressionsViralUnique
    • pageImpressionsPaid → migra a pageMediaViewIsFromAds
  • A partir del 14 de noviembre de 2025, Facebook depreciará los siguientes campos en GET analytics/post:
    • impressions e impressionsFanPaidUnique → migra a mediaView. Los desgloses granulares están disponibles mediante mediaViewIsFromAds (vistas atribuidas a anuncios) y mediaViewIsFromFollowers (vistas atribuidas a seguidores).
    • postImpressionsUnique (Reels) → usa blueReelsPlayCount para el número de reproducciones del reel o postVideoViewTime para el tiempo total de visualización.
​
1 de septiembre de 2025
  • A partir del 1 de septiembre de 2025, el endpoint get comments para Instagram ya no incluirá el campo text en los objetos de respuestas. Usa el campo comment en su lugar para acceder al contenido de la respuesta.
​
1 de junio de 2025
  • El endpoint get comments de X (Twitter) moverá las métricas públicas del usuario al nuevo objeto publicMetrics. Los siguientes campos se moverán del nivel superior al objeto publicMetrics:
    • followersCount
    • followingCount
    • tweetCount
    • listedCount
    • mediaCount
  • Facebook depreciará los siguientes campos en GET analytics/social:
    • pageVideoViews10S
    • pageVideoViews10SAutoplayed
    • pageVideoViews10SClickToPlay
    • pageVideoViews10SOrganic
    • pageVideoViews10SPaid
    • pageVideoViews10SRepeat
    • pageVideoViews10SUnique
​
7 de mayo de 2025
  • YouTube ha depreciado la configuración de regiones permitidas y bloqueadas. Aún puedes añadir las regiones permitidas y bloqueadas al endpoint de publicación, pero serán ignoradas.
​
20 de abril de 2025
  • Las siguientes métricas de Instagram post analytics serán depreciadas:REELS:
    • playsCount
    • clipsReplaysCount
    • igReelsAggregatedAllPlaysCount
    FEED/STORY:
    • impressionsCount
  • El endpoint history impondrá la caché durante 1 minuto si el limit es mayor que el valor por defecto de 25.
​
1 de marzo de 2025
El endpoint get comments para TikTok estandarizará los nombres de campo para que coincidan con los de otras redes sociales.
  • El campo replyList se renombrará a replies y profileImage se renombrará a profileImageUrl.
  • Ambos nuevos nombres de campo ya están disponibles y pueden usarse en tu integración.
  • TikTok tiene las siguientes actualizaciones:
    • Endpoint social analytics: se avecinan los siguientes cambios: • El campo durationAverage será depreciado y eliminado. • Debido a las limitaciones de la API de TikTok, los campos shareCountTotal, viewCountTotal y commentCountTotal ahora solo devolverán totales de los últimos 60 días en lugar de totales de todo el tiempo. • Para empezar a usar los totales de 60 días ahora, añade period60Days: true al cuerpo de tu solicitud a la API. Nota: usar este parámetro mejorará significativamente los tiempos de respuesta.
    • Endpoints history platform y post analytics: los campos no documentados caption, comments, shares, likes, shareUrl e itemsId serán eliminados; en su lugar deben usarse los campos post, commentsCount, sharesCount, likesCount, postUrl e id.
​
1 de febrero de 2025
El endpoint /user cambia cómo reporta el uso de la API:
  • El campo monthlyApiCalls se ampliará para contar todas las llamadas a la API (posts, comments, analytics, etc.).
  • Para los conteos específicos de publicaciones, usa el nuevo campo monthlyPostCount.
  • El campo monthlyApiCallsQuota será depreciado y reemplazado por el nuevo campo monthlyPostQuota.
​
5 de enero de 2025
  • Meta está depreciando el campo videoViews en el endpoint post analytics de Instagram.
  • Además, los campos emailContactsCount, getDirectionClicks, profileViewsCount, textMessageClicks, websiteClicksCount y phoneCallClicksCount serán eliminados del endpoint social analytics de Instagram.
  • Estos campos se eliminarán el 5 de enero de 2025.
​
15 de diciembre de 2024
  • Por seguridad, evitaremos que se usen Profile Keys como API Keys. Si intentas usar una Profile Key en lugar de la API Key, el sistema devolverá un error. Consulta aquí cómo usar correctamente una Profile Key.
​
15 de noviembre de 2024
  • Hemos actualizado cómo se reportan los errores en los webhooks programados de TikTok. Estos errores ahora aparecerán en el array errors, coherente con nuestro manejo de errores para otros tipos de webhooks programados. Ten en cuenta que los errores actuales de nivel superior se seguirán devolviendo, pero recomendamos usar el array errors.
  • El endpoint history ahora devolverá las respuestas como objetos por defecto. El parámetro objResponse se establecerá en true automáticamente.
  • Get All History LinkedIn devolverá un array para el objeto mediaUrls. Anteriormente se devolvía un objeto si había un solo elemento multimedia y un array si había varios. Ahora siempre se devolverá un array incluso si solo hay un elemento multimedia. Si necesitas el comportamiento anterior, puedes usar el parámetro de consulta objResponse: false.
​
7 de octubre de 2024
  • El endpoint media ya no devolverá url_1080. Si necesitas redimensionar una imagen, consulta el endpoint resize.
​
16 de septiembre de 2024
  • Actualización 25 de septiembre de 2024: Meta (Facebook) ha liberado la depreciación de los campos, por lo que la eliminación de los campos está en efecto. Consulta el retorno actualizado en social analytics.
  • Facebook va a depreciar varios campos. El endpoint social analytics dejará de devolver estos campos después del 16 de septiembre de 2024.
​
3 de junio de 2024
  • El nuevo sistema de acortador de enlaces reemplazará el endpoint de acortador, que ha sido depreciado por Google. El nuevo acortador de enlaces requiere el complemento Max Pack.
  • El acortado de enlaces estará desactivado (false) por defecto. Para acortar enlaces automáticamente usa shortenLinks: true en la llamada al endpoint post, que utiliza el nuevo endpoint link.
​
22 de abril de 2024
  • Meta va a depreciar su API de Facebook Groups. Consulta el anuncio.
​
16 de abril de 2024
  • Instagram ha aclarado el periodo de tiempo del conjunto de datos de seguidores online. Consulta aquí para más detalles.
​
1 de abril de 2024
  • La respuesta por defecto de Reply to comment with comment ID será un objeto tal como se describe en la documentación en lugar de un array. Puedes usar el parámetro objResponse establecido en booleano false si deseas conservar una respuesta como array.
​
25 de enero de 2024
​
8 de diciembre de 2023
  • Los campos caption, message, createdTime y timestamp del endpoint /history/instagram fueron depreciados el 1 de abril de 2023 y serán eliminados. Usa los campos post y created.
  • El campo mediaUrls del endpoint /history/linkedin se devolverá como un array en lugar de un objeto para admitir varias imágenes. Puedes forzar que se devuelva el array ahora incluyendo el parámetro de consulta de LinkedIn ?multiMedia=true. Ten en cuenta que, antes del 1 de diciembre de 2023, el parámetro de consulta multiMedia debe usarse para devolver contenido multimedia con varias imágenes. Después del 1 de diciembre de 2023, se devolverán varias imágenes por defecto.
  • En el webhook Scheduled Action de TikTok se depreciará el String platform. Usa el campo array platforms como se hace en otros webhooks Scheduled Action.
  • La documentación de delete comment se ha corregido para alinearse con el retorno correcto.
  • El campo commentId de TikTok será reemplazado por el campo id para alinearse con el formato estándar de delete comment.
  • El retorno de delete comment de Twitter ya no contendrá un array posts, de modo que el retorno se alinee con el formato estándar de delete comment. El nuevo retorno será el siguiente:
​
18 de octubre de 2023
​
30 de mayo de 2023
  • Hemos actualizado a la nueva versión 2 de la API de Twitter. Twitter ha depreciado algunos campos en la Versión 2, lo que afecta a los endpoints /analytics/social y getAllHistory. Los siguientes campos se seguirán devolviendo hasta el 1 de septiembre de 2023, pero con un valor cero o cadena vacía.
​
8 de mayo de 2023
  • Nos entusiasma lanzar la publicación directa en TikTok, la gestión de comentarios y las analíticas avanzadas. Tus usuarios ya no necesitarán abrir su app móvil de TikTok para publicar e introducir el texto del caption. Ahora, tras enviar a través de Ayrshare, el video de TikTok y el caption se publican directamente.
  • También introducimos añadir, obtener y eliminar comentarios de TikTok + datos analíticos demográficos.
  • Tu usuario deberá desvincular y volver a vincular su cuenta de TikTok para activar la publicación directa. Las conexiones existentes continuarán con el método indirecto y requerirán la app móvil de TikTok para publicar.
​
17 de febrero de 2023
  • Google Business Profile ha cambiado los datos analíticos sociales disponibles. Los nuevos campos disponibles son los siguientes. Los campos anteriores seguirán presentes, pero con un valor de cero, y serán completamente eliminados el 17 de marzo de 2023.
​
1 de octubre de 2022
  • Los campos descriptions, text y message de Get All Posts se estandarizan al campo post.
​
12 de septiembre de 2022
  • Campos de TikTok depreciados: shareUrl. Usa postUrl en su lugar.
​
17 de junio de 2022
  • En todos los endpoints history, los campos createdAt, createdTime y timestamp se reemplazarán por el campo created, que devuelve la hora de creación en formato UTC.
  • El campo scheduleDate ya no devolverá un Object, sino un String que contiene la hora programada en formato UTC.
  • El campo no documentado created_date en /history será eliminado. Usa created en su lugar.
​
22 de abril de 2022
​
1 de abril de 2022
  • History devolverá por defecto las últimas 20 publicaciones. Se pueden devolver hasta 500 con el parámetro lastRecords.