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

# Social ID द्वारा पोस्ट पर Analytics

> Social Post ID का उपयोग करके पोस्ट के लिए real-time analytics प्राप्त करें

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 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>;
};

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>)}
  </>;

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

<XByoNotice />

low-level [Social Post ID](/apis/overview#social-post-id) प्रदान करके उन पोस्ट के लिए analytics प्राप्त करें जो Ayrshare के माध्यम से उत्पन्न नहीं हुए थे।
यह ID [/post endpoint](/apis/post/post) के `postIds` फ़ील्ड में लौटाई जाती है।

analytics प्राप्त करने के लिए linked account पोस्ट का स्वामी होना चाहिए (अपवाद: YouTube; नीचे देखें)। समर्थित platforms: `Facebook`, `Instagram`, `LinkedIn`, `Threads`, `TikTok`, `Twitter`, और `YouTube`।

<ul className="custom-bullets">
  <li>
    यह call [Analytics on a Post endpoint](/apis/analytics/post) के समान है। मुख्य
    अंतर यह है कि आप Ayrshare ID के बजाय social network द्वारा लौटाई गई post id का उपयोग करते हैं। साथ ही
    endpoint को सूचित करने के लिए `searchPlatformId: true` parameter शामिल करें कि आप Social Post ID द्वारा खोज रहे हैं।
  </li>

  <li>
    `id` फ़ील्ड में पाए गए Ayrshare के बाहर उत्पन्न पोस्ट और IDs को प्राप्त करने के लिए
    [Get All Post History endpoint](/apis/history/overview) का उपयोग करें।
  </li>

  <li>
    केवल उन पोस्ट के लिए उपयोग करने की सलाह है जो Ayrshare के माध्यम से नहीं भेजे गए। Ayrshare के माध्यम से भेजे गए पोस्ट के लिए,
    [analytics endpoint](/apis/analytics/post) का उपयोग करें।
  </li>

  <li>
    Instagram पोस्ट पर analytics जो उपयोगकर्ता के account को personal से business account में परिवर्तित करने से पहले प्रकाशित किए गए थे,
    उनके पास सीमित analytics होते हैं।
  </li>

  <li>
    यदि social id पद्धति का उपयोग करके किसी ऐसे पोस्ट के लिए YouTube analytics प्राप्त कर रहे हैं जो आपके channel का नहीं है,
    तो API सामग्री के बारे में descriptive metadata लौटाएगा जबकि सभी संख्यात्मक metrics के लिए zero दिखाएगा।
    descriptive जानकारी जैसे title, description, tags, channel title, privacy status, और thumbnail URLs
    सही ढंग से भरी जाएँगी, video सामग्री के बारे में context प्रदान करेंगी। हालाँकि, views, likes, comments,
    shares, subscriber परिवर्तन, watch time, और playlist additions सहित सभी संख्यात्मक performance metrics
    zero values के रूप में लौटेंगे।
  </li>

  <li>
    X/Twitter threads के लिए `postIds` का उपयोग करते समय, प्रत्येक tweet की Social Post ID अलग से प्रदान की जानी चाहिए,
    thread tweets स्वचालित रूप से शामिल नहीं होते जब parent post के लिए query की जाती है।
  </li>
</ul>

## Header Parameters

<HeaderAPI />

## Body Parameters

<Note>
  या तो `id` या `postIds` प्रदान करना आवश्यक है। एकल पोस्ट के लिए `id` का उपयोग करें या एक ही request में कई पोस्ट पर analytics प्राप्त करने के लिए `postIds` का उपयोग करें।
</Note>

<ParamField body="id" type="string">
  [/post endpoint](/apis/post/post) से लौटाई गई [Social Post ID](/apis/overview#social-post-id)। यह `postIds` array में पाए गए
  किसी व्यक्तिगत social network के लिए `id` फ़ील्ड है। या तो `id` या `postIds` आवश्यक है।
</ParamField>

<ParamField body="postIds" type="array">
  एक ही request में कई पोस्ट पर analytics प्राप्त करने के लिए [Social Post IDs](/apis/overview#social-post-id) का Array। अधिकतम 100 IDs की अनुमति है। या तो `id` या `postIds` आवश्यक है।

  ```json theme={"system"}
  {
    "postIds": ["1979851549871354062", "2011793803951137234"]
  }
  ```
</ParamField>

<ParamField body="platforms" type="array" required>
  analytics प्राप्त करने के लिए platforms का String array। केवल एक मान की अनुमति है।

  उपलब्ध मान:

  ```json theme={"system"}
  {
    "platforms": ["facebook", "instagram", "linkedin", "threads",
                  "tiktok", "twitter", "youtube"]
  }
  ```
</ParamField>

<ParamField body="searchPlatformId" type="boolean" default={false} required>
  Social Post ID द्वारा खोजने के लिए `true` पर सेट करें।
</ParamField>

<RequestExample>
  ```json Single Post theme={"system"}
  {
      // Facebook Social Post ID
      "id": "104923907983682_108329000309742",
      "platforms": [
        // एक बार में केवल एक platform चुनें:
        // facebook, instagram, youtube, threads, tiktok, या twitter
          "facebook"
      ],
      "searchPlatformId": true // आवश्यक
  }
  ```

  ```json Multiple Posts theme={"system"}
  {
      // Social Post IDs का Array (max 100)
      "postIds": ["1979851549871354062", "2011793803951137234"],
      "platforms": [
        // एक बार में केवल एक platform चुनें:
        // facebook, instagram, youtube, threads, tiktok, या twitter
          "twitter"
      ],
      "searchPlatformId": true // आवश्यक
  }
  ```
</RequestExample>

<Info>
  जब cumulative metrics (उदा., likes, comments, views) social network से अस्थायी रूप से अनुपलब्ध हों, तो API स्वचालित रूप से stored data से उन्हें backfill करता है। प्रति-platform `analytics` object में दो वैकल्पिक फ़ील्ड दिखाई दे सकते हैं:

  * **`backfilledFrom`** (string, ISO 8601) — तब मौजूद जब एक या अधिक cumulative metrics को stored data से प्रतिस्थापित किया गया हो। timestamp इंगित करती है कि stored data कब अंतिम बार update हुआ था।
  * **`recoveredFrom`** (string, ISO 8601) — तब मौजूद जब पूरी analytics response को पूर्ण API failure के कारण stored data से recover किया गया हो। timestamp इंगित करती है कि stored data कब अंतिम बार update हुआ था।

  4 दिन से पुराने stored data को stale माना जाता है और backfill या recovery के लिए उपयोग नहीं किया जाएगा।
</Info>

<ResponseExample>
  ```json 200: Single Post Response theme={"system"}
  {
    /**
      Response Analytics on a Post के समान है।
      विवरण के लिए कृपया वह endpoint देखें।

      नोट: authorized account के स्वामित्व वाले पोस्ट के अलावा कुछ metrics उपलब्ध नहीं हैं।
      उदाहरण के लिए: X, authorized user द्वारा नहीं भेजे गए Tweets के लिए non-public metrics या organic metrics नहीं लौटाता।
    */
  }
  ```

  ```json 200: Multiple Posts Response theme={"system"}
  {
      "twitter": [
          {
              "id": "1313589441919827982",    // Twitter Social Post ID
              "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
              "analytics": {
                  "created": "2022-09-07T22:12:10.000Z",
                  "entities": {
                      "urls": [
                          {
                              "start": 77,
                              "end": 96,
                              "url": "https://t.co/abc123",
                              "expandedUrl": "https://www.ayrshare.com/docs",
                              "displayUrl": "ayrshare.com/docs",
                              "unwoundUrl": "https://www.ayrshare.com/docs"
                          }
                      ],
                      "hashtags": [
                          {
                              "start": 97,
                              "end": 112,
                              "tag": "SocialMediaAPI"
                          }
                      ],
                      "mentions": [
                          {
                              "start": 113,
                              "end": 122,
                              "username": "ayrshare"
                          }
                      ]
                  },
                  "name": "Wonder World",
                  "post": "Just launched our social media campaign using Ayrshare! Check out the API at https://t.co/abc123 #SocialMediaAPI @ayrshare",
                  "publicMetrics": {
                      "retweetCount": 0,
                      "quoteCount": 0,
                      "likeCount": 0,
                      "replyCount": 0,
                      "bookmarkCount": 0,
                      "impressionCount": 23
                  },
                  "nonPublicMetrics": {
                      "userProfileClicks": 1,
                      "engagements": 1,
                      "impressionCount": 5
                  },
                  "organicMetrics": {
                      "likeCount": 0,
                      "impressionCount": 5,
                      "replyCount": 0,
                      "retweetCount": 0,
                      "userProfileClicks": 1
                  },
                  "username": "wondrous"
              },
              "lastUpdated": "2022-04-23T18:44:29.778Z",
              "nextUpdate": "2022-04-23T19:19:29.778Z"
          },
          {
              "id": "1313589441919827999",    // Twitter Social Post ID
              "postUrl": "https://www.twitter.com/myaccount/1313589441919827999",
              "analytics": {
                  "created": "2022-09-08T14:30:00.000Z",
                  "name": "Wonder World",
                  "post": "Another great day for social media automation!",
                  "publicMetrics": {
                      "retweetCount": 5,
                      "quoteCount": 2,
                      "likeCount": 15,
                      "replyCount": 3,
                      "bookmarkCount": 1,
                      "impressionCount": 150
                  },
                  "nonPublicMetrics": {
                      "userProfileClicks": 8,
                      "engagements": 12,
                      "impressionCount": 145
                  },
                  "organicMetrics": {
                      "likeCount": 15,
                      "impressionCount": 145,
                      "replyCount": 3,
                      "retweetCount": 5,
                      "userProfileClicks": 8
                  },
                  "username": "wondrous"
              },
              "lastUpdated": "2022-04-23T18:44:29.778Z",
              "nextUpdate": "2022-04-23T19:19:29.778Z"
          }
      ],
      "status": "success",
      "code": 200
  }
  ```

  ```json 200: Backfilled Response theme={"system"}
  {
      "twitter": [
          {
              "id": "1313589441919827982",
              "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
              "analytics": {
                  "created": "2022-09-07T22:12:10.000Z",
                  "name": "Wonder World",
                  "post": "Just launched our social media campaign!",
                  "publicMetrics": {
                      "retweetCount": 5,
                      "quoteCount": 2,
                      "likeCount": 15,
                      "replyCount": 3,
                      "bookmarkCount": 1,
                      "impressionCount": 150
                  },
                  "username": "wondrous",
                  "backfilledFrom": "2026-04-08T14:30:00.000Z"
              },
              "lastUpdated": "2026-04-09T10:15:00.000Z",
              "nextUpdate": "2026-04-09T10:26:00.000Z"
          }
      ],
      "status": "success",
      "code": 200
  }
  ```

  ```json 200: Recovered Response theme={"system"}
  {
      "twitter": [
          {
              "id": "1313589441919827982",
              "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
              "analytics": {
                  "created": "2022-09-07T22:12:10.000Z",
                  "name": "Wonder World",
                  "post": "Just launched our social media campaign!",
                  "publicMetrics": {
                      "retweetCount": 5,
                      "quoteCount": 2,
                      "likeCount": 15,
                      "replyCount": 3,
                      "bookmarkCount": 1,
                      "impressionCount": 150
                  },
                  "username": "wondrous",
                  "recoveredFrom": "2026-04-08T14:30:00.000Z"
              },
              "lastUpdated": "2026-04-09T10:15:00.000Z",
              "nextUpdate": "2026-04-09T10:26:00.000Z"
          }
      ],
      "status": "success",
      "code": 200
  }
  ```

  ```json 400: Bad Request theme={"system"}
  {
      "lastUpdated": "2023-12-08T03:40:31.185Z",
      "nextUpdate": "2023-12-08T03:51:31.185Z",
      "youtube": {
          "action": "post",
          "status": "error",
          "code": 186,
          "message": "Post ID not found. Please verify the top level ID returned from the /post endpoint is being sent, the Profile Key is included if applicable, and the post at the social network has not been deleted. If you are trying to retrieve a post originating outside of Ayrshare, please use the /rest-api/endpoints/analytics#analytics-by-social-id",
          "id": "dtuu-jDp4381"
      }
  }
  ```
</ResponseExample>