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

# 按平台查询帖子历史

> 获取某平台已发布帖子的历史，包括并非通过 Ayrshare 发布的帖子

export const XByoNotice = () => <Info>
  <strong>Targeting X/Twitter?</strong> Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:
  <br /><br />
  <code>X-Twitter-OAuth1-Api-Key</code> — Your API Key (Consumer Key)<br />
  <code>X-Twitter-OAuth1-Api-Secret</code> — Your API Key Secret (Consumer Secret)
  <br /><br />
  <strong>One-time setup per Ayrshare account.</strong> You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do <em>not</em> create a new app per customer.
  <br /><br />
  Not linked yet? See the <a href="/dashboard/connect-social-accounts/x-twitter-byo-keys">full setup guide</a> to connect your X account.
  <br /><br />
  Your keys are never logged or stored by Ayrshare.
</Info>;

export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <>
    <ParamField header="Authorization" type="string" required>
      <a href="/apis/overview#authorization">API Key</a> of the Primary Profile.
      <br />
      <br />
      Format: <code>Authorization: Bearer API_KEY</code>
    </ParamField>
    {!noProfileKey && (profileKeyRequired ? <ParamField header="Profile-Key" type="string" required>
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField> : <ParamField header="Profile-Key" type="string">
          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
          <br />
          <br />
          Format: <code>Profile-Key: PROFILE_KEY</code>
        </ParamField>)}
  </>;

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 <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["premium"]} maxPackRequired={false} />

<XByoNotice />

该接口允许你从主流社交网络（Bluesky、Facebook、Instagram、LinkedIn、Pinterest、Threads、TikTok、X/Twitter 和 YouTube）获取帖子及其分析数据。它适用于这些平台上的所有帖子——无论是通过 Ayrshare API 创建，还是直接在社交网络界面发布。
更详细的分析数据可通过[分析接口](/apis/analytics/overview)获取。

