Chuyển đến nội dung chính
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 để biết tất cả các tính năng mới.
​
15 tháng 6, 2026
  • 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 để biết chi tiết.
    • GET analytics/post không còn trả về các trường Facebook sau:
      • impressionsUnique → chuyển sang mediaView
      • impressionsFanUnique → chuyển sang mediaView
      • impressionsOrganicUnique → chuyển sang mediaView
      • impressionsPaidUnique → chuyển sang mediaViewIsFromAds
      • videoViewsUnique → sử dụng videoViews cho lượt xem 3 giây không duy nhất
      • Các họ totalVideoViews*Unique và totalVideoImpressions* (ví dụ totalVideoViewsOrganicUnique, totalVideoViewsPaidUnique, totalVideoViewsUnique)
    • GET analytics/social không còn trả về các trường Facebook sau:
      • Họ pagePostsImpressions* (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*) → chuyển sang pageMediaView
      • pagePostsServedImpressionsOrganicUnique → chuyển sang pageMediaView
      • pageVideoViewsUnique → sử dụng pageVideoViews cho lượt xem 3 giây không duy nhất
    • 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.
​
11 tháng 5, 2026
  • 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 để biết chi tiết.
​
9 tháng 4, 2026
  • Analytics rỗng trả về Lỗi 187: Yêu cầu Social Analytics hoặc Post Analytics 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 đó.
​
31 tháng 3, 2026
  • 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 để biết hướng dẫn.
  • 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.
  • 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.).
​
14 tháng 11, 2025
  • 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:
    • pageFans
    • pageFansCity
    • pageFansLocale
    • pageFansCountry
    • pageFansAdds
    • pageFanAddsUnique
    • pageFanRemoves
    • pageFanRemovesUnique
    • pageImpressions → chuyển sang pageMediaView
    • pageImpressionsPaidUnique → chuyển sang pageMediaViewIsFromAds
    • pageImpressionsUnique
    • pageImpressionsViral
    • pageImpressionsViralUnique
    • pageImpressionsPaid → chuyển sang pageMediaViewIsFromAds
  • 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:
    • 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).
    • postImpressionsUnique (Reels) → sử dụng blueReelsPlayCount cho số lần phát reel hoặc postVideoViewTime cho tổng thời gian xem.
​
1 tháng 9, 2025
  • Bắt đầu từ ngày 1 tháng 9, 2025, điểm cuối 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.
​
1 tháng 6, 2025
  • Điểm cuối X (Twitter) 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:
    • followersCount
    • followingCount
    • tweetCount
    • listedCount
    • mediaCount
  • Facebook sẽ ngừng hỗ trợ các trường sau cho GET analytics/social:
    • pageVideoViews10S
    • pageVideoViews10SAutoplayed
    • pageVideoViews10SClickToPlay
    • pageVideoViews10SOrganic
    • pageVideoViews10SPaid
    • pageVideoViews10SRepeat
    • pageVideoViews10SUnique
​
7 tháng 5, 2025
  • 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.
​
20 tháng 4, 2025
  • Các chỉ số sau cho Instagram post analytics sẽ bị ngừng hỗ trợ:REELS:
    • playsCount
    • clipsReplaysCount
    • igReelsAggregatedAllPlaysCount
    FEED/STORY:
    • impressionsCount
  • Điểm cuối history sẽ thực thi cache trong 1 phút nếu limit lớn hơn giá trị mặc định là 25.
​
1 tháng 3, 2025
Điểm cuối 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.
  • Trường replyList sẽ được đổi tên thành replies và profileImage sẽ được đổi tên thành profileImageUrl.
  • 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.
  • TikTok có các cập nhật sau:
    • Điểm cuối social analytics: 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.
    • Các điểm cuối history platform và post analytics: 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ế.
​
1 tháng 2, 2025
Điểm cuối /user đang thay đổi cách nó báo cáo việc sử dụng API:
  • 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.).
  • Đối với số lượng bài đăng cụ thể, hãy sử dụng trường monthlyPostCount mới.
  • Trường monthlyApiCallsQuota sẽ bị ngừng hỗ trợ và thay thế bằng trường monthlyPostQuota mới.
​
5 tháng 1, 2025
  • Meta đang ngừng hỗ trợ trường videoViews trên điểm cuối post analytics của Instagram.
  • 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 của Instagram.
  • Các trường này sẽ bị xóa vào ngày 5 tháng 1, 2025.
​
15 tháng 12, 2024
  • Để 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 để biết cách sử dụng Profile Key đúng cách.
​
15 tháng 11, 2024
  • 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.
  • Đ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.
  • 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.
​
7 tháng 10, 2024
  • Đ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.
​
16 tháng 9, 2024
​
3 tháng 6, 2024
  • Hệ thống rút gọn liên kết mới 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.
  • 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.
​
22 tháng 4, 2024
  • Meta sẽ ngừng hỗ trợ API Facebook Groups của họ. Vui lòng xem thông báo.
​
16 tháng 4, 2024
  • 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.
​
1 tháng 4, 2024
  • Phản hồi mặc định của Reply to comment with comment ID 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.
​
25 tháng 1, 2024
​
8 tháng 12, 2023
  • 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.
  • 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.
  • 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.
  • Tài liệu delete comment đã được sửa để phù hợp với kết quả trả về đúng.
  • 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.
  • 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:
​
18 tháng 10, 2023
​
30 tháng 5, 2023
  • 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.
​
8 tháng 5, 2023
  • Chúng tôi vui mừng ra mắt đăng bài trực tiếp 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.
  • 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.
  • 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.
​
17 tháng 2, 2023
  • 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.
​
1 tháng 10, 2022
  • 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.
​
12 tháng 9, 2022
  • Các trường TikTok bị ngừng hỗ trợ: shareUrl. Sử dụng postUrl thay thế.
​
17 tháng 6, 2022
  • Đố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.
  • 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.
  • Trường không có tài liệu created_date trên /history sẽ bị xóa. Sử dụng created thay thế.
​
22 tháng 4, 2022
  • Phân tích trên một Facebook post trả về reactions dưới dạng một object theo định dạng sau.
​
1 tháng 4, 2022
  • 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.