> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Próximos cambios en la API

> Cambios en la API que pueden afectar a tu integración

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](/whatsnew/latest) para ver todas las nuevas funciones.

<Update label="15 de junio de 2026">
  <ul class="custom-bullets">
    <li>
      **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](https://developers.facebook.com/blog/post/2026/02/18/introducing-graph-api-v25-and-marketing-api-v25/) para más detalles.

      <ul class="custom-bullets">
        <li>
          [GET analytics/post](/apis/analytics/post) ya no devuelve los siguientes campos de Facebook:

          <ul class="custom-bullets">
            <li>impressionsUnique → migra a `mediaView`</li>
            <li>impressionsFanUnique → migra a `mediaView`</li>
            <li>impressionsOrganicUnique → migra a `mediaView`</li>
            <li>impressionsPaidUnique → migra a `mediaViewIsFromAds`</li>
            <li>videoViewsUnique → usa `videoViews` para vistas no únicas de 3 segundos</li>
            <li>Las familias `totalVideoViews*Unique` y `totalVideoImpressions*` (por ejemplo, `totalVideoViewsOrganicUnique`, `totalVideoViewsPaidUnique`, `totalVideoViewsUnique`)</li>
          </ul>
        </li>

        <li>
          [GET analytics/social](/apis/analytics/social) ya no devuelve los siguientes campos de Facebook:

          <ul class="custom-bullets">
            <li>La familia `pagePostsImpressions*` (`pagePostsImpressions`, `pagePostsImpressionsPaid`, `pagePostsImpressionsUnique`, `pagePostsImpressionsOrganicUnique`, `pagePostsImpressionsViral*`, `pagePostsImpressionsNonviral*`) → migra a `pageMediaView`</li>
            <li>pagePostsServedImpressionsOrganicUnique → migra a `pageMediaView`</li>
            <li>pageVideoViewsUnique → usa `pageVideoViews` para vistas no únicas de 3 segundos</li>
          </ul>
        </li>

        <li>
          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.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="11 de mayo de 2026">
  <ul class="custom-bullets">
    <li>
      **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](/errors/errors-ayrshare) para más detalles.
    </li>
  </ul>
</Update>

<Update label="9 de abril de 2026">
  <ul class="custom-bullets">
    <li>
      **Analíticas vacías devuelven el error 187:** solicitar [Social Analytics](/apis/analytics/social) o [Post Analytics](/apis/analytics/post) 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.
    </li>
  </ul>
</Update>

<Update label="31 de marzo de 2026">
  <ul class="custom-bullets">
    <li>
      **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](/dashboard/connect-social-accounts/x-twitter-byo-keys) para más instrucciones.
    </li>

    <li>
      **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.
    </li>

    <li>
      **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.).
    </li>
  </ul>
</Update>

