> ## 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. # Lịch sử bài đăng cho một nền tảng > Lịch sử các bài đăng đã gửi cho một nền tảng, bao gồm cả các bài đăng không bắt nguồn từ Ayrshare export const XByoNotice = () => Targeting X/Twitter? Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:

X-Twitter-OAuth1-Api-Key — Your API Key (Consumer Key)
X-Twitter-OAuth1-Api-Secret — Your API Key Secret (Consumer Secret)

One-time setup per Ayrshare account. You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do not create a new app per customer.

Not linked yet? See the full setup guide to connect your X account.

Your keys are never logged or stored by Ayrshare. ; export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <> API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY {!noProfileKey && (profileKeyRequired ? Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY : Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY )} ; export const PlansAvailable = ({plans = [], maxPackRequired}) => { let displayPlans = plans; if (plans && plans.length === 1) { const lowerCasePlan = plans[0].toLowerCase(); if (lowerCasePlan === "business") { displayPlans = ["Launch", "Business", "Enterprise"]; } else if (lowerCasePlan === "premium") { displayPlans = ["Premium", "Launch", "Business", "Enterprise"]; } } return Available on {displayPlans.length === 1 ? "the " : ""} {displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "} {displayPlans.length > 1 ? "plans" : "plan"}. {maxPackRequired && window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer"> Max Pack required } ; }; Endpoint này cho phép bạn truy xuất cả các bài đăng và phân tích của chúng từ các mạng xã hội chính (Bluesky, Facebook, Instagram, LinkedIn, Pinterest, Threads, TikTok, X/Twitter và YouTube). Nó hoạt động cho tất cả các bài đăng trên các nền tảng này - dù chúng được tạo bằng API của Ayrshare hay được đăng trực tiếp thông qua giao diện của mạng xã hội. Có thể xem phân tích chi tiết hơn với [endpoint analytics](/apis/analytics/overview). Các ID được trả về từ endpoint này là [social post ID](/apis/overview#social-post-id) gốc của mạng xã hội chứ không phải [Ayrshare post ID](/apis/overview#ayrshare-post-id). Điều này cho phép bạn nhận thông tin chi tiết cho bất kỳ bài đăng nào trên mạng xã hội, ngay cả khi nó không được tạo thông qua Ayrshare. Ví dụ: bạn có thể truy xuất một bài đăng được đăng thủ công trên facebook.com và sử dụng [Social Post ID](/apis/overview#social-post-id) của Facebook được trả về để [lấy bình luận](/apis/comments/get-comments) hoặc [lấy phân tích](/apis/analytics/social-by-id). Nếu bạn không cần các bài đăng có nguồn gốc bên ngoài Ayrshare, chỉ cần sử dụng [Ayrshare post ID](/apis/overview#ayrshare-post-id) được trả về trong một bài đăng với các endpoint [comment](/apis/comments/post-comment), [analytics](/apis/analytics/post), hoặc [history](/apis/history/history-social-id). `:platform` = `bluesky`, `facebook`, `instagram`, `linkedin`, `pinterest`, `snapchat`, `threads`, `tiktok`, `twitter`, `youtube`. Ví dụ: `https://api.ayrshare.com/api/history/instagram` ### Media có bản quyền Instagram và TikTok sẽ loại trừ tất cả media có bản quyền trong phản hồi của chúng. ### Giới hạn #### Facebook #### Instagram ## Header Parameters ## Path Parameters Nền tảng của các bài đăng cần truy xuất. Giá trị: `bluesky`, `facebook`, `instagram`, `linkedin`, `pinterest`, `snapchat`, `threads`, `tiktok`, `twitter`, `youtube`. ## Query Parameters Số lượng bản ghi lịch sử cần trả về. Giới hạn tối đa: 500\* Giới hạn cao có thể dẫn đến thời gian phản hồi chậm hơn, vì vậy chúng tôi khuyến nghị sử dụng giới hạn không quá 100. \*Giới hạn cao hơn có sẵn trên các gói Enterprise. Vui lòng liên hệ account manager của bạn để biết thêm chi tiết. Bỏ qua việc thu thập phân tích đầy đủ cho các Facebook Pages và Instagram. Chỉ trả về Social Post ID. Nên sử dụng nếu không cần phân tích (chỉ cần Social Post ID), để có phản hồi nhanh hơn, hoặc khi xảy ra lỗi ở limit > 100. Chỉ dành cho Facebook. Theo mặc định, các bài đăng được trả về là từ feed của Facebook Page. Bạn cũng có thể chọn chỉ trả về các bài đăng được đăng bởi page. Sử dụng feed (mặc định) khi bạn muốn có cái nhìn toàn diện hơn về tất cả nội dung liên quan đến page, bao gồm cả tương tác từ những người dùng khác. Sử dụng `pagePublished` khi bạn chỉ muốn truy xuất các bài đăng do chính page thực hiện. Chỉ dành cho X/Twitter. Tham số này cho phép bạn truy xuất các bài đăng từ một người dùng X/Twitter cụ thể theo ID số của họ, thay vì từ tài khoản đã liên kết của bạn. Ví dụ, để lấy tất cả các bài đăng từ handle `@Google`, bạn sẽ sử dụng userId số của họ là `20536157`. Bạn có thể tìm userId số của bất kỳ người dùng X/Twitter nào bằng cách sử dụng endpoint [Brands Get User](/apis/listen/brand-user). Lưu ý: Chỉ sử dụng API KEY trong header để thực hiện yêu cầu này. Không bao gồm Profile Key. Chỉ dành cho X/Twitter. Tham số này cho phép bạn truy xuất các bài đăng từ một người dùng X/Twitter cụ thể theo handle của họ, thay vì từ tài khoản đã liên kết của bạn. Ví dụ, để lấy tất cả các bài đăng từ handle `@Google`. Lưu ý: Chỉ sử dụng API KEY trong header để thực hiện yêu cầu này. Không bao gồm Profile Key. Phân trang dựa trên cursor để truy xuất trang kết quả tiếp theo. Truyền giá trị `next` từ đối tượng `meta.pagination` của phản hồi trước đó để lấy tập bài đăng tiếp theo. Chỉ dành cho Facebook. Chuỗi ngày ISO UTC để lọc các bài đăng được tạo vào hoặc sau ngày này. Sử dụng cùng với `until` cho một khoảng ngày cụ thể. Ví dụ: `since=2026-03-17` Chỉ dành cho Facebook. Chuỗi ngày ISO UTC để lọc các bài đăng được tạo vào hoặc trước ngày này. Sử dụng cùng với `since` cho một khoảng ngày cụ thể. Ví dụ: `until=2026-03-20` Facebook và Instagram. Lọc loại nội dung được trả về. Theo mặc định, cả bài đăng thông thường và các Stories đang hoạt động đều được trả về. Giá trị: * `posts` — chỉ các bài đăng thông thường (không có Stories) * `stories` — chỉ Stories Bỏ qua tham số này để trả về cả bài đăng và Stories (hành vi mặc định). Lưu ý: Đối với Facebook, các Stories đã hết hạn/lưu trữ (cũ hơn 24 giờ) sẽ tự động bị lọc ra. Đối với Instagram, Stories chỉ có sẵn trong 24 giờ. ## Phản hồi phân trang Khi sử dụng phân trang dựa trên cursor (với tham số truy vấn `next`), phản hồi sẽ bao gồm đối tượng `meta.pagination` chứa trạng thái phân trang. Mảng `posts` trong mỗi phản hồi được phân trang chứa các đối tượng có cùng cấu trúc như được hiển thị trong các ví dụ phản hồi bên dưới cho từng nền tảng. Metadata phân trang để điều hướng dựa trên cursor qua các kết quả. Cho biết có thêm kết quả nữa ngoài trang hiện tại hay không. Khi `true`, hãy sử dụng cursor `next` để lấy thêm bài đăng. Một chuỗi cursor opaque để truyền dưới dạng tham số truy vấn `next` để truy xuất trang kết quả tiếp theo. Chỉ có mặt khi `hasMore` là `true` hoặc khi có nhiều kết quả để lấy. Số lượng kết quả được yêu cầu trên mỗi trang. ```javascript cURL theme={"system"} curl \ -H "Authorization: Bearer API_KEY" \ -X GET https://api.ayrshare.com/api/history/instagram ``` ```bash cURL Facebook with Filters theme={"system"} # Get only regular posts (no Stories) within a date range curl \ -H "Authorization: Bearer API_KEY" \ -X GET "https://api.ayrshare.com/api/history/facebook?limit=20&since=2026-03-17&until=2026-03-20&dataType=posts" ``` ```bash cURL with Pagination theme={"system"} # First request curl \ -H "Authorization: Bearer API_KEY" \ -X GET "https://api.ayrshare.com/api/history/twitter?limit=10" # Next page request (use 'next' cursor from previous response) curl \ -H "Authorization: Bearer API_KEY" \ -X GET "https://api.ayrshare.com/api/history/twitter?limit=10&next=eyJ0b2tlbiI6IjE3MzkyNjg1MTQ0ODU3MTUi..." ``` ```javascript JavaScript theme={"system"} const API_KEY = "API_KEY"; fetch("https://api.ayrshare.com/api/history/instagram", { method: "GET", headers: { "Authorization": `Bearer ${API_KEY}` } }) .then((res) => res.json()) .then((json) => console.log(json)) .catch(console.error); ``` ```javascript JavaScript with Pagination theme={"system"} const API_KEY = "API_KEY"; // Function to fetch posts with pagination (up to maxPosts or until cutoffTime) async function fetchPosts(platform, { limit = 25, maxPosts = 100, cutoffTime = null } = {}) { const posts = []; let nextCursor = null; let pagePosts = []; do { const url = new URL(`https://api.ayrshare.com/api/history/${platform}`); url.searchParams.set("limit", limit); if (nextCursor) { url.searchParams.set("next", nextCursor); } const response = await fetch(url, { method: "GET", headers: { "Authorization": `Bearer ${API_KEY}` } }); const data = await response.json(); pagePosts = data.posts || []; // Filter by date if cutoffTime is specified if (cutoffTime) { pagePosts = pagePosts.filter(post => new Date(post.created) >= cutoffTime); } posts.push(...pagePosts); // Get cursor for next page nextCursor = data.meta?.pagination?.hasMore ? data.meta.pagination.next : null; } while (nextCursor && pagePosts.length > 0 && posts.length < maxPosts); return posts.slice(0, maxPosts); } // Fetch up to 100 Twitter posts fetchPosts("twitter", { maxPosts: 100 }).then(posts => console.log(posts)); // Fetch posts from the last 30 days (up to 200) const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000); fetchPosts("twitter", { maxPosts: 200, cutoffTime: thirtyDaysAgo }).then(posts => console.log(posts)); ``` ```python Python theme={"system"} import requests headers = {'Authorization': 'Bearer API_KEY'} r = requests.get('https://api.ayrshare.com/api/history/instagram', headers=headers) print(r.json()) ``` ```php PHP theme={"system"} true, CURLOPT_HTTPHEADER => $headers ]); $response = curl_exec($curl); if ($response === false) { echo 'Curl error: ' . curl_error($curl); } else { echo json_encode(json_decode($response), JSON_PRETTY_PRINT); } curl_close($curl); ``` ```csharp C# theme={"system"} using System; using System.Net.Http; using System.Threading.Tasks; namespace HistoryPlatformGETRequest_csharp { class HistoryPlatform { static async Task Main(string[] args) { string API_KEY = "API_KEY"; string url = "https://api.ayrshare.com/api/history/TBEAAqAMMJoweA9wKHUl"; using (var client = new HttpClient()) { client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY); try { var response = await client.GetStringAsync(url); Console.WriteLine(response); } catch (HttpRequestException ex) { Console.WriteLine($"Error: {ex.Message}"); } } } } } ``` ```json 200: Success {4, 23, 161, 216, 287, 367, 488, 672} theme={"system"} { "status": "success", "posts": [ // Bluesky Response Example { "cid": "bafyreigh7nz7x6pl4atgsextqtcbh33mg66yqt3caeihutn7ojkmpdtnzm", // Bluesky Content ID "created": "2025-01-06T21:35:08.951Z", "id": "at://did:plc:n7atrjd22xgkmgwig6dzlhzd/app.bsky.feed.post/3lfb57nxgxs2e", // Bluesky Social Post ID "indexedAt": "2025-01-06T21:35:09.156Z", "labels": [], "likeCount": 2, "post": "What a wonderful data day!", "postUrl": "https://bsky.app/profile/ayrshare.com/post/3lf43nl5jis24", "quoteCount": 3, "replyCount": 2, "repostCount": 1, "viewer": { "threadMuted": false, "embeddingDisabled": false } }, // Facebook Response Example // Note: If the FB page has fewer than 100 likes then not all analytics data available. { "clicksUnique": 31, "created": "2022-06-14T23:43:21Z", "commentsCount": 13, "engagedUsers": 3, "fullPicture": "https://scontent.ford4-1.fna.fbcdn.net/v/t39.30808-6/287997502_758105082307121_n.jpg?stp=dst-jpg_s720x720&_nc_cat=101&ccb=1-7&_nc_sid=8024bb&_nc_ohc=EkktQTp_uWIAX_xtTxV&_nc_ht=scontent.ford4-1.fna&edm=AKK4YLsEAAAA&oh=00_AT-Y5Ht2Pl3MeY-qIBs6BC10SbZ-47Vfcc7DKiQrCnIUA&oe=62AEEECA", "id": "104619420979033_758005082307127", // Facebook Social Post ID "impressionsUnique": 0, "isPopular": false, "lastUpdated": "2022-06-14T23:43:38.359Z", "likeCount": 38, "likedBy": [ // Users who liked the post { "id": "7101149746568432", "name": "John Smith" } ], "mediaUrls": [ // If attached photos or video { "media": { "image": { "height": 412, "src": "https://scontent-lga3-1.xx.fbcdn.net/v/t15.5256-10/294978304_1014487762575117_6279324362130508123_n.jpg?stp=dst-jpg_s720x720&_nc_cat=101&ccb=1-7&_nc_sid=ad6a45&_nc_ohc=y3bYN-PGN0YAX9kO2qn&_nc_ht=scontent-lga3-1.xx&edm=AKK4YLsEAAAA&oh=00_AT9by7D4y4sjY4BW5RW53JO6BaG2UkpUCCJrrugW7GDW9w&oe=62E23000", "width": 720 }, // Source if mediaType is video "source": "https://video-lga3-1.xx.fbcdn.net/v/t39.25447-2/294718581_137662848672158_7246454806912028286_n.mp4?_nc_cat=111&vs=696d8a2ba08f208b&_nc_vs=HBkcFQAYJEdIVU1rUkdlb1RFaE5IMEFBSDdPNmVaQWxKQmtibWRqQUFBRhUAAsgBAEsGiBJwcm9ncmVzc2l2ZV9yZWNpcGUBMQ1zdWJzYW1wbGVfZnBzABB2bWFmX2VuYWJsZV9uc3ViACBtZWFzdXJlX29yaWdpbmFsX3Jlc29sdXRpb25fc3NpbQAoY29tcHV0ZV9zc2ltX29ubHlfYXRfb3JpZ2luYWxfcmVzb2x1dGlvbgARZGlzYWJsZV9wb3N0X3B2cXMAFQAlABwAACac%2FNfk2tKqARWQTigCQzMYC3Z0c19wcmV2aWV3HBdAGZmZmZmZmhhEZGFzaF9pNGxpdGViYXNpY19wYXNzdGhyb3VnaGFsaWduZWRfNDgwX2NyZl8yOF9tYWluXzMuMF9mcmFnXzJfdmlkZW8SABgYdmlkZW9zLnZ0cy5jYWxsYmFjay5wcm9kOBJWSURFT19WSUVXX1JFUVVFU1QbD4gVb2VtX3RhcmdldF9lbmNvZGVfdGFnBm9lcF9zZBNvZW1fcmVxdWVzdF90aW1lX21zATAMb2VtX2NmZ19ydWxlCnNkX3VubXV0ZWQTb2VtX3JvaV9yZWFjaF9jb3VudAI5OBFvZW1faXNfZXhwZXJpbWVudAAMb2VtX3JvaV9ub3RlC3Byb2dyZXNzaXZlEW9lbV9yb2lfdXNlcl90aWVyAB5vZW1fcm9pX3ByZWRpY3RlZF93YXRjaF90aW1lX3MBMBZvZW1fcm9pX3JlY2lwZV9iZW5lZml0BTAuMDAwJW9lbV9yb2lfc3RhdGljX2JlbmVmaXRfY29zdF9ldmFsdWF0b3ILcHJvZ3Jlc3NpdmUMb2VtX3ZpZGVvX2lkEDEyNjk2MTcwNzM3NzgxNTESb2VtX3ZpZGVvX2Fzc2V0X2lkDzc5ODQ2NjE3NDg0NzE4OBVvZW1fdmlkZW9fcmVzb3VyY2VfaWQPMzc1MjU0ODg3ODkwNzAyHG9lbV9zb3VyY2VfdmlkZW9fZW5jb2RpbmdfaWQPNDUwODU0MzgzNjE1MDc5DnZ0c19yZXF1ZXN0X2lkD2EyYThlNWU4OTBkNTRmMyUCHBwcFfDmFxsBVQACGwFVAAIcFQIAAAAWgLq3AwAlxAEbB4gBcwQ1ODkyAmNkCjIwMjItMDctMjQDcmNiATADYXBwBVdhdGNoAmN0GERJUkVDVEVEX1BPU1RfQVRUQUNITUVOVBNvcmlnaW5hbF9kdXJhdGlvbl9zBTYuNDE3AnRzFHByb2dyZXNzaXZlX29yZGVyaW5nAA%3D%3D&ccb=1-7&_nc_sid=a06cc9&_nc_ohc=bA3WO4Dk72QAX9TB9ag&_nc_ht=video-lga3-1.xx&edm=AKK4YLsEAAAA&oh=00_AT_CzNhlIwNxY_7UMWIGQMNOtD-Aw_LGcVHnDWvcQJVkAw&oe=62E2ADE1&_nc_rid=780575090331889" }, "mediaType": "video", // "link" or "photo" "url": "https://www.facebook.com/115237020273490/videos/1269617073778151", "videoId": "1269617073778151" } ], "negativeFeedback": 0, "negativeFeedbackUnique": 0, "nextUpdate": "2022-06-15T00:18:38.359Z", "parentId": "5764771300200609_742258953848744", // If a shared post, then the ID of the original post "post": "What a nice one", "postUrl": "https://www.facebook.com/104619420979033_758105082307121", "properties": [ // for videos only { "name": "Length", "text": "00:07" } ], "reactions": { // Total lifetime "like": 1, // Like reactions - The "like" reaction counts include both "like" and "care" reactions. "love": 1, // Love reactions "anger": 1, // Anger reactions "haha": 1, // Haha reactions "wow": 1, // Wow reactions "sorry": 1, // Sorry reactions "total": 6 // Total number of reactions }, "reactionsByType": 1, "statusType": "added_video", // Status actions: added_photos, added_video, app_created_story, approved_friend, created_event, created_group, created_note, mobile_status_update, published_story, shared_story, tagged_in_photo, wall_post "videoViewTime": 0, "videoViews": 0, "videoViewsUnique": 0 }, { "clicksUnique": 45, "created": "2022-06-14T14:53:01Z", "engagedUsers": 2, "fullPicture": "https://external.ford4-1.fna.fbcdn.net/emg1/v/t13/614683800928174083?url=https%3a%2f%2fwww.alphast.com%2fwp-content%2fuploads%2f2022%2f06%2fheadphones-scaled.jpg&fb_obo=1&utld=fbcdn.net&stp=dst-emg0_q75&ccb=13-1&oh=00_AT-MVM6lP-eWgsqCW6IhImKAJaGy71JIGIntjlVnZkJw&oe=62AAAC5C&_nc_sid=5f3a21", "id": "104619420979033_757752962332339", // Facebook Social Post ID "impressionsUnique": 1, "isPopular": false, "lastUpdated": "2022-06-14T23:40:48.453Z", "mediaUrls": [ { "mediaUrl": "link", "url": "https://www.alphasht.com/finding-the-best-headphones/" } ], "negativeFeedback": 0, "negativeFeedbackUnique": 0, "nextUpdate": "2022-06-15T00:15:48.453Z", "post": "Finding The Best Headphones: Finding the best headphones for you depends on several factors.", "postUrl": "https://www.facebook.com/104619420979033_75775296233233", "reactions": { // Total lifetime "like": 1, // Like reactions - The "like" reaction counts include both "like" and "care" reactions. "love": 1, // Love reactions "anger": 1, // Anger reactions "haha": 1, // Haha reactions "wow": 1, // Wow reactions "sorry": 1, // Sorry reactions "total": 6 // Total number of reactions }, "reactionsByType": 1, "videoViewTime": 0, "videoViews": 0, "videoViewsUnique": 0 }, { // Facebook Story "clicksUnique": 0, "commentsCount": 0, "created": "2024-03-15T19:36:29.000Z", "engagedUsers": 0, "id": "1593984754722429", "impressionsFanPaidUnique": 0, "impressionsFanUnique": 0, "impressionsOrganicUnique": 0, "impressionsPaidUnique": 0, "impressionsUnique": 0, "likeCount": 0, "mediaId": "1593984754722429", "mediaType": "video", "mediaUrls": [ { "media": { "image": { "height": 720, "src": "https://scontent-lga3-1.xx.fbcdn.net/v/t15.5256-10/451306699", "width": 405 }, "source": "https://video-lga3-1.xx.fbcdn.net/o1/v/t2/f2/m69/An_VRpjrlZJxZEUVTHHMpd" }, "mediaType": "video", "type": "story" } ], "negativeFeedback": 0, "negativeFeedbackUnique": 0, "post": "", "postId": "1433249613981178", "postUrl": "https://facebook.com/stories/114251701259415/UzpfSVNDOjE0MzMyNDk2MTczMTQ1MTE=/?view_single=1", "reactions": {}, "reactionsByType": 0, "sharesCount": 0, "statusType": "published", "videoViewTime": 0, "videoViews": 0, "videoViewsUnique": 0 }, // Instagram Response Example { "mediaUrl": "https://scontent.cdninstagram.com/v/t51.2885-15/75317300_249468363049056_6683482523516619964_n.jpg", "permalink": "https://www.instagram.com/p/B5OBT3ygpfg/", "commentsCount": 0, "created": "2022-05-20T17:26:03Z", "likeCount": 0, "mediaProductType": "FEED", // Media product type: AD, FEED, STORY or REELS "mediaType": "IMAGE", // Media type: CAROUSEL_ALBUM, IMAGE, or VIDEO "username": "thegoodone", "id": "17833140557332933", // Instagram Social Post ID "thumbnailUrl": "https://scontent-lga3-2.cdninstagram.com/v/t51.2885-15/277243581_1136333620462129_9111753545576538669_n.jpg", "post": "The #Mandalorian is on tonight instead of Friday", "postUrl": "https://www.instagram.com/p/B5OBT3ygpfg/" // same as permalink }, { "mediaUrl": "https://scontent.cdninstagram.com/v/t51.2885-15/72719989_401282024671549_6704610247561386099_n.jpg", // The media_url field is omitted from responses if the media contains copyrighted material or has been flagged for a copyright violation. Examples of copyrighted material can include audio on reels. "permalink": "https://www.instagram.com/p/B6_EubJFlMI/", "commentsCount": 0, "created": "2022-05-20T17:26:03Z", "likeCount": 0, "mediaProductType": "REELS", // Media product type: AD, FEED, STORY or REELS "mediaType": "VIDEO", // Media type: CAROUSEL_ALBUM, IMAGE, or VIDEO "username": "thegoodone", "id": "17933140557332933", // Instagram Social Post ID "thumbnailUrl": "https://scontent-lga3-2.cdninstagram.com/v/t51.2885-15/277243581_1136333620462129_9111753545576538669_n.jpg", "post": "And finally, number eleven of the best shows of 2019 is #Mandalorian #BabyYoda #Bestof2019", "postUrl": "https://www.instagram.com/p/B6_EubJFlMI/" // same as permalink }, { "commentsCount": 3, "created": "2024-04-29T16:10:10Z", "id": "17998949393616", "isPopular": false, "lastUpdated": "2024-04-29T22:28:20.499Z", "likeCount": 14, "mediaProductType": "FEED", "mediaType": "CAROUSEL_ALBUM", "mediaUrls": [ { "mediaUrl": "https://scontent-lga3-2.cdninstagram.com/v/t51.2885-15/441166659", "id": "18395216701078298" }, { "mediaUrl": "https://scontent-lga3-2.cdninstagram.com/o1/v/t16/f1/m82/834208F324481538FE6E565772BC6B8E_video_dashinit.mp4", "thumbnailUrl": "https://scontent-lga3-2.cdninstagram.com/v/t51.29350-15/440150892_371703612533736_7866608290099350261_n.jpg", "id": "18041898211827161" } ], "nextUpdate": "2024-04-29T22:39:20.499Z", "post": "Learn to value yourself, which means: to fight for your happiness. - Ayn Rand", "postUrl": "https://www.instagram.com/p/C6WgGmSPn/", "username": "johnboy" }, // LinkedIn Response Example { "clickCount": 0, "commentCount": 1, "created": "2022-12-28T16:07:38Z", "engagement": 0.6666666666666666, "id": "urn:li:share:701389826709", // LinkedIn Social Post ID "impressionCount": 3, "lastModified": "2022-12-28T16:07:38Z", "likeCount": 1, "post": "left thirty pocket track flower whistle", "postUrl": "https://www.linkedin.com/feed/update/urn:li:share:701389826709", "publishedAt": "2022-12-28T16:07:38Z", "reactions": { // Get reactions on a LinkedIn share "like": 1, // "Like in the UI "praise": 2, // "Celebrate" in the UI "maybe": 3, // "Curious" in the UI "empathy": 3, // "Love" in the UI "interest": 2 // "Insightful" in the UI "appreciation": 5 // "Support" in the UI }, "shareCount": 0, "status": "PUBLISHED", "uniqueImpressionsCount": 3, "visibility": "PUBLIC" }, { "clickCount": 0, "comments": [ "urn:li:comment:(urn:li:activity:722)" // Look up using the Comments endpoint ], "commentCount": 1, "commentsState": "OPEN", "created": "2022-12-28T17:05:11Z", "engagement": 0.16, // Not available for Personal accounts "id": "urn:li:share:70139127498", // LinkedIn Social Post ID "impressionCount": 12, // Not available for Personal accounts "lastModified": "2022-12-28T17:05:11Z", "likeBy": [ "urn:li:person:Sgwlpf744" // Look up using the brands endpoint ], "likeCount": 1, "likedByCurrentUser": false, "mediaUrls": [ // please see .../ayrshare.com/additional-info/upcoming-api-changes#changes-in-effect-december-1-2023 { "id": "urn:li:video:C4E10AQHz0RMm5aAiAg", "url": "https://media.licdn.com/dms/image/C4E10AQHz0RMm5aAiAg" }, { "id": "urn:li:video:C4E10AQHz0RMm5adsH2", "url": "https://media.licdn.com/dms/image/C4E10AQHz0RMm5adsH2" } ], "post": "no monkey gulf organization mood choose earn", "postUrl": "https://www.linkedin.com/feed/update/urn:li:share:70139127498", "publishedAt": "2022-12-28T17:05:11Z", "reactions": { // Get reactions on a LinkedIn share "like": 1, // "Like in the UI "praise": 2, // "Celebrate" in the UI "maybe": 3, // "Curious" in the UI "empathy": 3, // "Love" in the UI "interest": 2 // "Insightful" in the UI "appreciation": 5 // "Support" in the UI }, "shareCount": 0, // Not available for Personal accounts "status": "PUBLISHED", "uniqueImpressionsCount": 9, // Not available for Personal accounts "totalFirstLevelComments": 1, "visibility": "PUBLIC" }, // Pinterest Response Example { "altText": "", "boardId": "955255839651522358", "coverImageUrl": "https://i.pinimg.com/originals/7e/ea/af/7eeaaf4bce167902b06fe3370227e.jpg", "created": "2022-08-09T22:25:12Z", "dominantColor": "#353027", // Dominant pin color. Hex number, e.g. "#6E7874" "duration": 6416, // Time in millisecord "height": 1062, "id": "7184649418547260", // Pinterest Social Post ID "link": "", "mediaType": "video", "mediaUrl": "https://i.pinimg.com/originals/7e/ea/af/7eeaaf4bce167902b06fe3370227e.jpg", "note": "What a great post", "post": "You are what you believe yourself to be. - Paulo Coelho", "postUrl": "https://www.pinterest.com/pin/7184649418547260", "productTags": [], "title": "My new post", "username": "ayrshare", "width": 1856 }, { "altText": "", "created": "2022-08-09T22:25:12Z", "dominantColor": "#7c7c7c", "height": 600, "id": "7184649468512979", // Pinterest Social Post ID "link": "", "mediaType": "image", "mediaUrl": "https://i.pinimg.com/originals/1b/0a/02/1b0a02123fba55042474b61bb2aa1.jpg", "post": "Peace begins with a smile. - Mother Teresa", "postUrl": "https://www.pinterest.com/pin/7184649468512979", "username": "ayrshare", "width": 600 }, { "altText": "", "created": "2022-10-17T12:26:05Z", "dominantColor": "#7f805e", "id": "36493237618990511", // Pinterest Social Post ID "link": "", "mediaType": "multiple_mixed", "mediaUrls": [ { "mediaType": "image", "height": 442, "width": 249, "mediaUrl": "https://i.pinimg.com/originals/6c/e2/1f/6ce21fa3936b51cd39c34be6f60dd469.jpg" }, { "mediaType": "image", "height": 589, "width": 332, "mediaUrl": "https://i.pinimg.com/originals/9370f0845be155b5640c0f.jpg" }, { "mediaType": "image", "height": 589, "width": 332, "mediaUrl": "https://i.pinimg.com/originals/9370f0845be155b5640c0f.jpg" }, { "mediaType": "image", "height": 589, "width": 332, "mediaUrl": "https://i.pinimg.com/originals/9370f0845be155b5640c0f.jpg" }, { "mediaType": "video", "duration": 19600, "height": 1280, "width": 720, "mediaUrl": "https://i.pinimg.com/videos/thumbnails/originals/9370f0845be155b5640c0f.jpg" } ], "post": " ", "postUrl": "https://www.pinterest.com/pin/36493237618990511", "username": "johnsmith" }, // Snapchat Response Example { "id": "43d61bfe-2249-5a46-944a-d36d27c9530b", "profileId": "43548e97-edf1-44f9-984a-0a38470133", "thumbnailUrl": "https://cf-st.sc-cdn.net/d/fY3MDNOXp0hxLecKdr4hV", "type": "PUBLIC_STORY", // PUBLIC_STORY, SAVED_STORY, or SPOTLIGHT "created": "2025-05-19T19:38:36.789Z", "ended": "2025-05-19T19:38:36.790Z" }, { "id": "07c99fea-1c72-4f72-bcd9-7dacfae753e0", "profileId": "43548e97-edf1-44f9-984a-0a3847023", "thumbnailUrl": "https://cf-st.sc-cdn.net/d/wTf9NQ0mZ4GCDyFj7feQ8", "type": "SAVED_STORY", // PUBLIC_STORY, SAVED_STORY, or SPOTLIGHT "title": "A song about snaps", "created": "2025-05-20T18:09:04.876Z", "updated": "2025-05-20T18:09:04.876Z" }, // TikTok Response Example { "audienceCities": [ { "city_name": "US Teton County", "percentage": 3.1 }, { "city_name": "US Queens", "percentage": 6.3 } ], "audienceCountries": [ { "country": "GB", "percentage": 0.0029 }, { "country": "US", "percentage": 0.9604 } ], "averageTimeWatched": 2.0132, // Average watch time in seconds. The average time viewers spent watching your video. "commentsCount": 1, // Total number of lifetime comments. Available 24-48 hours after posting. "created": "2024-02-26T18:32:00Z", "embedUrl": "https://www.tiktok.com/static/profile-video?id=73399801580586794&", "engagementLikes": [ // Engagement likes. The distribution of your viewers who liked your video at specific points in the video's timeline. { "percentage": 0, "second": "179" }, { "percentage": 0, "second": "339" } ], "fullVideoWatchedRate": 0.0176, // The percentage of viewers who watched the entire video. "id": "7339980158058679594", "impressionSources": [ { "impression_source": "Search", "percentage": 0 }, { "impression_source": "Sound", "percentage": 0 }, { "impression_source": "other_profile_vv", "percentage": 0 }, { "impression_source": "Follow", "percentage": 0 }, { "impression_source": "For You", "percentage": 1 }, { "impression_source": "Hashtag", "percentage": 0 }, { "impression_source": "Personal Profile", "percentage": 0 } ], "likeCount": 2, // Total number of lifetime likes. Available 24-48 hours after posting. "mediaType": "video", "musicTitle": "♬ original sound - Mack", "musicUrl": "https://www.tiktok.com/music/original-sound", "name": "Mack", "post": "I have failed over and over and over again in my life and that is why I succeed. - Michael Jordan", "postUrl": "https://www.tiktok.com/@happy/video/7339980158058679594", "reach": 653, // The number of people who watched your published content at least once. "shareUrl": "https://www.tiktok.com/@happy/video/7339980158058679594", "shareCount": 2, // Total number of lifetime shares. Available 24-48 hours after posting. "tags": [], "thumbnailHeight": 1024, "thumbnailUrl": "https://p19-sign.tiktokcdn-us.com/obj/tos-useast5-p-85c255-tx/oIpT 9CLHAaQfuD67E3jfAFJ5eVDuF5Ibkmszg?x-expires=1709305200&x-signature=ZBTR0Q%2B4KLi8szRCir8eYEcAs1s%3D", "thumbnailWidth": 576, "totalTimeWatched": 1373, // Total watch time in seconds. The total time viewers spent watching your video. "url": "https://www.tiktok.com/@happy", "videoDuration": 11.332, // Video duration in seconds. "videoViewRetention": [ // This metric indicates how many of your viewers are still watching after a certain amount of time. { "percentage": 0.1, "second": "155" }, { "percentage": 0.07, "second": "234" } ], /* Total number of lifetime users who viewed the video. Available 24-48 hours after posting. If the user swipes away from the ad then swipes back, it would be counted as 2 impressions. Therefore, a new video view will be counted again with the new impression session. */ "videoViews": 697 }, // Twitter Response Example // Note: Non-public and organic metrics only available last 30-days of Tweets { "created": "2022-05-20T20:07:53.000Z", "entities": { "urls": [ { "start": 77, // Starting character position (inclusive) "end": 96, // Ending character position (exclusive) "url": "https://t.co/abc123", // Shortened t.co URL "expandedUrl": "https://www.ayrshare.com/docs", // Full URL after redirect "displayUrl": "ayrshare.com/docs", // User-friendly display version "unwoundUrl": "https://www.ayrshare.com/docs" // Final destination URL } ], "hashtags": [ { "start": 97, // Starting character position (inclusive) "end": 112, // Ending character position (exclusive) "tag": "SocialMediaAPI" // Hashtag text without # } ], "mentions": [ { "start": 113, // Starting character position (inclusive) "end": 122, // Ending character position (exclusive) "username": "ayrshare" // Username without @ } ], "cashtags": [ { "start": 123, // Starting character position (inclusive) "end": 128, // Ending character position (exclusive) "tag": "META" // Stock symbol without $ } ], "annotations": [ { "start": 46, // Starting character position (inclusive) "end": 54, // Ending character position (exclusive) "probability": 0.9456, // Confidence score (0.0 to 1.0) "type": "Product", // Entity type: Person, Place, Product, Organization, Other "normalizedText": "Ayrshare" // Standardized entity name } ] }, "id": "1187026023991603", // Twitter Social Post ID "media": [ // Attached media { "mediaKey": "7_1555577959943217152", "previewImageUrl": "https://pbs.twimg.com/ext_tw_video_thumb/1555577959943217152/pu/img/f4M9veIozFjQA_XD.jpg", "durationMs": 2168, // Duration in milliseconds, videos only "type": "video" // or "photo", "animated_gif" } ], "nonPublicMetrics": { // Use this to determine the total number of impressions generated for the Tweet. Only available for Tweets created the last 30 days. "impressionCount": 1, // Number of times the Tweet has been viewed "userProfileClicks": 0 }, "organicMetrics": { // Use this to measure organic engagement for the Tweet. Only available for Tweets created the last 30 days. "userProfileClicks": 2, "impressionCount": 4, // Number of times the Tweet has been viewed organically. "replyCount": 3, "retweetCount": 1, "likeCount": 234 }, "possiblySensitive": false, // Tweet contains possibly sensitive information "post": "Just launched our social media campaign using Ayrshare! Check out the API at https://t.co/abc123 #SocialMediaAPI @ayrshare $META", "postUrl": "https://twitter.com/myhandle/status/1187026023991603", "publicMetrics": { // Use this to measure Tweet engagement. Only available for Tweets created the last 30 days. "retweetCount": 2, "replyCount": 2, "likeCount": 5, "quoteCount": 1 }, "referencedTweets": [ // If a quoted or reply tweet { "type": "quoted", // or "replied_to" "id": "1556718165828276224", // Quoted or replied Tweet ID "url": "https://www.twitter.com/1556718165828276224" // Quoted or Replied Tweet URL } ], "source": "Ayrshare", // Determine if a Twitter user posted from the web, mobile device, or other app. "text": "To effectively communicate, we must realize that we are all different", // Deprecated, use "post" field "urls": [ // Available for long Tweets only { "start": 866, "end": 889, "url": "https://t.co/3r6xz4hBnM", "expandedUrl": "https://www.cnn.com", "displayUrl": "cnn.com" } ], }, { "authorId": "1194338779881472", "created": "2023-12-27T03:24:23.000Z", "createdAt": "2023-12-27T03:24:23.000Z", "editHistoryTweetIds": [ "17398682514485715" ], "id": "17398682514485715", "media": [ // available for videos and gifs { "nonPublicMetrics": { "playback100Count": 2, "playback0Count": 55, "playback50Count": 4, "playback25Count": 11, "playback75Count": 2 }, "publicMetrics": { "viewCount": 27 }, "durationMs": 28240, "organicMetrics": { "playback100Count": 2, "playback0Count": 55, "playback25Count": 11, "playback75Count": 2, "playback50Count": 4, "viewCount": 27 }, "mediaKey": "7_1739849636389814272", "previewImageUrl": "https://pbs.twimg.com/ext_tw_video_thumb/1739849636389814272/pu/img/bCkAdkD0R00-ZlkY.jpg", "width": 1920, "type": "video", "height": 1080, "mediaUrls": [ { "bitRate": 256000, "contentType": "video/mp4", "mediaUrl": "https://video.twimg.com/ext_tw_video/1739849636389814272/pu/vid/avc1/480x270/4RoZCqynednVMFgy.mp4?tag=12" }, { "bitRate": 832000, "contentType": "video/mp4", "mediaUrl": "https://video.twimg.com/ext_tw_video/1739849636389814272/pu/vid/avc1/640x360/RYy5iHTIxu7_iyZm.mp4?tag=12" }, { "bitRate": 2176000, "contentType": "video/mp4", "mediaUrl": "https://video.twimg.com/ext_tw_video/1739849636389814272/pu/vid/avc1/1280x720/9UpR90ekFA-9Ucxo.mp4?tag=12" }, { "contentType": "application/x-mpegURL", "mediaUrl": "https://video.twimg.com/ext_tw_video/1739849636389814272/pu/pl/0AVy2xIOLQcsrEZG.m3u8?tag=12&container=fmp4" } ] } ], "nonPublicMetrics": { "impressionCount": 54, "userProfileClicks": 0 }, "organicMetrics": { "userProfileClicks": 0, "likeCount": 0, "replyCount": 0, "impressionCount": 54, "retweetCount": 0 }, "possiblySensitive": false, "post": "Family is the most important thing in the world. - Diana, Princess of Wales https://t.co/MgYxnJDer6", "postUrl": "https://twitter.com/superme/status/17398682514485715", "publicMetrics": { "retweetCount": 0, "replyCount": 0, "likeCount": 0, "quoteCount": 0, "bookmarkCount": 0, "impressionCount": 54 }, "urls": [ // Available for long Tweets only { "start": 866, "end": 889, "url": "https://t.co/3r6xz4hBnM", "expandedUrl": "https://www.cnn.com", "displayUrl": "cnn.com" } ], }, // YouTube Response Example { "created": "2022-08-15T19:14:44Z", "description": "Doubt is not a pleasant condition, but certainty is absurd. - Voltaire", // Deprecated, use "post" field "id": "Q-4OuHCALVa", // YouTube Social Post ID "position": 0, "post": "Doubt is not a pleasant condition, but certainty is absurd. - Voltaire", "postUrl": "https://www.youtube.com/watch?v=Q-4OuHCALVa", "privacyStatus": "public", "license": "youtube", // "youtube" or "creativeCommon" "embeddable": true, // whether the video can be embedded on external sites "publicStatsViewable": true, // whether the extended stats panel is publicly viewable "published": "2025-05-07T16:27:12Z", "thumbnailUrl": "https://i.ytimg.com/vi/Q-4OuHCALVa/default.jpg", "title": "Yo time" }, { "created": "2022-08-08T22:24:42Z", "description": "Little author little, one travels far. - J.R.R. Tolkien", // Deprecated, use "post" field "id": "Btg4ysKnHea", // YouTube Social Post ID "position": 1, "post": "Little author little, one travels far. - J.R.R. Tolkien", "postUrl": "https://www.youtube.com/watch?v=Btg4ysKnHea", "privacyStatus": "unlisted", "license": "creativeCommon", "embeddable": false, "publicStatsViewable": false, "published": "2025-05-07T16:27:12Z", "thumbnailUrl": "https://i.ytimg.com/vi/Btg4ysKnHea/default.jpg", "title": "Nice one 2" } ], "lastUpdated": "2022-11-14T16:04:51.994Z", "nextUpdate": "2022-11-14T16:37:21.994Z", "meta": { "pagination": { "hasMore": true, // More results available "next": "eyJ0b2tlbiI6IjE3MzkyNjg1MTQ0ODU3MTUiLCJzb3VyY2UiOiJwdWJsaWMiLCJwbGF0Zm9ybSI6InR3aXR0ZXIifQ==", // Cursor for next page "limit": 10 // Requested page size } } } ``` ```json 400: Error theme={"system"} { "status": "error", "code": 196, "message": "Instagram is not connected" } ``` ```json 400: Bad Request theme={"system"} { // When some of the data is not available from the social networks. // All available data is still returned "status": "error", "posts": [ {... valid data }, { "action": "analytics", "code": 187, "commentsCount": 0, "created": "2019-03-22T13:31:02Z", "createdTime": "2019-03-22T13:31:02+0000", "from": { "name": "Ayrshare", "id": "746346376697" }, "fullPicture": "https://external.fphl1-1.fna.fbcdn.net/emg1/v/t13/", "id": "746346376697_3993223", // Facebook Social Post ID "isPopular": false, "likeCount": 2, "mediaUrls": [ { "description": "Dirk Cotton's approach to retirement planning.", "media": { "image": { "height": 720, "src": "https://external.fphl1-1.fna.fbcdn.net/emg1/v/t13/608115669879219", "width": 720 } }, "mediaType": "link", "title": "The Retirement Planning Regime", "url": "https://bit.ly/2RwaH" } ], "message": "Error getting analytics.", "post": "Error getting analytics.", "status": "error", "statusType": "shared_story" }, {... valid data } ] } ```