मुख्य सामग्री पर जाएं
POST
किसी उपयोगकर्ता की सोशल profile पर analytics और demographics प्राप्त करें, जैसे impressions, views और followers। वर्तमान में Bluesky, Facebook Pages, Google My Business, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok, X/Twitter और YouTube के लिए उपलब्ध है।
Facebook: कुछ reach और वीडियो metrics को Meta ने बंद कर दिया (15 जून 2026)। Meta ने सभी Graph API संस्करणों में unique impression और 3-सेकंड video-view (unique) Insights metrics को हटा दिया, इसलिए Facebook analytics ऑब्जेक्ट अब pagePostsImpressions* परिवार (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*, pagePostsServedImpressionsOrganicUnique) या pageVideoViewsUnique नहीं लौटाता है। reach के लिए pageMediaView का उपयोग करें (एक Total Unique Media Views उत्तराधिकारी की योजना है)। pagePostEngagements, pageVideoViews और pageVideoViewsPaid अप्रभावित हैं। संदर्भ: Upcoming API Changes — June 15, 2026
  • Facebook Page analytics केवल 100 या अधिक likes वाले Pages पर उपलब्ध है, जैसे demographics। Facebook आमतौर पर हर 24 घंटे में एक बार अपने metrics अपडेट करता है।
  • Instagram को analytics डेटा की गणना करने में 48 घंटे तक लग सकते हैं। 100 से कम followers के साथ Follower count analytics उपलब्ध नहीं है। Demographic metrics केवल शीर्ष 45 performers लौटाते हैं, demographic metric गणनाओं में केवल उन दर्शकों का उपयोग किया जाता है जिनके लिए हमारे पास demographic डेटा है, और demographic डेटा नहीं लौटाया जाता है यदि Instagram उपयोगकर्ता के पिछले 30 दिनों में 100 से कम engagements हैं।
  • Instagram सोशल analytics प्राप्त करते समय, विशेष metrics के लिए response में demographic जानकारी दिखाई नहीं दे सकती है। जब प्रत्येक breakdown में 100 से अधिक लोग हों तो demographic जानकारी दिखाई देगी। अधिक जानकारी के लिए कृपया Instagram Analytics Demographics Warning देखें।
  • LinkedIn Company Page analytics और व्यक्तिगत (member) profile analytics दोनों का समर्थन करता है। व्यक्तिगत profiles के लिए, analytics ऑब्जेक्ट में एक lifetime followersCount, followersDaily[] में दैनिक follower वृद्धि, और aggregate पोस्ट metrics (impressionCount, uniqueImpressionsCount, likeCount, commentCount, shareCount) शामिल हैं। LinkedIn count कुल अंततः सुसंगत होते हैं, लेकिन तुरंत सुसंगत नहीं होते, और कुछ मामलों में 24-48 घंटे लग सकते हैं। व्यक्तिगत profiles के लिए aggregate shareCount, likeCount और commentCount best-effort हैं और LinkedIn UI में दिखाए गए नंबरों से थोड़े भिन्न हो सकते हैं।
  • TikTok को अपने analytics डेटा जैसे video views, demographics, likes, shares और comments को अपडेट करने में 24-48 घंटे लग सकते हैं।
  • अतिरिक्त जानकारी के लिए कृपया post analytics endpoint देखें।

Header Parameters

Body Parameters

platforms
array
आवश्यक
analytics प्राप्त करने के लिए सोशल मीडिया platforms। मानों के साथ strings की एक array स्वीकार करता है:
quarters
integer
निर्दिष्ट करता है कि कितने quarters का ऐतिहासिक डेटा लौटाना है। एक quarter है:
  • Facebook के लिए 85 दिन
  • Instagram, TikTok और YouTube के लिए 90 दिन
  • Snapchat के लिए 90 दिन (Snapchat API सीमाओं के कारण अधिकतम 1 quarter / 90 दिन तक सीमित)
