> ## 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. # 社交网络分析 > 获取用户社交资料的分析和人口统计数据，例如展示、观看和粉丝 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 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 } ; }; 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 )} ; 获取用户社交资料的分析和人口统计数据，例如展示、观看和粉丝。 目前支持 Bluesky、Facebook Pages、Google My Business、Instagram、LinkedIn、Pinterest、Reddit、Snapchat、Threads、TikTok、X/Twitter 和 YouTube。 **Facebook：Meta 已下线部分覆盖率与视频指标（2026 年 6 月 15 日）。** Meta 在所有 Graph API 版本中移除了唯一展示与 3 秒（唯一）视频观看的 Insights 指标，因此 Facebook 的 `analytics` 对象不再返回 `pagePostsImpressions*` 系列（`pagePostsImpressions`、`pagePostsImpressionsPaid`、`pagePostsImpressionsUnique`、`pagePostsImpressionsOrganicUnique`、`pagePostsImpressionsViral*`、`pagePostsImpressionsNonviral*`、`pagePostsServedImpressionsOrganicUnique`）以及 `pageVideoViewsUnique`。请使用 `pageMediaView` 作为覆盖指标（"总唯一媒体观看数"的后继指标已在规划中）。`pagePostEngagements`、`pageVideoViews` 和 `pageVideoViewsPaid` 不受影响。参考：[即将进行的 API 变更 — 2026 年 6 月 15 日](/whatsnew/upcoming-api-changes#june-15-2026)。 ## 请求头参数 ## 请求体参数 用于获取分析的社交媒体平台。接受以下取值组成的字符串数组： ```json theme={"system"} { "platforms": ["bluesky", "instagram", "facebook", "gmb", "linkedin", "pinterest", "reddit", "snapchat", "threads", "tiktok", "twitter", "youtube"] } ``` 指定要返回多少个季度的历史数据。一个季度为： * Facebook 为 85 天 * Instagram、TikTok 和 YouTube 为 90 天 * Snapchat 为 90 天（由于 Snapchat API 的限制，最多为 1 个季度 / 90 天） 可用于 Facebook、Instagram、Snapchat、TikTok 和 YouTube 平台。有效值：1–4。 只有大于 0 的值才会激活日期过滤。 **日期过滤（Instagram 与 TikTok）：** 当 `daily=true` 或 `quarters > 0` 时，日期过滤生效。 如果 `daily` 与 `quarters` 都未提供，将返回不做日期过滤的全部历史数据。 注意：`quarters: 0` 现在被视为无日期范围（全部历史数据）。此前，`quarters: 0` 被视为 `quarters: 1`。 设置为 `true` 时，将以每日时间序列值的形式返回分析数据，而不是聚合总计。此选项仅适用于 Facebook、Instagram、Snapchat、TikTok 和 YouTube 平台。由于数据量较大，建议使用[压缩](/apis/overview#compression)。 对于 Instagram 和 TikTok，设置 `daily=true` 也会以默认的更短季度窗口激活日期过滤。 **Instagram 覆盖：** 使用 `daily=true` 时，Instagram 响应返回一个嵌套的 `reach` 对象（包含 `period` 和 `values` 时间序列），而不是非 daily 模式下返回的标量 `reachCount` 字段。 对于 TikTok 分析，设置为 true 时，仅返回评论、分享和观看的 60 天聚合总计（`commentCountTotal`、`shareCountTotal`、`viewCountTotal`）。 与获取完整分析历史相比，这提供了更快的响应时间。 注意：请不要将此参数与 `daily=true` 一起使用，二者不兼容。 重要提示：自 2025 年 3 月 1 日起，TikTok 改用 60 天总计。自 2026 年 4 月起，TikTok 使用基于季度的日期过滤——使用 `quarters` 参数控制日期窗口（例如 `quarters: 1` = 90 天，`quarters: 2` = 180 天）。详情参见[即将进行的变更](/whatsnew/upcoming-api-changes#march-1-2025)。 YouTube 分析的平台特定选项。 **`lifetime`**（布尔值，默认：`false`）：设置为 `true` 时，会在响应中包含 `lifetimeLikes`——频道下所有公开视频点赞数的总和。这是通过拉取所有视频并汇总其点赞数计算得出的，因此拥有大量视频的频道可能耗时较长。 **阈值：** 视频数超过 1,000 的频道将返回 `lifetimeLikes: null`，并在顶层的 [`warnings`](#warnings) 数组中返回警告。这可防止过多的 API 使用。 **缓存：** 按频道缓存，对非成功结果使用更短的 TTL，以便重试能够及时反映状态变化： * `lifetimeLikes` 成功值：**24 小时**。 * 1,000 个视频回退（警告 `code: 445`）：**1 小时**——足够短，以便删除视频以降至阈值以下的频道不必等待一整天才能获得真实值。 * YouTube Data API 短暂失败（警告 `code: 446`）：**不缓存**——下一次请求会重试。 **注意：** 已删除或私密视频不计入总和，因此对于删除过视频的频道，总数可能与"真实"的终身点赞数不同。 **请求示例：** ```json theme={"system"} { "platforms": ["youtube"], "youtube": { "lifetime": true } } ``` 仅限 X/Twitter。此参数允许你通过特定 X/Twitter 用户的数字 ID 获取其帖子，而不是从你关联的账户获取。 例如，要获取用户名为 `@Google` 的所有帖子，可以使用其数字 userId `20536157`。 你可以通过[品牌获取用户](/apis/listen/brand-user)端点找到任意 X/Twitter 用户的数字 userId。 注意：发起此请求时请仅在请求头中包含 API KEY。请勿包含 Profile Key。 仅限 X/Twitter。此参数允许你通过特定 X/Twitter 用户的用户名获取其帖子，而不是从你关联的账户获取。 例如，用于获取用户名为 `@Google` 的所有帖子。 注意：发起此请求时请仅在请求头中包含 API KEY。请勿包含 Profile Key。 ```bash cURL theme={"system"} curl \ -H "Authorization: Bearer API_KEY" \ -H 'Content-Type: application/json' \ -d '{"platforms": ["bluesky", "facebook", "gmb", "instagram", "linkedin", "pinterest", "reddit", "snapchat", "threads", "tiktok", "twitter", "youtube"], "quarters": 1}' \ -X POST https://api.ayrshare.com/api/analytics/social ``` ```javascript JavaScript theme={"system"} const API_KEY = "API_KEY"; fetch("https://api.ayrshare.com/api/analytics/social", { method: "POST", headers: { "Content-Type": "application/json", Authorization: `Bearer ${API_KEY}` }, body: JSON.stringify({ platforms: [ "bluesky", "facebook", "gmb", "instagram", "linkedin", "pinterest", "reddit", "snapchat", "threads", "tiktok", "twitter", "youtube" ], quarters: 1 }) }) .then((res) => res.json()) .then((json) => console.log(json)) .catch(console.error); ``` ```python Python theme={"system"} import requests payload = {'platforms': ['bluesky', 'facebook', 'gmb', 'instagram', 'linkedin', 'pinterest', 'reddit', 'snapchat', 'threads', 'tiktok', 'twitter', 'youtube']} headers = {'Content-Type': 'application/json', 'Authorization': 'Bearer API_KEY'} r = requests.post('https://api.ayrshare.com/api/analytics/social', json=payload, headers=headers) print(r.json()) ``` ```php PHP theme={"system"} ['bluesky', 'facebook', 'gmb', 'instagram', 'linkedin', 'pinterest', 'reddit', 'snapchat', 'threads', 'tiktok', 'twitter', 'youtube'] // required ]); $curl = curl_init($apiUrl); curl_setopt_array($curl, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => $headers, CURLOPT_POSTFIELDS => $data ]); $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); ``` ```go Go theme={"system"} package main import ( "bytes" "encoding/json" "log" "net/http" ) func main() { message := map[string]interface{}{ "platforms": []string{"bluesky", "facebook", "gmb", "instagram", "linkedin", "pinterest", "reddit", "snapchat", "threads", "tiktok", "twitter", "youtube"}, } bytesRepresentation, err := json.Marshal(message) if err != nil { log.Fatalln(err) } req, _ := http.NewRequest("POST", "https://api.ayrshare.com/api/social", bytes.NewBuffer(bytesRepresentation)) req.Header.Add("Content-Type", "application/json; charset=UTF-8") req.Header.Add("Authorization", "Bearer API_KEY") res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal("Error:", err) } res.Body.Close() } ``` ```csharp C# theme={"system"} using System; using System.Net.Http; using System.Text; using System.Threading.Tasks; namespace SocialPOSTRequest_csharp { class Social { private static readonly HttpClient client = new HttpClient(); static async Task Main(string[] args) { string API_KEY = "API_KEY"; string url = "https://api.ayrshare.com/api/analytics/social"; client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY); string json = "{\"platforms\": [\"bluesky\", \"facebook\", \"gmb\", \"instagram\", " + "\"linkedin\", \"pinterest\", \"reddit\", \"snapchat\", \"threads\", \"tiktok\", \"twitter\", \"youtube\"]}"; try { var content = new StringContent(json, Encoding.UTF8, "application/json"); HttpResponseMessage response = await client.PostAsync(url, content); response.EnsureSuccessStatusCode(); string responseBody = await response.Content.ReadAsStringAsync(); Console.WriteLine(responseBody); } catch (HttpRequestException e) { Console.WriteLine($"Error: {e.Message}"); } } } } ``` 当累计指标（例如粉丝、点赞）暂时无法从社交网络获取时，API 会自动使用存储的数据回填。每个平台的 `analytics` 对象中可能出现两个可选字段： * **`backfilledFrom`**（字符串，ISO 8601）— 当有一个或多个累计指标被存储数据替换时出现。该时间戳表示存储数据最后更新的时间。 * **`recoveredFrom`**（字符串，ISO 8601）— 当由于 API 完全失败而使整个分析响应从存储数据中恢复时出现。该时间戳表示存储数据最后更新的时间。 存储数据超过 4 天将被视为过期，不再用于回填或恢复。 **LinkedIn `reactions`：** 帖子级累计 `reactions` 指标（一个按类型划分的反应计数对象）适用于这种"仅空值时回填"的行为。当 LinkedIn 对反应拉取进行速率限制时，该值会从上一次成功快照沿用——同时 `backfilledFrom` 会被设置为该快照的时间戳——而不是回退为空。 **LinkedIn 个人（成员）分析——需重新关联。** 在成员分析上线之前关联的个人 LinkedIn 资料没有所需的分析权限范围。针对这些资料的社交分析请求会返回[错误码 `475`](/errors/errors-ayrshare#linkedin-analytics-errors)（"重新关联你的 LinkedIn 资料以启用分析"）。账户所有者必须在"社交账户"页面重新关联其 LinkedIn 资料，以授予新的权限。重新关联后请等待几分钟，让 `475` 错误码清除（Ayrshare 与 LinkedIn 都会短暂缓存权限状态，通常约 5-10 分钟）。发布不受影响。 **`warnings`**（对象数组，可选顶层字段）— 仅在 Ayrshare 需要告知调用方非致命状况时出现（例如某个可选计算被跳过）。当没有需要警告的内容时，此字段不会出现在响应中。 每个条目都是一个结构化对象，而不是自由格式的字符串： | 字段 | 类型 | 描述 | | --------- | --- | ------------------------------------ | | `action` | 字符串 | 产生该警告的操作上下文（例如 `"analytics"`）。 | | `status` | 字符串 | 对于 `warnings` 数组中的条目始终为 `"warning"`。 | | `code` | 数值 | 稳定的 Ayrshare 警告编码。可安全地在客户端代码中匹配。 | | `message` | 字符串 | 人类可读的描述。 | | `details` | 字符串 | 与该警告实例相关的可选附加上下文。 | 已知警告代码： * `445` — 因 YouTube 频道超过 1,000 个视频阈值而跳过 `lifetimeLikes`。 * `446` — 因 YouTube Data API 对上传播放列表或每一批 `videos.list` 返回错误而无法获取 `lifetimeLikes`。 ```json 200: Success Aggregate {3, 29, 121, 138, 203, 265, 275, 353, 390, 459, 478, 556, 596} theme={"system"} { "status": "success", "bluesky": { "analytics": { "associated": { // Group of associated features and capabilities "lists": 0, // Number of lists created by the user "feedgens": 0, // Number of custom feeds generated by the user "starterPacks": 0, // Number of starter packs created by the user "labeler": false // Whether the user can create content labels }, "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:n7atr", // URL to user's profile picture "created": "2024-12-14T20:39:21.343Z", // Timestamp when the account was created "displayName": "Jumping Jack", // User's chosen display name "followersCount": 15, // Number of users following this account "followsCount": 5, // Number of users this account follows "handle": "jack.bsky.social", // User's unique handle/username "id": "did:plc:n7atrjd22xgkmgwig6dzlh", // Bluesky Social ID "indexedAt": "2024-12-14T20:39:21.343Z", // Timestamp when this data was last indexed "labels": [], // Array of content labels applied to the account "postsCount": 20, // Number of posts made by the user "viewer": { // Information about the viewing user's relationship "muted": false, // Whether the viewing user has muted this account "blockedBy": false // Whether this account has blocked the viewing user } }, "lastUpdated": "2025-01-11T20:05:05.214Z", "nextUpdate": "2025-01-11T20:16:05.214Z" }, "facebook": { /* See specific time ranges - Lifetime unless otherwise noted */ "analytics": { "about": "The best site to watch movies online.", "birthday": "11/20/1985", // Applicable to Pages representing people "caterory": "Movie", // The Page's category. e.g. Product/Service, Computers/Technology. "emails": ["john@example.com"], "engagement": { // If available, otherwise use fanCount "count": 587, // Page like count, same as fanCount "socialSentence": "587 people like this." }, "fanCount": 587, "followersCount": 587, "id": "102619320979033", "instagramBusinessAccount": { "id": "17841452212707498" // Present if an Instagram account is linked with the Facebook page }, "isPublished": true, // If the FB Page is publicly visable. "link": "https://www.facebook.com/102619320979033", "location": { // If a location is set "street": "142 W 57th St", "zip": "10019" }, "name": "theGoodone", "pageFollows": 2, "pageMediaView": 929, // The number of times your content was played or displayed. Content includes videos, posts, stories and ads. "pageMediaViewIsFromAds": 1, // The number of times your content was played or displayed from ads. "pageMediaViewIsFromFollowers": 18, // The number of times your content was played or displayed from followers. "pagePostEngagements": 20, // The number of interactions with your posts such as reactions, comments, shares and more. // The pagePostsImpressions* family and pagePostsServedImpressionsOrganicUnique were retired by Meta (June 15, 2026); see the note at the top of this page. // --- Page Video Data --- "pageVideoCompleteViews30s": 32, // The number of times your Page's videos played for at least 30 seconds, or for nearly their total length if they're shorter than 30 seconds. During a single instance of a video playing, we'll exclude any time spent replaying the video. "pageVideoCompleteViews30sAutoplayed": 19, // Autoplayed 30s complete. "pageVideoCompleteViews30sClickToPlay": 5, // Click to play 30s complete. "pageVideoCompleteViews30sOrganic": 23, // Organic 30s complete. "pageVideoCompleteViews30sPaid": 2, // Paid 30s complete. "pageVideoCompleteViews30sRepeatViews": 3, // Repeat 30s complete. "pageVideoCompleteViews30sUnique": 3, // Unique 30s complete. "pageVideoRepeatViews": 4, // The number times of repeat views. "pageVideoViews": 31, // The number of times your Page's videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds. During a single instance of a video playing, we'll exclude any time spent replaying the video. "pageVideoViewsAutoplayed": 115, // Number of views that autoplayed on a user's screen "pageVideoViewsOrganic": 32, // The number of organic video views. "pageVideoViewsPaid": 6, // The number of times your Page's promoted videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video. "pageVideoViewsByPaidNonPaid": { // Breakdown of view views by paid and non-paid "total": 32, "unpaid": 5, "paid": 27 }, "pageVideoViewsByUploadedHosted": { // Daily video views on a page-level broken down by all variants of page-uploaded and page-hosted variants. "pageUploaded": 147, "pageUploadedFromCrossposts": 0, "pageUploadedFromShares": 3, "pageHostedCrosspost": 0, "pageHostedShare": 0, "pageOwned": 144 }, "pageVideoViewsClickToPlay": 32, // The number of times your Page's videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds, after people clicked play. During a single instance of a video playing, we'll exclude any time spent replaying the video. "pageVideoViewsOrganic": 147, // The number of times your Page's videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds, by organic reach. During a single instance of a video playing, we'll exclude any time spent replaying the video. "pageVideoViewsPaid": 0, // The number of times your Page's promoted videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds. For each impression of a video, we'll count video views separately and exclude any time spent replaying the video. // pageVideoViewsUnique was retired by Meta (June 15, 2026); see the note at the top of this page. "reactions": { // Total over past 180 days "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 }, "unreadMessageCount": 12, // Total unread FB Messages - if applicable "username": "ayrshare", "verified": true, // verified Facebook Page "website": "https://www.theGoodone.com" }, "quarters": 4, "lastUpdated": "2024-04-25T21:28:10.877Z", "nextUpdate": "2024-04-25T21:39:10.877Z" }, /* * Google Business Profile analytics totals are for the past 24 months. */ "gmb": { "analytics": { "businessBookings": 0, // The number of bookings received from the business profile. "businessConversations": 0, // The number of message conversations received on the business profile. "businessDirectionRequests": 328, // The number of times a direction request was requested to the business location. "businessFoodOrders": 0, // The number of food orders received from the business profile. "businessImpressionsDesktopMaps": 153, // Business impressions on Google Maps on Desktop devices. Multiple impressions by a unique user within a single day are counted as a single impression. "businessImpressionsDesktopSearch": 9675, // Business impressions on Google Search on Desktop devices. Multiple impressions by a unique user within a single day are counted as a single impression. "businessImpressionsMobileMaps": 65, // Business impressions on Google Maps on Mobile devices. Multiple impressions by a unique user within a single day are counted as a single impression. "businessImpressionsMobileSearch": 2070, // Business impressions on Google Search on Mobile devices. Multiple impressions by a unique user within a single day are counted as a single impression. "callClicks": 2, // The number of times the business profile call button was clicked. "websiteClicks": 134 // The number of times the business profile website was clicked. }, "lastUpdated": "2024-04-25T21:28:10.877Z", "nextUpdate": "2024-04-25T21:39:10.877Z" }, "instagram": { "analytics": { /* * Demographics: The following audience demographic data is only available * for Intagram Users with at least 100 followers and engagements (last 30 days). * Additionally, audience demographic data is only available when * there is more than 100 people in each demographic category. */ "audienceCity": { "Sydney, New South Wales": 2, "London, England": 2, "Bridgewater, New Jersey": 1, "Puli, Nantou": 1 }, "audienceCityEngagedAudienceDemographics": { "KIRKLAND, WASHINGTON": 3, "LAKE BOSWORTH, WASHINGTON": 6, "WASHOUGAL, WASHINGTON": 1, "SEATTLE, WASHINGTON": 1, "BURLINGTON, WASHINGTON": 2 }, "audienceCountry": { "TW": 1, "HK": 5, "SG": 1, "AU": 2 }, "audienceCountryEngagedAudienceDemographics": { "DE": 0, "GB": 0, "US": 161 }, "audienceGenderAge": { "F.18-24": 1, "F.25-34": 6, "F.35-44": 13, "F.45-54": 16 }, "audienceGenderAgeEngagedAudienceDemographics": { "F.13-17": 2, "F.18-24": 11, "F.25-34": 15, "F.35-44": 24 }, "biography": "What to watch next? Get recommendations from your friends.", "commentsCount": 6, // Total comments of the past 500 posts "followersCount": 2, // Current total of followers - must have at least 100 followers to show "followsCount": 19, // Current total of users followed "id": "17941424040207809", "igId": 24372260340, // legacy Instagram user ID - only available when Instagram is linked via Facebook Page "igLoginId": "84739261504829371", // Instagram native user ID - only available when Instagram is linked via direct Instagram login "likeCount": 116, // Total like of the past 500 posts "mediaCount": 266, // Total media count on the account, always lifetime. Not filtered by `quarters` or `daily`. "name": "theGoodone", "profilePictureUrl": "https://scontent.fphl1-1.fna.fbcdn.net/v/t51.2885-15/74638883_536953567098493_7984001172816003072_n.jpg?_nc_cat=102&ccb=1-5&_nc_sid=86c713&_nc_ohc=krzDDPMjIZQAX-m1PsT&_nc_ht=scontent.fphl1-1.fna&edm=AL-3X8kEAAAA&oh=00_AT9uZhfkQyHWuThTgktvXxB8XEK_xV1_z72frRwtyGwHTA&oe=6246E46D", "reachCount": 1, // 180 day period - Total number of unique users who have viewed at least one media. Scalar value returned in non-daily mode; when daily=true a nested `reach` object is returned instead (see the Daily success example). "shareCount": 234, // Total number of shares on the Instagram account's content (posts, stories, reels, videos, live videos) aggregated per-day over the active date window. Follows the same 90-day rolling maximum as `viewsCount` and respects `quarters` / `daily`. Defaults to `0` for accounts where Meta does not return the `shares` metric. "username": "thegoodone", "viewsCount": 123212, // 90 day rolling window (maximum Meta allows on the User Metrics endpoint) - Total number of times the IG User's media have been viewed "website": "https://www.mywebsite.com/" }, "lastUpdated": "2022-05-09T00:52:30.530Z", "nextUpdate": "2022-05-09T02:07:30.530Z" }, /* LinkedIn Corporate: Lifetime analytics since start of account */ "linkedin": { // The likeCount and commentCount fields do not count likes or comments made by companies, including the company that authored the share and are not decremented when a like or comment is deleted. "analytics": { "clickCount": 10, "clicks": { // Only available for organizations that have career pages. This is a paid product. "mobileCareersPageClicks": { "careersPageJobsClicks": 2, "careersPagePromoLinksClicks": 0, "careersPageEmployeesClicks": 0 }, "careersPageClicks": { "careersPagePromoLinksClicks": 5, "careersPageBannerPromoClicks": 0, "careersPageJobsClicks": 0, "careersPageEmployeesClicks": 3 } }, "commentCount": 12, "engagement": 0.06060606060606061, // Number of organic clicks, likes, comments, and shares over impressions. "followers": { "organicFollowerCount": 7, "paidFollowerCount": 2, "totalFollowerCount": 12 // Total numuber might be higher than organic + paid. For total use this field. }, "impressionCount": 264, "likeCount": 6, // Number of likes. This field can become negative when members who liked a sponsored share later unlike it. "shareCount": 3, // Number of mentions of the company in a share across LinkedIn "uniqueImpressionsCount": 51, "views": { "aboutPageViews": 2, "allDesktopPageViews": 8, "allMobilePageViews": 8, "allPageViews": 16, "careersPageViews": 0, // Only available for organizations that have career pages "desktopAboutPageViews": 0, "desktopCareersPageViews": 0, "desktopInsightsPageViews": 0, "desktopJobsPageViews": 0, "desktopLifeAtPageViews": 0, "desktopOverviewPageViews": 8, "desktopPeoplePageViews": 0, "desktopProductsPageViews": 0, "insightsPageViews": 0, "jobsPageViews": 0, "lifeAtPageViews": 0, "mobileAboutPageViews": 2, "mobileCareersPageViews": 0, "mobileInsightsPageViews": 0, "mobileJobsPageViews": 0, "mobileLifeAtPageViews": 0, "mobileOverviewPageViews": 6, "mobilePeoplePageViews": 0, "mobileProductsPageViews": 0, "overviewPageViews": 14, "peoplePageViews": 0, "productsPageViews": 0 } }, "lastUpdated": "2022-05-09T00:52:30.530Z", "nextUpdate": "2022-05-09T02:07:30.530Z" }, /* LinkedIn Personal (member) */ "linkedin": { "description": "Founder", "id": "Z_yXaxh_Et", // LinkedIn Personal ID "name": "John Doe", "platform": "linkedin", "profileImageUrl": "https://media.licdn.com/dms/image/v2/C5103AQHORT70jVfKVA/profile", "url": "https://www.linkedin.com/in/johndoe", "userName": "johndoe", "analytics": { "commentCount": 410, // Aggregate comments "followersCount": 4210, // Lifetime follower count "followersDaily": [ // Daily follower growth (trailing 30 days) { "memberFollowersCount": 12, "dateRange": { "start": { "year": 2026, "month": 6, "day": 9 } } } ], "impressionCount": 98000, // Aggregate impressions across posts "likeCount": 2300, // Aggregate reactions "shareCount": 190, // Aggregate reshares "uniqueImpressionsCount": 41000 // Aggregate unique members reached } }, /* 90 days summary and daily details, board analytics full history */ "pinterest": { "analytics": { "board": { "boardPinsModifiedAt": "2023-03-14T22:32:06Z", "collaboratorCount": 0, "createdAt": "2019-03-07T22:02:22Z", "description": "", "followerCount": 24, "id": "4299544013183293", "media": { "pinThumbnailUrls": [ "https://i.pinimg.com/150x150/62/08/8b/62088b44a6152de7198efd3c2bc5c0.jpg", "https://i.pinimg.com/150x150/ac/b7/c9/acb7c9f8096317180c20022e9b9b8a.jpg", "https://i.pinimg.com/150x150/5a/d7/56/5ad756fb64a688934bd06853dff3a2.jpg", "https://i.pinimg.com/150x150/5a/d7/56/5ad755db64a688934bd06853dff3a2.jpg", "https://i.pinimg.com/150x150/a9/22/b6/a922ef5289639b617c24704d806998.jpg" ], "imageCoverUrl": "https://i.pinimg.com/400x300/f8/ec/14/f8ec14e7770a53b2e3595773564950.jpg" }, "name": "Places to Retire", "pinCount": 64, "privacy": "PUBLIC", "username": "glueUp" }, "clickthrough": 23, "clickthroughRate": 0.34, "closeup": 3, "closeupRate": 0.43, "engagement": 54, "engagementRate": 0.43, "fullScreenPlay": 23, "fullScreenPlaytime": 42, "impression": 12231, "outboundClick": 256, "outboundClickRate": 0.0.23, "pinClick": 32, "pinClickRate": 0.23, "quartile95PercentView": 42, "save": 45, "saveRate": 23, "video10sView": 902, "videoAvgWatchTime": 234, "videoMrcView": 23, "videoStart": 34, "videoV50WatchTime": 343, "daily": [ { "date": "2021-09-28", "metrics": { "SAVE_RATE": 0, "OUTBOUND_CLICK_RATE": 0, "IMPRESSION": 0, "CLOSEUP_RATE": 0, "ENGAGEMENT_RATE": 0, "VIDEO_10S_VIEW": 0, "VIDEO_AVG_WATCH_TIME": 0, "ENGAGEMENT": 0, "CLOSEUP": 0, "FULL_SCREEN_PLAY": 0, "SAVE": 0, "PIN_CLICK_RATE": 0, "OUTBOUND_CLICK": 0, "VIDEO_MRC_VIEW": 0, "VIDEO_V50_WATCH_TIME": 0, "QUARTILE_95_PERCENT_VIEW": 0, "VIDEO_START": 0, "CLICKTHROUGH": 0, "PIN_CLICK": 0, "CLICKTHROUGH_RATE": 0, "FULL_SCREEN_PLAYTIME": 0 } } ] }, "lastUpdated": "2022-05-09T00:52:30.530Z", "nextUpdate": "2022-05-09T02:07:30.530Z" }, /* Lifetime analytics since start of account */ "reddit": { "analytics": { "acceptFollowers": true, // Whether the user accepts new followers "awardeeKarma": 125, // Karma points received from Reddit awards given by others "awarderKarma": 45, // Karma points earned from giving awards to others "canCreateSubreddit": true, // Whether the user has permission to create new subreddits "coins": 250, // Number of Reddit coins the user currently has "commentKarma": 2847, // Karma points earned from comments "created": "2023-03-15T14:22:30.000Z", // Account creation date in ISO format "friends": 12, // Number of Reddit friends the user has added "hasSubscribed": true, // Whether the user has subscribed to any subreddits "hasVerifiedEmail": true, // Whether the user has verified their email address "hideFromRobots": false, // Whether the user has opted to hide their profile from search engines "iconImg": "https://www.redditstatic.com/avatars/default_5.png", // URL to the user's avatar image "id": "abc123def456", // Unique Reddit user ID "inboxCount": 3, // Number of unread messages in the user's inbox "isEmployee": false, // Whether the user is a Reddit employee "isGold": false, // Whether the user has Reddit Gold/Premium subscription "isMod": false, // Whether the user is a moderator of any subreddits "isSponsor": false, // Whether the user is a Reddit sponsor "isSuspended": false, // Whether the user's account is currently suspended "linkKarma": 1567, // Karma points earned from submitted links/posts "linkedIdentities": [ // Array of external identity providers linked to the account "https://accounts.google.com" ], "name": "RedditUser_Example123", // Reddit username "over18": true, // Whether the user is over 18 (affects NSFW content visibility) "profileImageSize": null, // Dimensions of the profile image (null if using default avatar) "profileImageUrl": "https://i.redd.it/1234567890.png", // URL to custom profile image (empty if using default avatar) "suspensionExpiration": null, // When account suspension expires (null if not suspended) "totalKarma": 4414, // Total karma points (sum of link karma and comment karma) "url": "https://www.reddit.com/user/RedditUser_Example123", // Direct URL to the user's Reddit profile "verified": true // Whether the user has a verified Reddit account }, "lastUpdated": "2025-07-29T00:31:47.080Z", "nextUpdate": "2025-07-29T00:42:47.080Z" }, "snapchat": { "analytics": [ { "adsSubscribes": 6, // Number of new subscribers acquired through ads "avgViewTime": 5430, // Average view time in milliseconds per viewer "favorites": 42, // Number of times content was favorited "interactions": 156, // Number of times users interacted with content (taps, swipes) "lensAvgViewTime": 8720, // Average view time in milliseconds for lens content "lensPlays": 387, // Number of times lenses were played "lensSubscribers": 18, // Total number of lens subscribers "lensSubscribes": 5, // New lens subscribers "lensUniques": 342, // Unique users who viewed lenses "lensViewTime": 2832800, // Total lens view time in milliseconds "lensViews": 432, // Total number of lens views "mediaId": "43548e97-edf1-44f9-984a-0a38470875bc", "playTime": 4268700, // Total play time in milliseconds "profilePaidViews": 176, // Profile views from paid promotions "profileViews": 834, // Total profile views "replies": 23, // Number of replies to snaps/stories "savedStoryAvgViewTime": 4950, // Average view time for saved stories in milliseconds "savedStoryFavorites": 19, // Number of favorites on saved stories "savedStorySnapCombinedUniques": 523, // Combined unique viewers of saved stories "savedStorySnapCombinedViews": 712, // Combined views of saved stories "savedStorySnapPaidUniques": 142, // Unique paid viewers of saved stories "savedStorySnapPaidViews": 178, // Number of paid views of saved stories "savedStorySubscribes": 8, // Number of subscribes from saved stories "savedStoryUniques": 381, // Unique viewers of saved stories "savedStoryViewTime": 1925850, // Total view time of saved stories in milliseconds "savedStoryViews": 534, // Total views of saved stories "scans": 98, // Number of Snapcode scans "screenshots": 12, // Total number of screenshots taken "shares": 36, // Number of times content was shared "snapCombinedUniques": 734, // Combined unique viewers across snaps "snapCombinedViews": 912, // Combined total views across snaps "snapPaidUniques": 203, // Unique users who viewed snaps through paid promotion "snapPaidViews": 267, // Number of paid snap views "snapViewTime": 3784200, // Total snap view time in milliseconds "socialUnlocks": 54, // Number of social unlocks "spotlightAvgViewTime": 7230, // Average view time for Spotlight content in milliseconds "spotlightCombinedUniques": 1247, // Combined unique viewers of Spotlight content "spotlightCombinedViews": 1672, // Combined views of Spotlight content "spotlightFavorites": 89, // Number of favorites on Spotlight content "spotlightPaidUniques": 324, // Unique paid viewers of Spotlight content "spotlightPaidViews": 412, // Number of paid views of Spotlight content "spotlightSubscribes": 17, // Number of subscribes from Spotlight content "spotlightUniques": 923, // Unique viewers of Spotlight content "spotlightViewTime": 6765290, // Total view time of Spotlight content in milliseconds "spotlightViews": 1260, // Total views of Spotlight content "storyAvgViewTime": 5180, // Average view time for stories in milliseconds "storyFavorites": 37, // Number of favorites on stories "storySubscribers": 63, // Total number of story subscribers "storySubscribes": 9, // New story subscribers "storyUniques": 532, // Unique viewers of stories "storyViews": 687, // Total views of stories "subscribers": 143, // Total number of subscribers "subscribes": 12, // New subscribers in the period "swipeDowns": 21, // Number of swipe downs "swipeUps": 43, // Number of swipe ups "uniqueScreenshots": 9, // Number of unique users who took screenshots "uniqueSessions": 672, // Number of unique sessions "unsubscribes": 3, // Number of unsubscribes in the period "viewTime": 4568300, // Total view time in milliseconds "viewers": 723, // Number of unique viewers "views": 879 // Total number of views } ], "lastUpdated": "2025-05-21T20:24:02.787Z", "nextUpdate": "2025-05-21T20:35:02.787Z" }, "threads": { "analytics": { "biography": "Post to social media with an API for yourself or your users: Instagram, Facebook, Twitter, TikTok, YouTube, and more", "followersCount": 123, "id": "92732926562", "isEligibleForGeoRestrictions": true, "isVerified": true, "likes": 1121, "name": "Ayrshare", "profileImageUrlHttps": "https://scontent.cdninstagram.com/v/t51.2885-15/357665262_1390047998231434_3968630539537390629_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=104&ccb=1-7&_nc_sid=18de74&_nc_ohc=CHlHbGcrCaAQ7kNvwFqZTDz&_nc_oc=Adkj3ocdD7bHn5qffGIB20t1C7icONIg8CS7t4Bcf6sssxxve-k94PkCEFDXGsY6ND0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&edm=AP4hL3IEAAAA&oh=00_AfTPLboqmm2iSOGMfvS29exnVLn5U8y9QPnL6cwLQIcZ9g&oe=68915ECD", "quotes": 2, "replies": 196, "reposts": 3, "username": "ayrshare", "views": 36721 }, "lastUpdated": "2025-04-27T15:40:28.885Z", "nextUpdate": "2025-04-27T15:51:28.885Z" }, "tiktok": { "analytics": { "addressClicks": 2, // Number of clicks collected on the Address button past 60 days "appDownloadClicks": 1, // Number of clicks collected on the App Download button past 60 days "audienceAges": [ // Updated by TikTok every 24-48 hours. Only available for TikTok accounts with at least 100 followers. { "percentage": 0.125, "age": "45-54" }, { "percentage": 0.053, "age": "55+" }, { "percentage": 0.138, "age": "18-24" }, { "percentage": 0.36, "age": "25-34" }, { "percentage": 0.324, "age": "35-44" } ], "audienceCountries": [ // Updated by TikTok every 24-48 hours. { "percentage": 0.25, "country": "NG" }, { "percentage": 0.75, "country": "US" } ], "audienceGenders": [ // Updated by TikTok every 24-48 hours. { "percentage": 0.25, "gender": "Female" }, { "percentage": 0.5, "gender": "Male" }, { "percentage": 0.25, "gender": "Other" } ], "bio": "My tiktok account", "bioLinkClicks": 2, // Number of clicks collected on the Bio Link button past 60 days "commentCountPeriod": "90 days",// quarters × 90 days when date range is active (e.g., "90 days", "180 days"); "60 days" when no date filter "commentCountTotal": 1807, // TikTok caps profile-level lookback at 60 days. When `quarters` is set, this is the sum of lifetime engagement on posts created within the window (not engagement that occurred within the window). "displayName": "Me and You", "durationAverage": "10.72", // Deprecated. Will be removed in the future. Updated every 12 hours "emailClicks": 0, // Number of clicks collected on the Email button past 60 days "followerCount": 34, // Current follower count "followingCount": 39, // Current following count "leadSubmissions": 0, // Number of leads submitted past 60 days "isBusinessAccount": true, // Whether the account is a business account "isVerified": false, // Whether TikTok has provided a verified badge to the account after confirming that it belongs to the user it represents "likeCountTotal": 2, // Genuine all-time total - the only TikTok profile metric that returns true lifetime data (sourced from TikTok's `total_likes` field). "phoneNumberClicks": 0, // Number of clicks collected on the Phone Number button past 60 days "profileViews": 79346, // Total profile views past 60 days "shareCountPeriod": "90 days", // quarters × 90 days when date range is active (e.g., "90 days", "180 days"); "60 days" when no date filter "shareCountTotal": 4, // TikTok caps profile-level lookback at 60 days. When `quarters` is set, this is the sum of lifetime engagement on posts created within the window (not engagement that occurred within the window). "url": "https://vm.tiktok.com/ZTRuw5kM6/", "userImage": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/f123c4b57351e266", "username": "@funnyone", "videoCountTotal": 18, // Video total video count "viewCountPeriod": "90 days", // quarters × 90 days when date range is active (e.g., "90 days", "180 days"); "60 days" when no date filter "viewCountTotal": 1493 // TikTok caps profile-level lookback at 60 days. When `quarters` is set, this is the sum of lifetime engagement on posts created within the window (not engagement that occurred within the window). }, "lastUpdated": "2022-05-09T00:52:30.530Z", "nextUpdate": "2022-05-09T02:07:30.530Z" }, /* Lifetime analytics since start of handle */ "twitter": { "analytics": { "created": "2019-11-12T15:22:57Z", "description": "The best X account", "displayName": "Ayrshare", "followersCount": 11253, "followingCount": 4242, "id": 11842743387998232, "isIdentityVerified": false, // Whether the account is a verified account "likeCount": 561, // The number of likes created by this user "listedCount": 17, // The number of lists that include this user "location": "New York, NY", "mostRecentTweetId": "1848848832072667321", "name": "ayrshare", "parody": false, // Whether the account is a parody account "pinnedTweet": { "text": "Happy Days!", "id": "184884883207266733342", "editHistoryTweetIds": [ "18488488320726673223" ] }, "profileBannerUrl": "https://pbs.twimg.com/profile_banners/87253/15041912", "profileImageUrl": "http://pbs.twimg.com/profile_images/1184/lvQZPpt_normal.png", "protected": false, // User has chosen to protect their posts (private posts) "receivesYourDM": true, // User has chosen to receive direct messages from others "subscription": { "subscribesToYou": false }, "subscriptionType": "Premium", // Premium, PremiumPlus, None "tweetCount": 2930, // The number of Tweets (including retweets) issued by the user "url": "https://t.co/2XqeJiBy", "username": "ayrshare", "verified": true, // When true, indicates that the user has a verified account "verifiedType": "blue", // "blue", "business", "none" "website": "https://www.wondrouswaffles.com/" }, "lastUpdated": "2022-05-09T00:52:30.530Z", "nextUpdate": "2022-05-09T02:07:30.530Z" }, "youtube": { /* Lifetime analytics since start of channel */ "analytics": { "averageViewDuration": 99, // The average length, in seconds, of video playbacks. "averageViewPercentage": 127.06, // The average percentage of a video watched during a video playback. "comments": 8, "created": "2010-01-10T15:30:57Z", "description": "This is the channel you want", "dislikes": 1, // The number of times that users indicated that they disliked a video by giving it a negative rating. "estimatedMinutesWatched": 72, // The number of minutes that users watched videos for the specified channel, content owner, video, or playlist. "hiddenSubscriberCount": false, // Indicates whether the channel's subscriber count is publicly visible. "isLinked": true, "likes": 3, // Sum of likes across all videos on the channel within the date window determined by `quarters` (default: last 360 days). YouTube does not expose a lifetime channel-wide like counter. For a lifetime total, pass `youtube: { lifetime: true }` to get the `lifetimeLikes` field. "lifetimeLikes": 8750, // Opt-in lifetime sum of likes across every public video on the channel. Shown here because this sample assumes the request included `youtube: { lifetime: true }` — the broad request example at the top of this page does NOT include that flag, so `lifetimeLikes` will be absent from responses to that example request. May be `null` if channel exceeds 1,000-video threshold. Cached for 24 hours per channel. Deleted and private videos are excluded. "longUploadsStatus": "allowed", "playlistId": "UUsp6CnxiNbUUYKZwXQ", // Primary playlist "playlists": [ // All playlists associated with the connected channel { "description": "Playlist 1", "id": "PLcLpmVOb3fDaf7", "publishedAt": "2022-10-21T21:05:55Z", "title": "Super Playlist", "url": "https://www.youtube.com/playlist?list=PLcLpmVOb3fDaf7" }, { "description": "Playlist 2", "id": "FLsp6CnxiNbU", "publishedAt": "2012-02-26T19:16:55Z", "title": "Favorites", "url": "https://www.youtube.com/playlist?list=FLsp6CnxiNbU" } ], "privacyStatus": "public", // "public", "private", or "unlisted" "shares": 34, // The number of times that users shared a video through the Share button "subscriberCount": "67", // The number of subscribers that the channel has. "subscribersGained": 34, // The number of times that users subscribed to a channel. "subscribersLost": 2, // The number of times that users unsubscribed from a channel. "thumbnailUrl": "https://yt3.ggpht.com/ytc/AMLnZu_lgyzY2EFDAP-no-rj", "title": "The Best Channel", "url": "https://www.youtube.com/@youtube53", // The Channel URL using the custom handle "videoCount": "202", "videosAddedToPlaylists": 23, "videosRemovedFromPlaylists": 2, "viewCount": "5", // The sum of the number of times all the videos in all formats have been viewed for a channel for all time. "views": 44 // The number of video views that occurred in the last time period (quarters) }, "quarters": 4, "lastUpdated": "2022-05-09T00:52:30.530Z", "nextUpdate": "2022-05-09T02:07:30.530Z" } // The top-level `warnings` array (see the "warnings" Info block above) // would appear here as a sibling of `youtube`/`instagram`/etc. only when // a non-fatal condition applies — e.g. `lifetimeLikes` being skipped // because a channel exceeds the 1,000-video threshold. It is omitted in // this success example because `lifetimeLikes: 8750` was computed // successfully above. } ``` ```json 200: Success Daily {4, 612, 671, 1590, 1832} theme={"system"} // Available for Facebook, Instagram, Snapchat, TikTok, and YouTube // Recommended: https://www.ayrshare.com/docs/apis/overview#compression { "facebook": { "analytics": { "about": "One of the best stie ever", "category": "Local Business", "emails": [ "hello@ayrshare.com" ], "fanCount": 48519, "followersCount": 48681, "id": "885526541490222", "instagramBusinessAccount": { "id": "1784145407231999" }, "isPublished": true, "link": "https://www.facebook.com/885526541490222", "location": { // Physical location details for the Page "city": "Rome", "country": "Italy", "latitude": 41.853696407098, "longitude": 12.573806071995, "street": "Via Vincenzo", "zip": "00174" }, "name": "Super Site", "overallStarRating": 0, // The average star rating of the page. "pageFollows": { "period": "day", "values": [ { "value": 3, "endTime": "2025-08-12T07:00:00.000Z" }, { "value": 3, "endTime": "2025-08-13T07:00:00.000Z" }, ], "total": 3 }, "pageMediaView": { "period": "day", "values": [ { "value": 100, "endTime": "2025-08-12T07:00:00.000Z" }, { "value": 200, "endTime": "2025-08-13T07:00:00.000Z" } ], "total": 300 }, "pageMediaViewIsFromAds": { "period": "day", "values": [ { "value": 22, "endTime": "2025-08-12T07:00:00.000Z" }, { "value": 41, "endTime": "2025-08-13T07:00:00.000Z" } ], "total": 63 }, "pageMediaViewIsFromFollowers": { "period": "day", "values": [ { "value": 67, "endTime": "2025-08-12T07:00:00.000Z" }, { "value": 29, "endTime": "2025-08-13T07:00:00.000Z" } ], "total": 96 }, "pagePostEngagements": { // The number of interactions with your posts such as likes, comments, shares and more "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoCompleteViews30S": { // The number of times videos played for at least 30 seconds "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoCompleteViews30SAutoplayed": { // The number of times videos played for at least 30 seconds when autoplayed "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoCompleteViews30SClickToPlay": { // The number of times videos played for at least 30 seconds after clicking play "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoCompleteViews30SOrganic": { // The number of times videos played for at least 30 seconds through organic reach "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoCompleteViews30SPaid": { // The number of times videos played for at least 30 seconds through paid reach "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoCompleteViews30SRepeatViews": { // The number of times videos were replayed after playing for at least 30 seconds "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoCompleteViews30SUnique": { // The number of unique people who watched your videos for at least 30 seconds "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoRepeatViews": { // The number of times videos were replayed "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViewTime": { // Total time in seconds that videos were viewed "period": "day", "total": 2.33, "values": [ { "value": 2.33, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViews": { // The number of times your videos were viewed "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViews10S": { // The number of times videos played for at least 10 seconds "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViews10SAutoplayed": { // The number of times videos played for at least 10 seconds when autoplayed "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViews10SClickToPlay": { // The number of times videos played for at least 10 seconds after clicking play "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViews10SOrganic": { // The number of times videos played for at least 10 seconds through organic reach "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViews10SPaid": { // The number of times videos played for at least 10 seconds through paid reach "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViews10SRepeatViews": { // The number of times videos were replayed after playing for at least 10 seconds "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViews10SUnique": { // The number of unique people who watched your videos for at least 10 seconds "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViewsAutoplayed": { // The number of times your videos autoplayed "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViewsByPaidNonPaid": { // Breakdown of video views by paid vs non-paid distribution "period": "day", "values": [ { "value": { "total": 0, "unpaid": 0, "paid": 0 }, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": { "total": 0, "unpaid": 0, "paid": 0 }, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViewsByUploadedHosted": { // Breakdown of video views by uploaded vs hosted content "period": "day", "values": [ { "value": { "pageUploaded": 0, "pageUploadedFromCrossposts": 0, "pageUploadedFromShares": 0, "pageHostedCrosspost": 0, "pageHostedShare": 0, "pageOwned": 0 }, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": { "pageUploaded": 0, "pageUploadedFromCrossposts": 0, "pageUploadedFromShares": 0, "pageHostedCrosspost": 0, "pageHostedShare": 0, "pageOwned": 0 }, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViewsClickToPlay": { // The number of times people clicked play to view your videos "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViewsOrganic": { // The number of times your videos were viewed through organic reach "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, "pageVideoViewsPaid": { // The number of times your videos were viewed through paid reach "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-11-03T07:00:00.000Z" }, { "value": 0, "endTime": "2024-11-04T08:00:00.000Z" } ] }, // pageVideoViewsUnique was retired by Meta (June 15, 2026); see the note at the top of this page. "phone": "+39067265341", "reactions": { // Breakdown of reactions on your Page's content "like": 142, "love": 9, "wow": 1, "haha": 0, "sorry": 0, "anger": 0, "total": 152 }, "unreadMessageCount": 0, "username": "ayrshare", "verified": false, "website": "http://www.ayrshare.com" }, "quarters": 1, "lastUpdated": "2024-03-19T17:48:21.329Z", "nextUpdate": "2024-03-19T17:59:21.329Z" }, "instagram": { "analytics": { "audienceCity": { "KIRKLAND, WASHINGTON": 7, "LAKE BOSWORTH, WASHINGTON": 20, "BURLINGTON, WASHINGTON": 5, "SEATTLE, WASHINGTON": 22, "ARLINGTON HEIGHTS, WASHINGTON": 7, }, "audienceCountry": { "MM": 1, "CA": 2, "US": 2201, "LK": 1 }, "audienceGenderAge": { "F.13-17": 11, "F.18-24": 83, "M.13-17": 9, "M.18-24": 85, "M.65+": 10, "U.55-64": 25, "U.65+": 12 }, "biography": "Official Instagram feed for the best IG account", "commentsCount": 552, "followersCount": 2299, "followsCount": 26, "id": "17841407938064444", "igId": 79483284444, // legacy Instagram user ID - only available when Instagram is linked via Facebook Page "igLoginId": "84739261504829371", // Instagram native user ID - only available when Instagram is linked via direct Instagram login "likeCount": 30808, "mediaCount": 537, "name": "Best IG Account", "profilePictureUrl": "https://scontent-lga3-1.xx.fbcdn.net/v/t51.2885-15", "reach": { // Returned only when daily=true (replaces the scalar `reachCount` from non-daily mode) "period": "day", // Granularity of the time-series buckets "values": [ // Per-day reach time-series { "value": 387, "endTime": "2024-07-23T07:00:00.000Z" }, { "value": 46, "endTime": "2024-07-24T07:00:00.000Z" }, { "value": 4, "endTime": "2024-07-25T07:00:00.000Z" } ] }, "username": "instagram", "website": "https://www.instagram.com" }, "lastUpdated": "2024-07-25T16:09:33.608Z", "nextUpdate": "2024-07-25T16:20:33.608Z" }, "snapchat": { "analytics": [ { "adsSubscribes": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 0 }, { "endTime": "2026-01-22T00:00:00Z", "value": 0 } ], "total": 0 }, "avgViewTime": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 7126 }, { "endTime": "2026-01-22T00:00:00Z", "value": 7003 } ], "total": 14129 }, "favorites": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 4 }, { "endTime": "2026-01-22T00:00:00Z", "value": 3 } ], "total": 7 }, "interactions": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 8 }, { "endTime": "2026-01-22T00:00:00Z", "value": 22 } ], "total": 30 }, "lensAvgViewTime": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 3712 }, { "endTime": "2026-01-22T00:00:00Z", "value": 7837 } ], "total": 11549 }, "lensDauOverMau": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 0.074 }, { "endTime": "2026-01-22T00:00:00Z", "value": 0.042 } ], "total": 0.116 }, "lensDauOverWau": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 0.194 }, { "endTime": "2026-01-22T00:00:00Z", "value": 0.251 } ], "total": 0.445 }, "lensPlays": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 11 }, { "endTime": "2026-01-22T00:00:00Z", "value": 45 } ], "total": 56 }, "lensSubscribers": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 206 }, { "endTime": "2026-01-22T00:00:00Z", "value": 207 } ], "total": 413 }, "lensSubscribersGained": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 3 }, { "endTime": "2026-01-22T00:00:00Z", "value": 1 } ], "total": 4 }, "lensSubscribes": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 3 }, { "endTime": "2026-01-22T00:00:00Z", "value": 2 } ], "total": 5 }, "lensUniques": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 30 }, { "endTime": "2026-01-22T00:00:00Z", "value": 5 } ], "total": 35 }, "lensViewTime": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 1153 }, { "endTime": "2026-01-22T00:00:00Z", "value": 2231 } ], "total": 3384 }, "lensViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 29 }, { "endTime": "2026-01-22T00:00:00Z", "value": 25 } ], "total": 54 }, "mediaId": "6e9193cd-5013-478e-a272-d3d0e881f53f", "playTime": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 5273 }, { "endTime": "2026-01-22T00:00:00Z", "value": 5763 } ], "total": 11036 }, "profilePaidViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 2 }, { "endTime": "2026-01-22T00:00:00Z", "value": 0 } ], "total": 2 }, "profileViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 25 }, { "endTime": "2026-01-22T00:00:00Z", "value": 44 } ], "total": 69 }, "replies": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 0 }, { "endTime": "2026-01-22T00:00:00Z", "value": 2 } ], "total": 2 }, "savedStoryAvgViewTime": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 5471 }, { "endTime": "2026-01-22T00:00:00Z", "value": 3408 } ], "total": 8879 }, "savedStoryFavorites": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 2 }, { "endTime": "2026-01-22T00:00:00Z", "value": 0 } ], "total": 2 }, "savedStorySnapCombinedUniques": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 19 }, { "endTime": "2026-01-22T00:00:00Z", "value": 22 } ], "total": 41 }, "savedStorySnapCombinedViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 13 }, { "endTime": "2026-01-22T00:00:00Z", "value": 39 } ], "total": 52 }, "savedStorySnapPaidUniques": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 3 }, { "endTime": "2026-01-22T00:00:00Z", "value": 0 } ], "total": 3 }, "savedStorySnapPaidViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 8 }, { "endTime": "2026-01-22T00:00:00Z", "value": 4 } ], "total": 12 }, "savedStorySubscribes": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 2 }, { "endTime": "2026-01-22T00:00:00Z", "value": 2 } ], "total": 4 }, "savedStoryUniques": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 16 }, { "endTime": "2026-01-22T00:00:00Z", "value": 23 } ], "total": 39 }, "savedStoryViewTime": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 2287 }, { "endTime": "2026-01-22T00:00:00Z", "value": 4385 } ], "total": 6672 }, "savedStoryViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 14 }, { "endTime": "2026-01-22T00:00:00Z", "value": 12 } ], "total": 26 }, "scans": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 4 }, { "endTime": "2026-01-22T00:00:00Z", "value": 5 } ], "total": 9 }, "screenshots": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 0 }, { "endTime": "2026-01-22T00:00:00Z", "value": 6 } ], "total": 6 }, "shares": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 4 }, { "endTime": "2026-01-22T00:00:00Z", "value": 2 } ], "total": 6 }, "snapCombinedUniques": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 39 }, { "endTime": "2026-01-22T00:00:00Z", "value": 32 } ], "total": 71 }, "snapCombinedViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 88 }, { "endTime": "2026-01-22T00:00:00Z", "value": 111 } ], "total": 199 }, "snapPaidUniques": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 15 }, { "endTime": "2026-01-22T00:00:00Z", "value": 7 } ], "total": 22 }, "snapPaidViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 10 }, { "endTime": "2026-01-22T00:00:00Z", "value": 16 } ], "total": 26 }, "snapViewTime": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 3455 }, { "endTime": "2026-01-22T00:00:00Z", "value": 2858 } ], "total": 6313 }, "socialUnlocks": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 2 }, { "endTime": "2026-01-22T00:00:00Z", "value": 0 } ], "total": 2 }, "spotlightAvgViewTime": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 8990 }, { "endTime": "2026-01-22T00:00:00Z", "value": 5401 } ], "total": 14391 }, "spotlightCombinedUniques": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 44 }, { "endTime": "2026-01-22T00:00:00Z", "value": 25 } ], "total": 69 }, "spotlightCombinedViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 45 }, { "endTime": "2026-01-22T00:00:00Z", "value": 84 } ], "total": 129 }, "spotlightFavorites": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 3 }, { "endTime": "2026-01-22T00:00:00Z", "value": 2 } ], "total": 5 }, "spotlightPaidUniques": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 9 }, { "endTime": "2026-01-22T00:00:00Z", "value": 4 } ], "total": 13 }, "spotlightPaidViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 13 }, { "endTime": "2026-01-22T00:00:00Z", "value": 4 } ], "total": 17 }, "spotlightSubscribes": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 0 }, { "endTime": "2026-01-22T00:00:00Z", "value": 0 } ], "total": 0 }, "spotlightUniques": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 33 }, { "endTime": "2026-01-22T00:00:00Z", "value": 18 } ], "total": 51 }, "spotlightViewTime": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 6286 }, { "endTime": "2026-01-22T00:00:00Z", "value": 5193 } ], "total": 11479 }, "spotlightViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 24 }, { "endTime": "2026-01-22T00:00:00Z", "value": 33 } ], "total": 57 }, "storyAvgViewTime": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 6740 }, { "endTime": "2026-01-22T00:00:00Z", "value": 6862 } ], "total": 13602 }, "storyFavorites": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 4 }, { "endTime": "2026-01-22T00:00:00Z", "value": 2 } ], "total": 6 }, "storySubscribers": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 546 }, { "endTime": "2026-01-22T00:00:00Z", "value": 547 } ], "total": 1093 }, "storySubscribersGained": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 3 }, { "endTime": "2026-01-22T00:00:00Z", "value": 3 } ], "total": 6 }, "storySubscribes": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 2 }, { "endTime": "2026-01-22T00:00:00Z", "value": 1 } ], "total": 3 }, "storyUniques": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 9 }, { "endTime": "2026-01-22T00:00:00Z", "value": 13 } ], "total": 22 }, "storyViews": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 18 }, { "endTime": "2026-01-22T00:00:00Z", "value": 25 } ], "total": 43 }, "subscribers": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 273 }, { "endTime": "2026-01-22T00:00:00Z", "value": 274 } ], "total": 547 }, "subscribersGained": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 4 }, { "endTime": "2026-01-22T00:00:00Z", "value": 2 } ], "total": 6 }, "subscribes": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 3 }, { "endTime": "2026-01-22T00:00:00Z", "value": 3 } ], "total": 6 }, "swipeDowns": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 6 }, { "endTime": "2026-01-22T00:00:00Z", "value": 4 } ], "total": 10 }, "swipeUps": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 5 }, { "endTime": "2026-01-22T00:00:00Z", "value": 11 } ], "total": 16 }, "uniqueScreenshots": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 3 }, { "endTime": "2026-01-22T00:00:00Z", "value": 0 } ], "total": 3 }, "uniqueSessions": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 34 }, { "endTime": "2026-01-22T00:00:00Z", "value": 11 } ], "total": 45 }, "unsubscribes": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 0 }, { "endTime": "2026-01-22T00:00:00Z", "value": 0 } ], "total": 0 }, "viewTime": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 11140 }, { "endTime": "2026-01-22T00:00:00Z", "value": 7310 } ], "total": 18450 }, "viewers": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 42 }, { "endTime": "2026-01-22T00:00:00Z", "value": 53 } ], "total": 95 }, "views": { "period": "day", "values": [ { "endTime": "2026-01-21T00:00:00Z", "value": 33 }, { "endTime": "2026-01-22T00:00:00Z", "value": 74 } ], "total": 107 } } ], "lastUpdated": "2026-04-20T13:13:47.646Z", "nextUpdate": "2026-04-20T13:24:47.646Z" }, "tiktok": { // TikTok Analytics with "day" period - date range window determined by quarters parameter "analytics": { "addressClicks": { // Number of clicks collected on the Address button past 60 days "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2025-01-21T00:00:00.000Z" }, { "value": 0, "endTime": "2025-01-20T00:00:00.000Z" } ] }, "appDownloadClicks": { // Number of clicks collected on the App Download button past 60 days "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2025-01-21T00:00:00.000Z" }, { "value": 0, "endTime": "2025-01-20T00:00:00.000Z" } ] }, "audienceActivity": { // Hourly follower activity. Updated by TikTok every 24-48 hours after posting. Only available for TikTok accounts with at least 100 followers. "period": "day", "total": 14824, "values": [ { "value": [ { "count": 12386, "hour": "5" }, { "count": 2438, "hour": "9" } ], "endTime": "2025-01-21T00:00:00.000Z" } ] }, "audienceAges": [ // Updated by TikTok every 24-48 hours after posting. Only available for TikTok accounts with at least 100 followers. { "percentage": 0.125, "age": "45-54" }, { "percentage": 0.053, "age": "55+" }, { "percentage": 0.138, "age": "18-24" }, { "percentage": 0.36, "age": "25-34" }, { "percentage": 0.324, "age": "35-44" } ], "audienceCountries": [ { "country": "SV", "percentage": 0.003 }, { "country": "US", "percentage": 0.808 } ], "audienceGenders": [ { "percentage": 0.76, "gender": "Female" }, { "percentage": 0.24, "gender": "Male" }, { "percentage": 0, "gender": "Other" } ], "bio": "This is the bio of the TikTok account", "bioLinkClicks": { // Number of clicks collected on the Bio Link button past 60 days "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2025-01-21T00:00:00.000Z" }, { "value": 0, "endTime": "2025-01-20T00:00:00.000Z" } ] }, "commentCountTotal": { // Total comment count past 60 days "period": "day", "values": [ { "value": 6, "endTime": "2025-01-21T00:00:00.000Z" }, { "value": 6, "endTime": "2025-01-20T00:00:00.000Z" } ] }, "displayName": "ayrshare", "emailClicks": { // Number of clicks collected on the Email button past 60 days "period": "day", "values": [ { "value": 0, "endTime": "2025-01-21T00:00:00.000Z" }, { "value": 0, "endTime": "2025-01-20T00:00:00.000Z" } ] }, "followerCount": { // Daily follower count snapshots (past 60 days) "period": "day", "values": [ { "value": 58, // Total followers at end of this day "endTime": "2025-01-21T00:00:00.000Z" // End of day timestamp }, { "value": 92, "endTime": "2025-01-20T00:00:00.000Z" } ] }, "leadSubmissions": { // Number of leads submitted past 60 days "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2025-01-21T00:00:00.000Z" }, { "value": 0, "endTime": "2025-01-20T00:00:00.000Z" } ] }, "likeCountTotal": { // Total Likes across past 60 days "period": "day", "total": 1161, "values": [ { "value": 625, // Number of likes received on this date "endTime": "2025-01-21T00:00:00.000Z" // End of the day timestamp }, { "value": 536, "endTime": "2025-01-20T00:00:00.000Z" } ] }, "phoneNumberClicks": { // Number of clicks collected on the Phone Number button past 60 days "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2025-01-21T00:00:00.000Z" }, { "value": 0, "endTime": "2025-01-20T00:00:00.000Z" } ] }, "profileViews": { // Total profile views past 60 days "period": "day", "total": 713, "values": [ { "value": 360, "endTime": "2025-01-21T00:00:00.000Z" }, { "value": 353, "endTime": "2025-01-20T00:00:00.000Z" } ] }, "shareCountTotal": { // Total share count past 60 days "period": "day", "total": 3, "values": [ { "value": 2, "endTime": "2025-01-21T00:00:00.000Z" }, { "value": 1, "endTime": "2025-01-20T00:00:00.000Z" } ] }, "url": "https://vm.tiktok.com/ZT2NdEX33/", "userImage": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useastc", "username": "ayrshare", "videoCountTotal": 121, // Total video count "viewCountTotal": { // Total view count past 60 days "period": "day", "total": 17808, "values": [ { "value": 9324, "endTime": "2025-01-21T00:00:00.000Z" }, { "value": 8484, "endTime": "2025-01-20T00:00:00.000Z" } ] } }, "lastUpdated": "2025-01-24T23:33:12.678Z", "nextUpdate": "2025-01-24T23:44:12.678Z" }, "youtube": { // If no analytics are available for a given day, not values will be returned "analytics": { "averageViewDuration": { "period": "day", "total": 4, "values": [ { "value": 4, "endTime": "2024-03-18T00:00:00.000Z" } ] }, "averageViewPercentage": { "period": "day", "total": 61.99, "values": [ { "value": 61.99, "endTime": "2024-03-18T00:00:00.000Z" } ] }, "comments": { "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-03-18T00:00:00.000Z" } ] }, "created": "2010-01-10T15:30:57Z", "description": "The best place to find the best products", "dislikes": { "period": "day", "total": 0, "values": [ { "value": 0, "endTime": "2024-03-18T00:00:00.000Z" } ] }, "estimatedMinutesWatched": { "period": "day", "total": 23.12, "values": [ { "value": 23.12, "endTime": "2024-03-18T00:00:00.000Z" } ] }, "handle": "@helmar1066", "hiddenSubscriberCount": false, "id": "UCsp6CnxiNbUU0AJtuYKZwXQ", "isChannelMonetizationEnabled": false, "isLinked": true, "likes": { "period": "day", "total": 12, "values": [ { "value": 12, "endTime": "2024-03-18T00:00:00.000Z" } ] }, "longUploadsStatus": "allowed", "playlistId": "UUsp6CnxiNbUU0AJtuYKZwXQ", "playlists": [ { "description": "", "id": "PLcLpmVOb3fDaf7Mps-5GnCxRZy_FBBEv4", "publishedAt": "2022-10-21T21:05:55Z", "title": "Super One", "url": "https://www.youtube.com/playlist?list=PLcLpmVOb3fDaf7Mps-5GnCxRZy_FBBEv4", "channelId": "UCsp6CnxiNbUU0AJtuYKZwXQ" }, { "description": "", "id": "FLsp6CnxiNbUU0AJtuYKZwXQ", "publishedAt": "2012-02-26T19:16:55Z", "title": "Favorites", "url": "https://www.youtube.com/playlist?list=FLsp6CnxiNbUU0AJtuYKZwXQ", "channelId": "UCsp6CnxiNbUU0AJtuYKZwXQ" } ], "privacyStatus": "public", "shares": { "period": "day", "total": 3, "values": [ { "value": 3, "endTime": "2024-03-18T00:00:00.000Z" } ] }, "subscriberCount": 0, "subscribersGained": { "period": "day", "total":80, "values": [ { "value": 8, "endTime": "2024-03-18T00:00:00.000Z" } ] }, "subscribersLost": { "period": "day", "total": 1, "values": [ { "value": 1, "endTime": "2024-03-18T00:00:00.000Z" } ] }, "thumbnailUrl": "https://yt3.ggpht.com/ytc/AIdro_lIMzJl5UC7MBEnCzuMpXzai_EvIk5Xh3ErDJ_VTBk=s88-c-k-c0x00ffffff-no-rj", "title": "helmar1066", "url": "https://www.youtube.com/@helmar1066", "videoCount": 5, "videosAddedToPlaylists": { "period": "day", "total": 2, "values": [ { "value": 2, "endTime": "2024-03-18T00:00:00.000Z" } ] }, "videosRemovedFromPlaylists": { "period": "day", "total": 1, "values": [ { "value": 1, "endTime": "2024-03-18T00:00:00.000Z" } ] }, "viewCount": 7, "views": { "period": "day", "total": 3, "values": [ { "value": 3, "endTime": "2024-03-18T00:00:00.000Z" } ] } }, "quarters": 1, "lastUpdated": "2024-04-25T21:24:45.433Z", "nextUpdate": "2024-04-25T21:35:45.433Z" } "status": "success" } ``` ```json 200: Backfilled Response theme={"system"} { "status": "success", "twitter": { "analytics": { "created": "2025-12-19T14:09:06Z", "description": "", "displayName": "Andrew Williams", "followersCount": 1523, "followingCount": 412, "tweetCount": 8721, "likeCount": 3200, "listedCount": 5, "username": "andrewwil1985", "backfilledFrom": "2026-04-08T14:30:00.000Z" }, "lastUpdated": "2026-04-09T10:15:00.000Z", "nextUpdate": "2026-04-09T10:26:00.000Z" } } ``` ```json 200: Recovered Response theme={"system"} { "status": "success", "twitter": { "analytics": { "created": "2025-12-19T14:09:06Z", "description": "", "displayName": "Andrew Williams", "followersCount": 1523, "followingCount": 412, "tweetCount": 8721, "likeCount": 3200, "listedCount": 5, "username": "andrewwil1985", "recoveredFrom": "2026-04-08T14:30:00.000Z" }, "lastUpdated": "2026-04-09T10:15:00.000Z", "nextUpdate": "2026-04-09T10:26:00.000Z" } } ``` ```json 400: Bad Request theme={"system"} { "action": "request", "status": "error", "code": 101, "message": "Missing or incorrect parameters. Please verify with the docs. /rest-api/endpoints Details: One of the platforms requested in not supported." } ``` ```json 400: Social Not Linked theme={"system"} { "linkedin": { "action": "post", "status": "error", "code": 156, "message": "LinkedIn is not properly linked and must be re-linked. Please go to the Social Accounts ppage and re-link LinkedIn." }, "code": 156, "status": "error" } ``` ```json 400: Partial Error theme={"system"} { // A partial error response is returned if some of the data is available but there is an error. "youtube": { "views": 401, "comments": 2, "likes": 37, "dislikes": 2, "estimatedMinutesWatched": 102, "averageViewDuration": 12, "averageViewPercentage": 32.66, "subscribersGained": 2, "subscribersLost": 4, "videosAddedToPlaylists": 2, "videosRemovedFromPlaylists": 1, "shares": 25, "errors": [ { "action": "authorization", "status": "error", "code": 193, "message": "An error occurred connecting to YouTube. Please try your request once more or re-linking YouTube on the social linking page if the issue persists: https://www.ayrshare.com/docs/dashboard/connect-social-accounts/youtube", "details": "Error getting YouTube channel and playlist analytics: Insufficient Permission" } ], "status": "error" }, "lastUpdated": "2025-01-27T02:59:13.119Z", "nextUpdate": "2025-01-27T03:10:13.119Z", "status": "error" } ```