لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

API کے ذریعے Instagram Reels انسائٹس

Instagram کا میڈیا انسائٹس اینڈ پوائنٹ، GET /<IG_MEDIA_ID>/insights، کسی Reel کے لیے یہ میٹرکس واپس کرتا ہے: views، reach، likes، comments، shares، saved، reposts، total_interactions، ig_reels_avg_watch_time، ig_reels_video_view_total_time اور reels_skip_rate۔ کراس پوسٹ کی گئی Reel کے لیے crossposted_views اور facebook_views بھی شامل ہیں۔ plays، clips_replays_count اور ig_reels_aggregated_all_plays_count اپریل 2025 میں ختم کر دیے گئے، اور ان کی جگہ views کو لایا گیا۔

easyCoexistence get_social_insights کے ذریعے کسی Reel کی انسائٹس پڑھتا ہے، تاکہ Claude، ChatGPT یا آپ کا اپنا کوڈ پوچھ سکے کہ کوئی Reel کیسا چلا، اور منسلک اکاؤنٹ کے لیے views، reach، واچ ٹائم اور اسکپ ریٹ براہ راست Meta سے حاصل کرے، جب کوئی میٹرک نام ختم ہو چکا ہو تو Meta کا اپنا ایرر ملے۔

3 seconds

reels_skip_rate کی ونڈو: ویوز میں سے وہ حصہ جس نے Reel کو اس کے پہلے 3 سیکنڈ میں اسکپ کیا

21 Apr 2025

وہ تاریخ جب plays، clips_replays_count اور ig_reels_aggregated_all_plays_count ہر API ورژن میں متروک قرار دیے گئے

3 Dec 2025

وہ تاریخ جب reels_skip_rate، reposts، crossposted_views اور facebook_views میڈیا انسائٹس میں شامل کیے گئے

48 hours

میڈیا میٹرکس کے پیچھے موجود ڈیٹا کتنی دیر تک تاخیر کا شکار ہو سکتا ہے

2 years

Meta میڈیا میٹرکس کتنی دیر تک محفوظ رکھتا ہے

کسی Reel کے کون سے میٹرکس واپس آتے ہیں؟

یہ وہ میٹرکس ہیں جو Meta کے میڈیا انسائٹس حوالہ جاتی صفحے میں media_product_type REELS کے لیے درج ہیں، جنہیں GET /<IG_MEDIA_ID>/insights اور کامہ سے الگ کیے گئے metric پیرامیٹر کے ساتھ پڑھا جاتا ہے۔ Meta ان میں سے کئی میٹرکس کو تخمینہ شدہ یا ڈیولپمنٹ میں قرار دیتا ہے، جس کی نشاندہی ہر میٹرک کے ساتھ کی گئی ہے، اور لائکس اور کمنٹس کو صرف آرگینک سرگرمی میں شمار کرتا ہے:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

Reels انسائٹس کی درخواست کیا واپس کرتی ہے؟

ڈیٹا میں ہر میٹرک کے لیے ایک آبجیکٹ ہوتا ہے، جس میں name، period، values، title، description اور id شامل ہیں۔ period ہمیشہ lifetime پڑھا جاتا ہے؛ Meta اسے میڈیا میٹرکس کے لیے خود طے کرتا ہے اور اسے بدلا نہیں جا سکتا، اس لیے درخواست میں اس کی ضرورت نہیں۔ Meta کے حوالہ جاتی صفحے میں دو واچ ٹائم میٹرکس کو وقت کی مقدار کے طور پر بیان کیا گیا ہے، مگر ان کی اکائی درج نہیں، اس لیے چارٹ بنانے سے پہلے انہیں کسی معلوم Reel سے جانچ لیں۔

A Reels insights request and the shape of its answer
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
  ?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "views",
      "period": "lifetime",
      "values": [{ "value": <VALUE> }],
      "title": "<TITLE>",
      "description": "<DESCRIPTION>",
      "id": "<IG_MEDIA_ID>/insights/views/lifetime"
    }
  ]
}

کون سے Reels میٹرکس ختم ہوئے، اور ان کی جگہ کیا آیا؟

Meta نے پہلے تین میٹرکس Graph API v22.0 سے 21 جنوری 2025 کو متروک کیے، جس دن اس نے views متعارف کیا، اور 21 اپریل 2025 کو ہر ورژن میں؛ video_views کو v21.0 سے اور 8 جنوری 2025 کو ہر ورژن میں متروک کیا گیا۔ ختم شدہ میٹرک کا نام لینے والی درخواست ناکام ہو جاتی ہے، اس لیے 2025 سے پہلے لکھی گئی میٹرکس کی فہرست کو اپ ڈیٹ کرنا ضروری ہے:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

Reel پر views اور reach کیا شمار کرتے ہیں؟

views وہ تعداد ہے جتنی بار Reel Instagram پر چلائی گئی، ایک میٹرک جسے Meta ڈیولپمنٹ میں قرار دیتا ہے؛ reach وہ منفرد اکاؤنٹس ہیں جنہوں نے اسے کم از کم ایک بار دیکھا، جسے Meta تخمینہ شدہ قرار دیتا ہے۔ likes، comments، views اور total_interactions صرف آرگینک سرگرمی شمار کرتے ہیں، Reel سے بنائے گئے اشتہارات پر سرگرمی کو چھوڑ کر۔ total_likes، total_comments اور total_views، جن میں پروموٹ شدہ میڈیا شامل ہے، صرف Facebook Login کے ساتھ دستیاب ہیں۔