<Update label="14 de noviembre de 2025">
  <ul class="custom-bullets">
    <li>
      A partir del 14 de noviembre de 2025, Facebook depreciará los siguientes campos en [GET analytics/social](/apis/analytics/social):

      <ul class="custom-bullets">
        <li>pageFans</li>
        <li>pageFansCity</li>
        <li>pageFansLocale</li>
        <li>pageFansCountry</li>
        <li>pageFansAdds</li>
        <li>pageFanAddsUnique</li>
        <li>pageFanRemoves</li>
        <li>pageFanRemovesUnique</li>
        <li>pageImpressions → migra a `pageMediaView`</li>
        <li>pageImpressionsPaidUnique → migra a `pageMediaViewIsFromAds`</li>
        <li>pageImpressionsUnique</li>
        <li>pageImpressionsViral</li>
        <li>pageImpressionsViralUnique</li>
        <li>pageImpressionsPaid → migra a `pageMediaViewIsFromAds`</li>
      </ul>
    </li>

    <li>
      A partir del 14 de noviembre de 2025, Facebook depreciará los siguientes campos en [GET analytics/post](/apis/analytics/post):

      <ul class="custom-bullets">
        <li>impressions e impressionsFanPaidUnique → migra a `mediaView`. Los desgloses granulares están disponibles mediante `mediaViewIsFromAds` (vistas atribuidas a anuncios) y `mediaViewIsFromFollowers` (vistas atribuidas a seguidores).</li>
        <li>postImpressionsUnique (Reels) → usa `blueReelsPlayCount` para el número de reproducciones del reel o `postVideoViewTime` para el tiempo total de visualización.</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1 de septiembre de 2025">
  <ul class="custom-bullets">
    <li>
      A partir del 1 de septiembre de 2025, el endpoint [get comments](/apis/comments/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.
    </li>
  </ul>
</Update>

<Update label="1 de junio de 2025">
  <ul class="custom-bullets">
    <li>
      El endpoint [get comments](/apis/comments/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`:

      <ul class="custom-bullets">
        <li>followersCount</li>
        <li>followingCount</li>
        <li>tweetCount</li>
        <li>listedCount</li>
        <li>mediaCount</li>
      </ul>
    </li>

    <li>
      Facebook depreciará los siguientes campos en [GET
      analytics/social](/apis/analytics/social):

      <ul class="custom-bullets">
        <li>pageVideoViews10S</li>
        <li>pageVideoViews10SAutoplayed</li>
        <li>pageVideoViews10SClickToPlay</li>
        <li>pageVideoViews10SOrganic</li>
        <li>pageVideoViews10SPaid</li>
        <li>pageVideoViews10SRepeat</li>
        <li>pageVideoViews10SUnique</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="7 de mayo de 2025">
  <ul class="custom-bullets">
    <li>
      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.
    </li>
  </ul>
</Update>

<Update label="20 de abril de 2025">
  <ul class="custom-bullets">
    <li>
      Las siguientes métricas de [Instagram post analytics](/apis/analytics/post) serán depreciadas:

      REELS:

      <ul class="custom-bullets">
        <li>
          playsCount
        </li>

        <li>
          clipsReplaysCount
        </li>

        <li>
          igReelsAggregatedAllPlaysCount
        </li>
      </ul>

      FEED/STORY:

      <ul class="custom-bullets">
        <li>
          impressionsCount
        </li>
      </ul>
    </li>

    <li>
      El [endpoint history](/apis/history/get-history) impondrá la caché durante 1 minuto si el `limit` es mayor que el valor por defecto de 25.
    </li>
  </ul>
</Update>

<Update label="1 de marzo de 2025">
  El endpoint [get comments](/apis/comments/get-comments) para TikTok estandarizará los nombres de campo
  para que coincidan con los de otras redes sociales.

  <ul class="custom-bullets">
    <li>
      El campo `replyList` se renombrará a `replies` y `profileImage` se renombrará a
      `profileImageUrl`.
    </li>

    <li>Ambos nuevos nombres de campo ya están disponibles y pueden usarse en tu integración.</li>

    <li>
      TikTok tiene las siguientes actualizaciones:

      <ul class="custom-bullets">
        <li>
          Endpoint [social analytics](/apis/analytics/social): 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.
        </li>

        <li>
          Endpoints [history platform](/apis/history/history-platform) y [post
          analytics](/apis/analytics/post): 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`.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1 de febrero de 2025">
  El endpoint [/user](/apis/user/profile-details) cambia cómo reporta el uso de la API:

  <ul class="custom-bullets">
    <li>
      El campo `monthlyApiCalls` se ampliará para contar todas las llamadas a la API (posts, comments,
      analytics, etc.).
    </li>

    <li>Para los conteos específicos de publicaciones, usa el nuevo campo `monthlyPostCount`.</li>

    <li>
      El campo `monthlyApiCallsQuota` será depreciado y reemplazado por el nuevo campo `monthlyPostQuota`.
    </li>
  </ul>
</Update>

<Update label="5 de enero de 2025">
  <ul class="custom-bullets">
    <li>
      Meta está depreciando el campo `videoViews` en el [endpoint post analytics
      de Instagram](/apis/analytics/post).
    </li>

    <li>
      Además, los campos `emailContactsCount`, `getDirectionClicks`, `profileViewsCount`,
      `textMessageClicks`, `websiteClicksCount` y `phoneCallClicksCount` serán eliminados
      del endpoint [social analytics](/apis/analytics/social) de Instagram.
    </li>

    <li>Estos campos se eliminarán el 5 de enero de 2025.</li>
  </ul>
</Update>

<Update label="15 de diciembre de 2024">
  <ul class="custom-bullets">
    <li>
      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í](/apis/overview#authorization) cómo usar correctamente una Profile Key.
    </li>
  </ul>
</Update>

<Update label="15 de noviembre de 2024">
  <ul class="custom-bullets">
    <li>
      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.
    </li>

    <li>
      El endpoint history ahora devolverá las respuestas como objetos por defecto. El parámetro objResponse
      se establecerá en true automáticamente.
    </li>

    <li>
      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`.
    </li>
  </ul>
</Update>

<Update label="7 de octubre de 2024">
  <ul class="custom-bullets">
    <li>
      El endpoint media ya no devolverá url\_1080. Si necesitas redimensionar una imagen,
      consulta el [endpoint resize](/apis/media/resize).
    </li>
  </ul>
</Update>

<Update label="16 de septiembre de 2024">
  <ul class="custom-bullets">
    <li>
      **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](/apis/analytics/social).
    </li>

    <li>
      Facebook va a [depreciar varios
      campos](https://developers.facebook.com/docs/pages-api/changelog/). El [endpoint social analytics](/apis/analytics/social-by-id)
      dejará de devolver estos campos después del 16 de septiembre de
      2024\.
    </li>
  </ul>
</Update>

<Update label="3 de junio de 2024">
  <ul class="custom-bullets">
    <li>
      El [nuevo sistema de acortador de enlaces](/apis/links/overview) reemplazará el endpoint de acortador,
      que ha sido depreciado por Google. El nuevo acortador de enlaces requiere el complemento [Max
      Pack](/additional/maxpack).
    </li>

    <li>
      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](/apis/links/overview).
    </li>
  </ul>
</Update>

<Update label="22 de abril de 2024">
  <ul class="custom-bullets">
    <li>
      Meta va a depreciar su API de Facebook Groups. Consulta el
      [anuncio](https://www.ayrshare.com/blog/facebook-removes-groups-api-access-impact-and-implications/).
    </li>
  </ul>
</Update>

<Update label="16 de abril de 2024">
  <ul class="custom-bullets">
    <li>
      Instagram ha aclarado el periodo de tiempo del conjunto de datos de seguidores online. Consulta aquí para
      [más detalles](/apis/analytics/instagram-follower-count).
    </li>
  </ul>
</Update>

<Update label="1 de abril de 2024">
  <ul class="custom-bullets">
    <li>
      La respuesta por defecto de [Reply to comment with comment ID](/apis/comments/reply-to-comment) 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.
    </li>
  </ul>
</Update>

<Update label="25 de enero de 2024">
  <ul class="custom-bullets">
    <li>
      El [endpoint retry post](/apis/post/retry-post) devolverá un status "pending" en lugar de
      "success" para reflejar mejor el estado del reintento.
    </li>

    <li>
      Se publicarán los [cambios en la API sobre scheduleDate y
      createDate](/whatsnew/upcoming-api-changes#changes-in-effect-june-17-2022).
    </li>
  </ul>
</Update>

<Update label="8 de diciembre de 2023">
  <ul class="custom-bullets">
    <li>
      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`.
    </li>

    <li>
      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.
    </li>

    <li>
      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.
    </li>

    <li>La documentación de delete comment se ha corregido para alinearse con el retorno correcto.</li>

    <li>
      El campo commentId de TikTok será reemplazado por el campo id para alinearse con el formato estándar
      de delete comment.
    </li>

    <li>
      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:
    </li>
  </ul>
</Update>

<Update label="18 de octubre de 2023">
  <ul class="custom-bullets">
    <li>
      Los siguientes campos de YouTube en el [endpoint social analytics](/apis/analytics/social) se
      devolverán como valores numéricos en lugar de String.
    </li>
  </ul>
</Update>

<Update label="30 de mayo de 2023">
  <ul class="custom-bullets">
    <li>
      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.
    </li>
  </ul>
</Update>

<Update label="8 de mayo de 2023">
  <ul class="custom-bullets">
    <li>
      Nos entusiasma lanzar [la publicación directa en TikTok](/apis/post/social-networks/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.
    </li>

    <li>
      También introducimos añadir, obtener y eliminar comentarios de TikTok + datos analíticos
      demográficos.
    </li>

    <li>
      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.
    </li>
  </ul>
</Update>

<Update label="17 de febrero de 2023">
  <ul class="custom-bullets">
    <li>
      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.
    </li>
  </ul>
</Update>

<Update label="1 de octubre de 2022">
  <ul class="custom-bullets">
    <li>Los campos descriptions, text y message de Get All Posts se estandarizan al campo `post`.</li>
  </ul>
</Update>

<Update label="12 de septiembre de 2022">
  <ul class="custom-bullets">
    <li>Campos de TikTok depreciados: `shareUrl`. Usa `postUrl` en su lugar.</li>
  </ul>
</Update>

<Update label="17 de junio de 2022">
  <ul class="custom-bullets">
    <li>
      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.
    </li>

    <li>
      El campo `scheduleDate` ya no devolverá un Object, sino un String que contiene la hora
      programada en formato UTC.
    </li>

    <li>
      El campo no documentado `created_date` en /history será eliminado. Usa `created` en su lugar.
    </li>
  </ul>
</Update>

<Update label="22 de abril de 2022">
  <ul class="custom-bullets">
    <li>
      Las analíticas en una [publicación de Facebook](/apis/analytics/post) devuelven `reactions` como un objeto con el
      siguiente formato.
    </li>
  </ul>
</Update>

<Update label="1 de abril de 2022">
  <ul class="custom-bullets">
    <li>
      History devolverá por defecto las últimas 20 publicaciones. Se pueden devolver hasta 500 con el
      parámetro `lastRecords`.
    </li>
  </ul>
</Update>