该接口返回的 ID 是社交网络原生的[社交帖子 ID（social post ID）](/apis/overview#social-post-id)，而不是 [Ayrshare post ID](/apis/overview#ayrshare-post-id)。
这样你可以获取社交网络上任意帖子的详情，即使该帖子并非通过 Ayrshare 创建。
例如，你可以获取一条在 facebook.com 上手动发布的帖子，并使用返回的 Facebook [社交帖子 ID](/apis/overview#social-post-id)来[获取评论](/apis/comments/get-comments)或[获取分析](/apis/analytics/social-by-id)。

如果你不需要来自 Ayrshare 之外的帖子，只需将某条帖子返回的 [Ayrshare post ID](/apis/overview#ayrshare-post-id) 与 [comment](/apis/comments/post-comment)、[analytics](/apis/analytics/post) 或 [history](/apis/history/history-social-id) 接口配合使用。

`:platform` = `bluesky`、`facebook`、`instagram`、`linkedin`、`pinterest`、`snapchat`、`threads`、`tiktok`、`twitter`、`youtube`。

示例：`https://api.ayrshare.com/api/history/instagram`

### 受版权保护的媒体

Instagram 和 TikTok 会在响应中排除所有受版权保护的媒体。

<ul class="custom-bullets">
  <li>
    如果媒体包含受版权保护的素材或被标记为侵犯版权，Instagram 响应中会省略 `mediaUrl` 字段。
    受版权保护的素材示例包括 Reels 中的音频。你可以在 Instagram 应用的 Settings -> Account Status 中查看。
  </li>

  <li>
    如果媒体包含受版权保护的素材或被标记为侵犯版权，TikTok 不会返回该媒体。
    受版权保护的素材示例包括 Reels 中的音频（TikTok 会将这些视频静音）。你可以在 TikTok 应用的 Activity -> System Notifications 中查看。

    如果视频被静音，你可以在 TikTok 应用中添加音频。
    进入该帖子并选择添加非版权音频的选项。
    之后该视频就会在此 API 响应中返回。
  </li>
</ul>

### 限制

#### Facebook

<ul class="custom-bullets">
  <li>
    已过期/归档的 Stories（超过 24 小时）会被自动过滤。默认响应中仅包含有效的 Stories。
  </li>

  <li>
    使用 `dataType` 查询参数可只请求 `posts` 或只请求 `stories`。
  </li>

  <li>
    使用 `since` 和 `until` 查询参数按日期范围筛选帖子。
  </li>
</ul>

#### Instagram

<ul class="custom-bullets">
  <li>
    响应中不包含 Live Video stories。
  </li>

  <li>
    Stories 仅在 24 小时内可用。
  </li>

  <li>
    用户转发 Story 时新生成的 story 不会被返回。转发 Story 包括使用 Add Yours 模板创建的 story。
  </li>

  <li>
    用户接受协作邀请后新生成的帖子不会被返回。
  </li>

  <li>
    使用 `dataType` 查询参数可只请求 `posts` 或只请求 `stories`。
  </li>
</ul>

## 请求头参数

<HeaderAPI />

## 路径参数

<ParamField path="platform" type="string" required>
  要检索帖子的平台。取值：`bluesky`、`facebook`、
  `instagram`、`linkedin`、`pinterest`、`snapchat`、`threads`、`tiktok`、
  `twitter`、`youtube`。
</ParamField>

## 查询参数

<ParamField query="limit" type="number" default={10}>
  返回的历史记录数量。最大 limit：500<sup>\*</sup>

  较高的 limit 可能导致响应变慢，建议使用不超过 100 的值。

  <sup>\*</sup>Enterprise plan 支持更高的 limit。详情请联系你的客户经理。
</ParamField>

<ParamField query="skipAnalytics" type="boolean" default={false}>
  跳过 Facebook Pages 和 Instagram 的完整分析数据收集。仅返回 Social Post ID。
  当不需要分析数据（仅需要 Social Post ID）、希望更快响应，或 limit > 100 时出现错误时使用。
</ParamField>

<ParamField query="pagePublished" type="boolean" default={10}>
  仅 Facebook。默认返回的帖子来自 Facebook Page feed。你也可以选择只返回由 Page 自身发布的帖子。

  当你希望更全面地查看与该 Page 相关的所有内容（包括其他用户的互动）时，请使用 feed（默认）；当你只想检索由 Page 自身发布的帖子时，请使用 `pagePublished`。
</ParamField>

<ParamField query="userId" type="string">
  仅 X/Twitter。通过该参数，你可以按数字 ID 检索特定 X/Twitter 用户的帖子，而不是从已关联的账户中检索。

  例如，要获取 `@Google` 账号的所有帖子，可以使用其数字 userId `20536157`。

  你可以通过 [Brands Get User](/apis/listen/brand-user) 接口查找任何 X/Twitter 用户的数字 userId。

  注意：发起此请求时，请求头中仅使用 API KEY，不要包含 Profile Key。
</ParamField>

<ParamField query="userName" type="string">
  仅 X/Twitter。通过该参数，你可以按用户名（handle）检索特定 X/Twitter 用户的帖子，而不是从已关联的账户中检索。

  例如，获取 `@Google` 账号的所有帖子。

  注意：发起此请求时，请求头中仅使用 API KEY，不要包含 Profile Key。
</ParamField>

<ParamField query="next" type="string">
  基于游标的分页参数，用于获取下一页结果。将上次响应 `meta.pagination` 对象中的 `next` 值传入，以获取下一组帖子。
</ParamField>

<ParamField query="since" type="string">
  仅 Facebook。ISO UTC 日期字符串，用于筛选在该日期当天或之后创建的帖子。可与 `until` 配合使用，指定具体日期范围。

  示例：`since=2026-03-17`
</ParamField>

<ParamField query="until" type="string">
  仅 Facebook。ISO UTC 日期字符串，用于筛选在该日期当天或之前创建的帖子。可与 `since` 配合使用，指定具体日期范围。

  示例：`until=2026-03-20`
</ParamField>

<ParamField query="dataType" type="string">
  Facebook 和 Instagram。筛选返回的内容类型。默认同时返回普通帖子和有效 Stories。

  取值：

  * `posts` — 仅普通帖子（不含 Stories）
  * `stories` — 仅 Stories

  省略此参数则同时返回帖子与 Stories（默认行为）。

  注意：对于 Facebook，已过期/归档的 Stories（超过 24 小时）会被自动过滤。对于 Instagram，Stories 仅在 24 小时内可用。
</ParamField>

## 分页响应

使用基于游标的分页（通过 `next` 查询参数）时，响应包含一个 `meta.pagination` 对象，其中携带分页状态。

每次分页响应中的 `posts` 数组包含与下文各平台响应示例结构相同的对象。

<ResponseField name="meta.pagination" type="object">
  基于游标遍历结果时的分页元数据。

  <Expandable title="properties">
    <ResponseField name="hasMore" type="boolean">
      指示当前页之后是否还有更多结果。当为 `true` 时，使用 `next` 游标获取更多帖子。
    </ResponseField>

    <ResponseField name="next" type="string">
      不透明的游标字符串，作为 `next` 查询参数传入以获取下一页结果。仅当 `hasMore` 为 `true` 或还有更多结果时出现。
    </ResponseField>

    <ResponseField name="limit" type="number">
      每页请求的结果数量。
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```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"}
  <?php

  $apiUrl = 'https://api.ayrshare.com/api/history/instagram';
  $apiKey = 'API_KEY';  // Replace 'API_KEY' with your actual API key

  $headers = [
      'Content-Type: application/json',
      'Authorization: Bearer ' . $apiKey,
  ];

  $curl = curl_init($apiUrl);
  curl_setopt_array($curl, [
      CURLOPT_RETURNTRANSFER => 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}");
              }
          }
      }
  }
  }
  ```
</RequestExample>

<ResponseExample>
  ```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 }
      ]
  }
  ```
</ResponseExample>