کون سی حدیں اور تاخیر لاگو ہوتی ہیں؟

Meta کا میڈیا انسائٹس حوالہ جاتی صفحہ Reel کے اعداد و شمار کے لیے یہ اصول طے کرتا ہے:

  • میٹرکس کے پیچھے موجود ڈیٹا 48 گھنٹے تک تاخیر کا شکار ہو سکتا ہے۔
  • میڈیا میٹرکس 2 سال تک محفوظ رکھے جاتے ہیں۔
  • غائب یا غیر دستیاب ڈیٹا 0 کے بجائے خالی ڈیٹا سیٹ واپس کرتا ہے۔
  • crossposted_views اور facebook_views اس Reel کے لیے ایرر دیتے ہیں جو کراس پوسٹ نہیں ہوئی، اس لیے انہیں اپنی الگ کال میں مانگیں۔
  • جو بریک ڈاؤن درخواست کردہ میٹرک کو سپورٹ نہیں کرتا، وہ پوری درخواست ناکام بنا دیتا ہے اور پیغام آتا ہے: An unknown error has occurred، یعنی ایک نامعلوم ایرر پیش آیا ہے۔
  • Instagram Login کے ساتھ ٹوکن کو graph.instagram.com پر instagram_business_basic اور instagram_business_manage_insights کی اجازتیں درکار ہیں۔

get_social_insights کسی Reel کو کیسے پڑھتا ہے؟

کنکشن کا account_id، Reel کی میڈیا ID کو object_id کے طور پر، اور میٹرکس کی فہرست کے ساتھ۔ easyCoexistence اکاؤنٹ کے ٹوکن کے ساتھ graph.instagram.com پر GET /<IG_MEDIA_ID>/insights کال کرتا ہے، میٹرک کے نام جیسے دیے گئے ہوں ویسے ہی Meta کو بھیجتا ہے، اور Meta کا ڈیٹا واپس کرتا ہے، یا جب کوئی نام ختم ہو چکا ہو تو Meta کا اپنا ایرر۔ list_social_posts اکاؤنٹ کی حالیہ پوسٹس اور Reels کے میڈیا IDs واپس کرتا ہے۔

get_social_insights arguments for one Reel
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<REEL_MEDIA_ID>",
  "metrics": [
    "views", "reach", "likes", "comments", "shares", "saved",
    "total_interactions", "ig_reels_avg_watch_time",
    "ig_reels_video_view_total_time", "reels_skip_rate"
  ]
}

عام غلطیاں

  • plays یا clips_replays_count کی درخواست۔ دونوں کو 21 اپریل 2025 کو ہر API ورژن میں متروک کیا گیا؛ views مانگیں۔
  • عام درخواست میں crossposted_views یا facebook_views شامل کرنا۔ یہ اس Reel کے لیے ایرر دیتے ہیں جو کراس پوسٹ نہیں ہوئی، اور یہ ایرر پوری کال ناکام بنا دیتا ہے۔
  • واچ ٹائم کی اکائی فرض کرنا۔ Meta کے حوالہ جاتی صفحے میں ig_reels_avg_watch_time اور ig_reels_video_view_total_time کی کوئی اکائی درج نہیں، اس لیے کسی معلوم Reel سے جانچیں۔
  • خالی نتیجے کو صفر سمجھنا۔ Meta خالی ڈیٹا سیٹ واپس کرتا ہے جب ڈیٹا موجود نہ ہو یا فی الحال دستیاب نہ ہو۔
EasyCoexistence کے ساتھ یہ کام کرنا

فی کنکشن فی مہینہ US$ 9 سے US$ 0.75 تک، جوں جوں کنکشن بڑھتے ہیں قیمت کم ہوتی ہے، اور پہلے 3 دن کا فری ٹرائل۔

اکثر پوچھے جانے والے سوالات

Reels انسائٹس کی درخواست خالی نتیجہ کیوں واپس کرتی ہے؟

Meta خالی ڈیٹا سیٹ واپس کرتا ہے، 0 نہیں، جب ڈیٹا موجود نہ ہو یا فی الحال دستیاب نہ ہو، اور میٹرکس کے پیچھے کا ڈیٹا 48 گھنٹے تک پیچھے رہ سکتا ہے۔

API سے Reels واچ ٹائم کیسے حاصل کروں؟

GET /<IG_MEDIA_ID>/insights سے اوسط کے لیے ig_reels_avg_watch_time اور کل کے لیے ig_reels_video_view_total_time مانگیں، جس میں ری پلے شامل ہیں۔

reels_skip_rate کیا ہے؟

ابتدائی views میں سے وہ فیصد جنہوں نے Reel کو اس کے پہلے 3 سیکنڈ میں اسکپ کیا۔ Meta نے اسے 3 دسمبر 2025 کو شامل کیا اور تخمینہ شدہ اور ڈیولپمنٹ میں قرار دیا ہے۔

کیا Reels انسائٹس میں اشتہاری views شامل ہوتے ہیں؟

نہیں۔ likes، comments، views اور total_interactions صرف آرگینک سرگرمی شمار کرتے ہیں؛ total_views، جس میں پروموٹ شدہ میڈیا شامل ہے، صرف Facebook Login کے ساتھ دستیاب ہے۔

مزید پڑھیں

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