> ## 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.

# Các thay đổi API sắp tới

> Các thay đổi đối với API có thể ảnh hưởng đến tích hợp của bạn

Các thay đổi sau đối với API sẽ có hiệu lực vào ngày được chỉ định.
Vui lòng xem xét cẩn thận để phát hiện bất kỳ thay đổi có thể gây phá vỡ nào.
Xem [What's New](/whatsnew/latest) để biết tất cả các tính năng mới.

<Update label="15 tháng 6, 2026">
  <ul class="custom-bullets">
    <li>
      **Facebook: Meta đã ngừng các chỉ số Insights về unique-impression (reach) và lượt xem video 3 giây.** Meta đã xóa các chỉ số này trên tất cả các phiên bản Graph API, do đó các trường bị ảnh hưởng không còn được trả về nữa. Xem [Meta Graph API v25 changelog](https://developers.facebook.com/blog/post/2026/02/18/introducing-graph-api-v25-and-marketing-api-v25/) để biết chi tiết.

      <ul class="custom-bullets">
        <li>
          [GET analytics/post](/apis/analytics/post) không còn trả về các trường Facebook sau:

          <ul class="custom-bullets">
            <li>impressionsUnique → chuyển sang `mediaView`</li>
            <li>impressionsFanUnique → chuyển sang `mediaView`</li>
            <li>impressionsOrganicUnique → chuyển sang `mediaView`</li>
            <li>impressionsPaidUnique → chuyển sang `mediaViewIsFromAds`</li>
            <li>videoViewsUnique → sử dụng `videoViews` cho lượt xem 3 giây không duy nhất</li>
            <li>Các họ `totalVideoViews*Unique` và `totalVideoImpressions*` (ví dụ `totalVideoViewsOrganicUnique`, `totalVideoViewsPaidUnique`, `totalVideoViewsUnique`)</li>
          </ul>
        </li>

        <li>
          [GET analytics/social](/apis/analytics/social) không còn trả về các trường Facebook sau:

          <ul class="custom-bullets">
            <li>Họ `pagePostsImpressions*` (`pagePostsImpressions`, `pagePostsImpressionsPaid`, `pagePostsImpressionsUnique`, `pagePostsImpressionsOrganicUnique`, `pagePostsImpressionsViral*`, `pagePostsImpressionsNonviral*`) → chuyển sang `pageMediaView`</li>
            <li>pagePostsServedImpressionsOrganicUnique → chuyển sang `pageMediaView`</li>
            <li>pageVideoViewsUnique → sử dụng `pageVideoViews` cho lượt xem 3 giây không duy nhất</li>
          </ul>
        </li>

        <li>
          Sử dụng `mediaView` / `pageMediaView` cho reach. Một chỉ số kế thừa Total Unique Media Views đã được lên kế hoạch. Các trường vẫn được hỗ trợ như `reactionsByType`, `videoViews`, `mediaView`, `pagePostEngagements`, `pageVideoViews` và `pageVideoViewsPaid` không bị ảnh hưởng.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="11 tháng 5, 2026">
  <ul class="custom-bullets">
    <li>
      **Lỗi tạm thời của YouTube giờ trả về HTTP 503/504 thay vì 500:** Một số lỗi tải lên YouTube trước đây hiển thị dưới dạng HTTP 500 (`code: 176`) giờ trả về HTTP 503 (`code: 454`) hoặc HTTP 504 (`code: 453`). Cả hai phản hồi đều bao gồm `retryAvailable: true`. Các tích hợp khách hàng lọc theo HTTP 500 để thử lại các lần tải lên YouTube nên chuyển sang lọc theo trường `retryAvailable` trên phần body phản hồi. Xem [mã lỗi](/errors/errors-ayrshare) để biết chi tiết.
    </li>
  </ul>
</Update>

<Update label="9 tháng 4, 2026">
  <ul class="custom-bullets">
    <li>
      **Analytics rỗng trả về Lỗi 187:** Yêu cầu [Social Analytics](/apis/analytics/social) hoặc [Post Analytics](/apis/analytics/post) khi không có nền tảng nào trả về dữ liệu giờ trả về `{ "status": "error", "code": 187 }` thay vì `{ "status": "success" }`. Cập nhật bất kỳ mã client nào dựa vào hành vi empty-success trước đó.
    </li>
  </ul>
</Update>

<Update label="31 tháng 3, 2026">
  <ul class="custom-bullets">
    <li>
      **Yêu cầu BYO Key cho X/Twitter:** Tất cả các thao tác X/Twitter thông qua Ayrshare sẽ yêu cầu thông tin đăng nhập API của riêng bạn. Sau khi liên kết tài khoản X qua OAuth, hãy bao gồm 2 header trong mỗi yêu cầu X/Twitter: `X-Twitter-OAuth1-Api-Key` và `X-Twitter-OAuth1-Api-Secret`. Các yêu cầu không có thông tin đăng nhập hợp lệ sẽ bị từ chối. Xem [Hướng dẫn Thiết lập X BYO Key](/dashboard/connect-social-accounts/x-twitter-byo-keys) để biết hướng dẫn.
    </li>

    <li>
      **RSS-to-X bị Ngừng Hỗ trợ:** Tự động đăng RSS lên X/Twitter sẽ không còn được hỗ trợ sau ngày 31 tháng 3, 2026. RSS feed chạy theo lịch mà không có thông tin đăng nhập theo yêu cầu, không tương thích với mô hình BYO key. Tự động đăng RSS trên tất cả các nền tảng khác không bị ảnh hưởng.
    </li>

    <li>
      **Webhook Account Activity X bị Ngừng Hỗ trợ:** Hành động webhook X Account Activity (`accountActivity`) sẽ không còn khả dụng sau ngày 31 tháng 3, 2026. Điều này bao gồm tất cả các thông báo sự kiện thời gian thực cho các tài khoản X đã liên kết (bài đăng, đề cập, DM, thích, theo dõi, chặn, v.v.).
    </li>
  </ul>
</Update>

<Update label="14 tháng 11, 2025">
  <ul class="custom-bullets">
    <li>
      Bắt đầu từ ngày 14 tháng 11, 2025, Facebook sẽ ngừng hỗ trợ các trường sau cho [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 → chuyển sang `pageMediaView`</li>
        <li>pageImpressionsPaidUnique → chuyển sang `pageMediaViewIsFromAds`</li>
        <li>pageImpressionsUnique</li>
        <li>pageImpressionsViral</li>
        <li>pageImpressionsViralUnique</li>
        <li>pageImpressionsPaid → chuyển sang `pageMediaViewIsFromAds`</li>
      </ul>
    </li>

    <li>
      Bắt đầu từ ngày 14 tháng 11, 2025, Facebook sẽ ngừng hỗ trợ các trường sau cho [GET analytics/post](/apis/analytics/post):

      <ul class="custom-bullets">
        <li>impressions và impressionsFanPaidUnique → chuyển sang `mediaView`. Các phân tích chi tiết có sẵn qua `mediaViewIsFromAds` (lượt xem được gán cho quảng cáo) và `mediaViewIsFromFollowers` (lượt xem được gán cho người theo dõi).</li>
        <li>postImpressionsUnique (Reels) → sử dụng `blueReelsPlayCount` cho số lần phát reel hoặc `postVideoViewTime` cho tổng thời gian xem.</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1 tháng 9, 2025">
  <ul class="custom-bullets">
    <li>
      Bắt đầu từ ngày 1 tháng 9, 2025, điểm cuối [get comments](/apis/comments/get-comments) cho
      Instagram sẽ không còn bao gồm trường `text` trong các đối tượng reply. Sử dụng trường `comment`
      thay thế để truy cập nội dung reply.
    </li>
  </ul>
</Update>

<Update label="1 tháng 6, 2025">
  <ul class="custom-bullets">
    <li>
      Điểm cuối X (Twitter) [get comments](/apis/comments/get-comments) sẽ di chuyển các chỉ số
      công khai của người dùng sang đối tượng `publicMetrics` mới. Các trường sau sẽ được di chuyển từ cấp
      top-level sang đối tượng `publicMetrics`:

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

    <li>
      Facebook sẽ ngừng hỗ trợ các trường sau cho [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 tháng 5, 2025">
  <ul class="custom-bullets">
    <li>
      YouTube đã ngừng cài đặt các vùng được phép và bị chặn. Bạn vẫn có thể thêm các vùng
      được phép và bị chặn vào điểm cuối post, nhưng chúng sẽ bị bỏ qua.
    </li>
  </ul>
</Update>

<Update label="20 tháng 4, 2025">
  <ul class="custom-bullets">
    <li>
      Các chỉ số sau cho [Instagram post analytics](/apis/analytics/post) sẽ bị ngừng hỗ trợ:

      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>
      [Điểm cuối history](/apis/history/get-history) sẽ thực thi cache trong 1 phút nếu `limit` lớn hơn giá trị mặc định là 25.
    </li>
  </ul>
</Update>

<Update label="1 tháng 3, 2025">
  Điểm cuối [get comments](/apis/comments/get-comments) cho TikTok sẽ chuẩn hóa tên trường
  để khớp với các mạng xã hội khác.

  <ul class="custom-bullets">
    <li>
      Trường `replyList` sẽ được đổi tên thành `replies` và `profileImage` sẽ được đổi tên thành
      `profileImageUrl`.
    </li>

    <li>Cả hai tên trường mới đã có sẵn và có thể được sử dụng trong tích hợp của bạn.</li>

    <li>
      TikTok có các cập nhật sau:

      <ul class="custom-bullets">
        <li>
          Điểm cuối [social analytics](/apis/analytics/social): Các thay đổi sau đang đến: •
          Trường `durationAverage` sẽ bị ngừng hỗ trợ và xóa. • Do hạn chế API của TikTok
          các trường `shareCountTotal`, `viewCountTotal` và `commentCountTotal` sẽ
          chỉ trả về tổng cho 60 ngày qua thay vì tổng của mọi thời gian. • Để bắt đầu sử dụng
          tổng 60 ngày ngay bây giờ, thêm `period60Days: true` vào body của yêu cầu API. Lưu ý: Sử dụng
          tham số này sẽ cải thiện đáng kể thời gian phản hồi.
        </li>

        <li>
          Các điểm cuối [history platform](/apis/history/history-platform) và [post
          analytics](/apis/analytics/post): Các trường không có tài liệu `caption`, `comments`,
          `shares`, `likes`, `shareUrl` và `itemsId` sẽ bị xóa - các trường `post`,
          `commentsCount`, `sharesCount`, `likesCount`, `postUrl` và `id` nên được sử dụng thay thế.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1 tháng 2, 2025">
  Điểm cuối [/user](/apis/user/profile-details) đang thay đổi cách nó báo cáo việc sử dụng API:

  <ul class="custom-bullets">
    <li>
      Trường `monthlyApiCalls` sẽ được mở rộng để đếm tất cả các lệnh gọi API (bài đăng, bình luận,
      phân tích, v.v.).
    </li>

    <li>Đối với số lượng bài đăng cụ thể, hãy sử dụng trường `monthlyPostCount` mới.</li>

    <li>
      Trường `monthlyApiCallsQuota` sẽ bị ngừng hỗ trợ và thay thế bằng trường `monthlyPostQuota`
      mới.
    </li>
  </ul>
</Update>

<Update label="5 tháng 1, 2025">
  <ul class="custom-bullets">
    <li>
      Meta đang ngừng hỗ trợ trường `videoViews` trên [điểm cuối post analytics](/apis/analytics/post) của Instagram.
    </li>

    <li>
      Ngoài ra, các trường `emailContactsCount`, `getDirectionClicks`, `profileViewsCount`,
      `textMessageClicks`, `websiteClicksCount` và `phoneCallClicksCount` sẽ bị xóa
      khỏi điểm cuối [social analytics](/apis/analytics/social) của Instagram.
    </li>

    <li>Các trường này sẽ bị xóa vào ngày 5 tháng 1, 2025.</li>
  </ul>
</Update>

<Update label="15 tháng 12, 2024">
  <ul class="custom-bullets">
    <li>
      Để tăng cường bảo mật, chúng tôi sẽ ngăn Profile Key được sử dụng làm API Key. Nếu bạn
      cố gắng sử dụng Profile Key thay cho API Key, hệ thống sẽ trả về lỗi. [Xem
      tại đây](/apis/overview#authorization) để biết cách sử dụng Profile Key đúng cách.
    </li>
  </ul>
</Update>

<Update label="15 tháng 11, 2024">
  <ul class="custom-bullets">
    <li>
      Chúng tôi đã cập nhật cách báo cáo lỗi cho webhook được lên lịch của TikTok. Những lỗi này giờ sẽ
      xuất hiện trong mảng errors, nhất quán với cách xử lý lỗi của chúng tôi cho các loại webhook được lên lịch
      khác. Lưu ý, các lỗi ở cấp top-level hiện tại vẫn sẽ được trả về, nhưng chúng tôi khuyến khích sử dụng
      mảng errors.
    </li>

    <li>
      Điểm cuối history giờ sẽ trả về các phản hồi dưới dạng object theo mặc định. Tham số objResponse
      sẽ được đặt thành true tự động.
    </li>

    <li>
      Get All History LinkedIn sẽ trả về một mảng cho đối tượng mediaUrls. Trước đây một object
      được trả về nếu chỉ có một mục media và một mảng nếu có nhiều mục media. Bây giờ một mảng sẽ
      luôn được trả về ngay cả khi chỉ có một mục media duy nhất. Nếu bạn cần hành vi trước đó,
      bạn có thể sử dụng tham số truy vấn `objResponse: false`.
    </li>
  </ul>
</Update>

<Update label="7 tháng 10, 2024">
  <ul class="custom-bullets">
    <li>
      Điểm cuối media sẽ không còn trả về url\_1080. Nếu bạn cần thay đổi kích thước hình ảnh, vui lòng
      xem [điểm cuối resize](/apis/media/resize).
    </li>
  </ul>
</Update>

<Update label="16 tháng 9, 2024">
  <ul class="custom-bullets">
    <li>
      **Cập nhật 25 tháng 9, 2024**: Meta (Facebook) đã phát hành việc ngừng hỗ trợ các trường, do đó
      việc xóa các trường có hiệu lực. Vui lòng xem cập nhật được trả về trong [social
      analytics](/apis/analytics/social).
    </li>

    <li>
      Facebook sẽ [ngừng hỗ trợ một số
      trường](https://developers.facebook.com/docs/pages-api/changelog/). [Điểm cuối social analytics
      ](/apis/analytics/social-by-id) sẽ không còn trả về các trường này sau ngày 16 tháng 9,
      2024\.
    </li>
  </ul>
</Update>

<Update label="3 tháng 6, 2024">
  <ul class="custom-bullets">
    <li>
      Hệ thống [rút gọn liên kết mới](/apis/links/overview) sẽ thay thế điểm cuối shortener,
      đã bị Google ngừng hỗ trợ. Bộ rút gọn liên kết mới yêu cầu tiện ích bổ sung [Max
      Pack](/additional/maxpack).
    </li>

    <li>
      Rút gọn liên kết sẽ tắt (`false`) theo mặc định. Để tự động rút gọn liên kết, hãy sử dụng
      `shortenLinks: true` trong lệnh gọi điểm cuối post, sử dụng [điểm cuối link
      mới](/apis/links/overview).
    </li>
  </ul>
</Update>

<Update label="22 tháng 4, 2024">
  <ul class="custom-bullets">
    <li>
      Meta sẽ ngừng hỗ trợ API Facebook Groups của họ. Vui lòng xem
      [thông báo](https://www.ayrshare.com/blog/facebook-removes-groups-api-access-impact-and-implications/).
    </li>
  </ul>
</Update>

<Update label="16 tháng 4, 2024">
  <ul class="custom-bullets">
    <li>
      Instagram đã làm rõ khoảng thời gian của tập dữ liệu online followers. Vui lòng xem tại đây để biết
      [chi tiết](/apis/analytics/instagram-follower-count).
    </li>
  </ul>
</Update>

<Update label="1 tháng 4, 2024">
  <ul class="custom-bullets">
    <li>
      Phản hồi mặc định của [Reply to comment with comment ID](/apis/comments/reply-to-comment) sẽ là
      một object như được liệt kê trong tài liệu thay vì một Array. Bạn có thể sử dụng tham số objResponse đặt
      thành boolean `false` nếu muốn giữ phản hồi Array.
    </li>
  </ul>
</Update>

<Update label="25 tháng 1, 2024">
  <ul class="custom-bullets">
    <li>
      [Điểm cuối retry post](/apis/post/retry-post) sẽ trả về trạng thái "pending" thay vì
      "success" để phản ánh tốt hơn trạng thái của việc thử lại.
    </li>

    <li>
      [Các thay đổi API về scheduleDate và
      createDate](/whatsnew/upcoming-api-changes#changes-in-effect-june-17-2022) sẽ được phát hành.
    </li>
  </ul>
</Update>

<Update label="8 tháng 12, 2023">
  <ul class="custom-bullets">
    <li>
      Các trường `caption`, `message`, `createdTime` và `timestamp` của điểm cuối `/history/instagram`
      đã bị ngừng hỗ trợ vào ngày 1 tháng 4, 2023 và sẽ bị xóa. Vui lòng sử dụng các trường `post` và
      `created`.
    </li>

    <li>
      Trường `mediaUrls` của điểm cuối `/history/linkedin` sẽ được trả về dưới dạng mảng thay vì
      object để hỗ trợ nhiều hình ảnh. Bạn có thể ép trả về mảng ngay bây giờ bằng cách bao gồm
      tham số truy vấn LinkedIn `?multiMedia=true`. Xin lưu ý, trước ngày 1 tháng 12, 2023, tham số truy vấn
      `multiMedia` phải được sử dụng để trả về phương tiện với nhiều hình ảnh. Sau ngày 1 tháng
      12, 2023 nhiều hình ảnh sẽ được trả về theo mặc định.
    </li>

    <li>
      Webhook Scheduled Action của TikTok sẽ có String `platform` bị ngừng hỗ trợ. Vui lòng sử dụng trường
      mảng `platforms` như được thực hiện cho các webhook Scheduled Action khác.
    </li>

    <li>Tài liệu delete comment đã được sửa để phù hợp với kết quả trả về đúng.</li>

    <li>
      Trường commentId của TikTok sẽ được thay thế bằng trường id để phù hợp với định dạng xóa
      bình luận tiêu chuẩn.
    </li>

    <li>
      Kết quả trả về delete comment của Twitter sẽ không còn chứa mảng `posts` để phản hồi phù hợp
      với định dạng xóa bình luận tiêu chuẩn. Kết quả trả về mới sẽ như sau:
    </li>
  </ul>
</Update>

<Update label="18 tháng 10, 2023">
  <ul class="custom-bullets">
    <li>
      Các trường YouTube của [điểm cuối social analytics](/apis/analytics/social) sau sẽ được
      trả về dưới dạng số thay vì giá trị String.
    </li>
  </ul>
</Update>

<Update label="30 tháng 5, 2023">
  <ul class="custom-bullets">
    <li>
      Chúng tôi đã nâng cấp lên phiên bản API mới của Twitter là 2. Twitter đã ngừng hỗ trợ một số trường trong Phiên bản
      2, ảnh hưởng đến các điểm cuối /analytics/social và getAllHistory. Các trường sau
      vẫn sẽ được trả về cho đến ngày 1 tháng 9, 2023, nhưng sẽ có giá trị bằng không hoặc chuỗi rỗng.
    </li>
  </ul>
</Update>

<Update label="8 tháng 5, 2023">
  <ul class="custom-bullets">
    <li>
      Chúng tôi vui mừng ra mắt [đăng bài trực tiếp TikTok](/apis/post/social-networks/tiktok), quản lý
      bình luận và phân tích nâng cao. Người dùng của bạn sẽ không cần mở ứng dụng di động TikTok của họ
      để đăng và nhập văn bản chú thích. Bây giờ sau khi gửi qua Ayrshare, video TikTok và
      chú thích được xuất bản trực tiếp.
    </li>

    <li>
      Chúng tôi cũng giới thiệu việc thêm, lấy và xóa bình luận TikTok + dữ liệu phân tích
      nhân khẩu học.
    </li>

    <li>
      Người dùng của bạn sẽ cần hủy liên kết và liên kết lại tài khoản TikTok của họ để bật đăng bài trực tiếp.
      Các kết nối hiện có sẽ tiếp tục với phương pháp gián tiếp và yêu cầu ứng dụng di động TikTok
      để xuất bản.
    </li>
  </ul>
</Update>

<Update label="17 tháng 2, 2023">
  <ul class="custom-bullets">
    <li>
      Google Business Profile đã thay đổi dữ liệu phân tích xã hội có sẵn. Các trường
      mới có sẵn như sau. Các trường trước đó vẫn sẽ hiện diện, nhưng với giá trị bằng
      không và được xóa hoàn toàn vào ngày 17 tháng 3, 2023.
    </li>
  </ul>
</Update>

<Update label="1 tháng 10, 2022">
  <ul class="custom-bullets">
    <li>Các trường mô tả, văn bản, tin nhắn của Get All Posts được chuẩn hóa thành trường `post`.</li>
  </ul>
</Update>

<Update label="12 tháng 9, 2022">
  <ul class="custom-bullets">
    <li>Các trường TikTok bị ngừng hỗ trợ: `shareUrl`. Sử dụng `postUrl` thay thế.</li>
  </ul>
</Update>

<Update label="17 tháng 6, 2022">
  <ul class="custom-bullets">
    <li>
      Đối với tất cả các điểm cuối history, các trường `createdAt`, `createdTime` và `timestamp` sẽ được
      thay thế bằng trường `created` trả về thời gian tạo theo định dạng UTC.
    </li>

    <li>
      Trường `scheduleDate` sẽ không còn trả về một Object bằng String chứa thời gian
      lên lịch theo định dạng UTC.
    </li>

    <li>
      Trường không có tài liệu `created_date` trên /history sẽ bị xóa. Sử dụng `created` thay thế.
    </li>
  </ul>
</Update>

<Update label="22 tháng 4, 2022">
  <ul class="custom-bullets">
    <li>
      Phân tích trên một [Facebook post](/apis/analytics/post) trả về `reactions` dưới dạng một object theo
      định dạng sau.
    </li>
  </ul>
</Update>

<Update label="1 tháng 4, 2022">
  <ul class="custom-bullets">
    <li>
      History theo mặc định sẽ trả về 20 bài đăng cuối cùng. Có thể trả về tối đa 500 với tham số
      `lastRecords`.
    </li>
  </ul>
</Update>