Facebook, Instagram, Snapchat, TikTok और YouTube platforms के लिए उपलब्ध। मान्य मान: 1–4। केवल 0 से अधिक मान date filtering सक्रिय करते हैं।Date filtering (Instagram & TikTok): Date filtering तब सक्रिय होती है जब daily=true या quarters > 0। यदि न तो daily और न ही quarters प्रदान किया गया है, तो सभी समय का डेटा बिना date filter लागू किए लौटाया जाता है।नोट: quarters: 0 को अब कोई date range नहीं (सभी समय का डेटा) माना जाता है। पहले, quarters: 0 को quarters: 1 माना जाता था।
daily
boolean
डिफ़ॉल्ट:false
true पर सेट होने पर, aggregated कुल के बजाय analytics डेटा को दैनिक time-series मानों के रूप में लौटाता है। यह विकल्प केवल Facebook, Instagram, Snapchat, TikTok और YouTube platforms के लिए उपलब्ध है। बड़े डेटा आकार के कारण, compression का उपयोग करने की अनुशंसा की जाती है।Instagram और TikTok के लिए, daily=true सेट करने से एक डिफ़ॉल्ट छोटी quarters विंडो का उपयोग करके date filtering भी सक्रिय हो जाती है।Instagram reach: daily=true के साथ, Instagram response गैर-दैनिक मोड में लौटाए गए scalar reachCount फ़ील्ड के बजाय एक nested reach ऑब्जेक्ट (जिसमें period और एक values time-series शामिल है) लौटाता है।
period60Days
boolean
डिफ़ॉल्ट:false
TikTok analytics के लिए, true पर सेट होने पर, यह केवल comments, shares और views के लिए 60-दिन के aggregate कुल लौटाता है (commentCountTotal, shareCountTotal, viewCountTotal)। यह पूर्ण analytics history प्राप्त करने की तुलना में तेज़ response समय प्रदान करता है। नोट: इस पैरामीटर का उपयोग daily=true के साथ न करें क्योंकि वे असंगत हैं।महत्वपूर्ण: 1 मार्च 2025 से, TikTok 60-दिन के कुल पर स्थानांतरित हो गया। अप्रैल 2026 से, TikTok quarters-आधारित date filtering का उपयोग करता है — date विंडो को नियंत्रित करने के लिए quarters पैरामीटर का उपयोग करें (उदा., quarters: 1 = 90 दिन, quarters: 2 = 180 दिन)। विवरण के लिए upcoming changes देखें।
youtube
object
YouTube analytics के लिए Platform-विशिष्ट विकल्प।lifetime (boolean, default: false): true पर सेट होने पर, response में lifetimeLikes शामिल करता है - चैनल पर सभी सार्वजनिक वीडियो में likes का योग। यह सभी वीडियो प्राप्त करके और उनकी like गिनती का योग करके गणना किया जाता है, इसलिए कई वीडियो वाले चैनलों के लिए इसमें अधिक समय लग सकता है।Threshold: 1,000 से अधिक वीडियो वाले चैनल lifetimeLikes: null और शीर्ष-स्तरीय warnings array में एक warning लौटाएँगे। यह अत्यधिक API उपयोग को रोकता है।Caching: प्रति-चैनल, गैर-सफलता परिणामों के लिए छोटे TTLs के साथ ताकि पुनःप्रयास स्थिति परिवर्तनों को तुरंत पकड़ सके:
  • सफल lifetimeLikes मान: 24 घंटे
  • 1,000-वीडियो बेलआउट (warning code: 445): 1 घंटा — इतना छोटा कि एक चैनल जो threshold से नीचे जाने के लिए वीडियो हटाता है उसे वास्तविक मान के लिए पूरे दिन इंतज़ार नहीं करना पड़ता।
  • अस्थायी YouTube Data API विफलताएँ (warning code: 446): cache नहीं किया जाता — अगला request पुनःप्रयास करता है।
नोट: हटाए गए या निजी वीडियो को योग से बाहर रखा जाता है, इसलिए कुल उन चैनलों के लिए “true” lifetime likes से भिन्न हो सकता है जिन्होंने वीडियो हटा दिए हैं।Request उदाहरण:
userId
string
केवल X/Twitter। यह पैरामीटर आपको अपने linked account से नहीं बल्कि किसी विशिष्ट X/Twitter उपयोगकर्ता से उनके numeric ID द्वारा पोस्ट प्राप्त करने की अनुमति देता है।उदाहरण के लिए, handle @Google से सभी पोस्ट प्राप्त करने के लिए, आप उनके numeric userId 20536157 का उपयोग करेंगे।आप Brands Get User endpoint का उपयोग करके किसी भी X/Twitter उपयोगकर्ता का numeric userId ढूँढ सकते हैं।नोट: यह request करने के लिए header में केवल API KEY का उपयोग करें। Profile Key शामिल न करें।
userName
string
केवल X/Twitter। यह पैरामीटर आपको अपने linked account से नहीं बल्कि किसी विशिष्ट X/Twitter उपयोगकर्ता से उनके handle द्वारा पोस्ट प्राप्त करने की अनुमति देता है।उदाहरण के लिए, handle @Google से सभी पोस्ट प्राप्त करने के लिए।नोट: यह request करने के लिए header में केवल API KEY का उपयोग करें। Profile Key शामिल न करें।
जब cumulative metrics (जैसे, followers, likes) सोशल नेटवर्क से अस्थायी रूप से अनुपलब्ध होते हैं, तो API उन्हें संग्रहीत डेटा से स्वचालित रूप से backfill करता है। प्रति-platform analytics ऑब्जेक्ट में दो वैकल्पिक फ़ील्ड दिखाई दे सकते हैं:
  • backfilledFrom (string, ISO 8601) — जब एक या अधिक cumulative metrics को संग्रहीत डेटा से प्रतिस्थापित किया गया हो तो मौजूद। timestamp इंगित करता है कि संग्रहीत डेटा अंतिम बार कब अपडेट किया गया था।
  • recoveredFrom (string, ISO 8601) — जब पूर्ण API विफलता के कारण संपूर्ण analytics response संग्रहीत डेटा से पुनः प्राप्त किया गया हो तो मौजूद। timestamp इंगित करता है कि संग्रहीत डेटा अंतिम बार कब अपडेट किया गया था।
4 दिन से पुराने संग्रहीत डेटा को stale माना जाता है और इसका उपयोग backfill या recovery के लिए नहीं किया जाएगा।LinkedIn reactions: पोस्ट-स्तरीय cumulative reactions metric (प्रति-प्रकार reaction गिनती का एक ऑब्जेक्ट) इस empty-only backfill के अधीन है। जब LinkedIn reactions fetch को rate-limit करता है, तो मान अंतिम सफल snapshot से आगे बढ़ता है — और backfilledFrom उस snapshot के timestamp पर सेट होता है — खाली होने के बजाय।
LinkedIn व्यक्तिगत (member) analytics — फिर से link आवश्यक। member analytics के आने से पहले लिंक किए गए व्यक्तिगत LinkedIn profiles में आवश्यक analytics scopes नहीं हैं। उन profiles के लिए सोशल analytics requests error code 475 (“re-link your LinkedIn profile to enable analytics”) लौटाते हैं। खाता स्वामी को नए scopes प्रदान करने के लिए Social Accounts पेज पर अपने LinkedIn profile को फिर से link करना होगा। code 475 को साफ़ होने के लिए फिर से link करने के बाद कुछ मिनट प्रतीक्षा करें (Ayrshare और LinkedIn दोनों permission स्थिति को संक्षेप में cache करते हैं, आमतौर पर ~5-10 मिनट)। पोस्टिंग अप्रभावित है।
warnings (objects की array, वैकल्पिक शीर्ष-स्तरीय फ़ील्ड) — केवल तब मौजूद जब Ayrshare को caller को गैर-घातक स्थिति के बारे में सूचित करने की आवश्यकता हो (जैसे, एक opt-in गणना छोड़ी गई थी)। जब warn करने के लिए कुछ नहीं होता तो response से अनुपस्थित।प्रत्येक entry एक संरचित ऑब्जेक्ट है, न कि एक free-form string:ज्ञात warning codes:
  • 445lifetimeLikes को छोड़ दिया गया क्योंकि YouTube चैनल 1,000-वीडियो threshold से अधिक है।
  • 446lifetimeLikes अनुपलब्ध क्योंकि YouTube Data API ने uploads playlist या हर videos.list batch के लिए errors लौटाए।