התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

Instagram Hashtag Search API: מציאת פוסטים לפי האשטאג

חיפוש האשטאגים של Instagram מוצא תמונות וסרטונים ציבוריים שנושאים האשטאג, בשתי קריאות. GET /ig_hashtag_search עם user_id ו-q מחזיר את המזהה של האשטאג, ואז GET /<HASHTAG_ID>/top_media מציג את הפוסטים הפופולריים ביותר, ו-/recent_media את אלה שפורסמו ב-24 השעות האחרונות. לחשבון אפשר לחפש 30 אשטאגים שונים ב-7 ימים מתגלגלים, עם Facebook Login או Unified Login.

easyCoexistence מחברת את Instagram באמצעות Instagram Login, כך ש-Claude, ChatGPT או הקוד שלכם יכולים לעבוד על הפוסטים, התגובות, האזכורים והנתונים של החשבון עצמו דרך ה-API הרשמי של Meta, והתגובות והאזכורים יכולים להתקבל בנקודת הקצה שלכם כשהם מגיעים.

30

מספר האשטאגים הייחודיים שחשבון עסקי או יוצר יכול לחפש בתקופה מתגלגלת של 7 ימים.

24 hours

recent_media מחזיר רק מדיה שפורסמה בתוך 24 שעות מרגע השאילתה.

50

top_media מחזיר את מספר התוצאות הגבוה ביותר בכל עמוד, והמעבר בין עמודים נעשה רק באמצעות הפרמטר after.

Not supported

חיפוש אשטאגים עם Instagram API ועם Instagram Login מופיע בהשוואה של Meta בין שלוש ההגדרות.

Static

כל אשטאג שומר על אותו מזהה סטטי וגלובלי לכל אפליקציה ולכל משתמש.

איך חיפוש האשטאגים עובד?

בשני שלבים, שמבוצעים בשם חשבון עסקי או יוצר ב-Instagram, ושהמזהה שלו נכנס ל-user_id. GET /ig_hashtag_search עם q שמוגדר לשם האשטאג מחזיר את המזהה שלו, ש-Meta מציינת שהוא סטטי וגלובלי, כך שאפשר לשמור אותו. לאחר מכן GET /<HASHTAG_ID>/top_media או /recent_media, עם user_id ו-fields, מציג את הפוסטים.

Finding a hashtag's ID, then its recent posts
GET /ig_hashtag_search?user_id=<IG_ID>&q=coffee

{ "data": [ { "id": "<HASHTAG_ID>" } ] }

GET /<HASHTAG_ID>/recent_media
  ?user_id=<IG_ID>
  &fields=id,media_type,permalink,timestamp,like_count,comments_count

מה ההבדל בין top_media ל-recent_media?

top_media מחזיר את התמונות והסרטונים הפופולריים ביותר שמתויגים באשטאג, ו-Meta קובעת את הפופולריות לפי שילוב של צפיות ואינטראקציה של הצופים. recent_media מחזיר את אלה שפורסמו לאחרונה, מוגבל למדיה שפורסמה בתוך 24 שעות מרגע השאילתה, ו-Meta מציינת שהתשובות שלו לא תמיד מסודרות בסדר כרונולוגי. שניהם מחזירים מדיה ציבורית בלבד, לא כוללים מדיה מקודמת, מוגברת ומודעות, ומדפדפים בין התוצאות 50 בכל פעם עם הסמן after.

אילו שדות חוזרים?

שדות המדיה ש-Meta מפרטת במסמכים שלה לשני הנתיבים, שמחזירים תמונות וסרטונים ציבוריים בלבד:

  • id, media_type (CAROUSEL_ALBUM, IMAGE או VIDEO), permalink ו-timestamp.
  • caption ו-comments_count, וכן like_count אלא אם הבעלים הסתיר את ספירת הלייקים.
  • children למדיית אלבום, ו-media_url למדיה אחרת, אבל לא לסרטונים עם מוזיקה מוגנת בזכויות יוצרים או ברישיון.
  • לא username: Meta לא מאפשרת אותו במדיה שמוחזרת מחיפוש אשטאגים.

מה המגבלות?

Meta קובעת אותן לכל חשבון ולכל אשטאג:

  • 30 אשטאגים ייחודיים ב-7 ימים מתגלגלים. אשטאג נספר מהשאילתה הראשונה שלו. שאילתה חוזרת לאותו אשטאג באותו פרק זמן לא נספרת, ואינה מאפסת את 7 הימים שלו.
  • שליפת top_media או recent_media נספרת כשאילתה לאשטאג, גם כשהמזהה שלו כבר שמור.
  • GET /<IG_ID>/recently_searched_hashtags מציג את האשטאגים הייחודיים שהחשבון חיפש בשבוע הנוכחי.
  • אשטאגים ב-Stories ואימוג'ים בשאילתות אינם נתמכים, ואשטאגים ש-Meta מסווגת כרגישים או פוגעניים מחזירים שגיאה כללית.
  • אי אפשר להגיב למדיה שנמצאה בדרך זו דרך ה-API.

מה חיפוש אשטאגים דורש?

אישור App Review לתכונה Instagram Public Content Access ולהרשאה instagram_basic, ש-Meta דורשת לפני שאפליקציה תוכל להשתמש בה, וכן אסימון גישה של משתמש מ-Facebook Login של אדם שיכול לבצע משימות בעמוד המקושר, או אסימון מ-Unified Login. הסקירה של Meta מפרטת שחיפוש אשטאגים אינו נתמך ב-Instagram Login, והקריאות שלו כפופות למגבלות הקצב של Meta Platform ולא לתקציב הקריאות לפי חשבון של Instagram. השימושים המותרים ש-Meta מפרטת כוללים איתור תוכן מהקמפיינים של האשטאג שלכם, הבנת דעת הקהל הציבורית על המותג שלכם וזיהוי משתתפים בתחרויות.

אפשר לחפש אשטאגים דרך easyCoexistence?

easyCoexistence מחברת את Instagram באמצעות Instagram Login, שמגיע לפוסטים, לתגובות, לאזכורים ולנתונים של החשבון המחובר עצמו. Meta מציעה חיפוש אשטאגים רק עם Facebook Login ועם Unified Login, ולכן הוא מחוץ לחיבור הזה. במקום זאת החיבור מכסה את הפוסטים של החשבון דרך list_social_posts, ואת התגובות והאזכורים שלו, שמועברים לנקודת הקצה שלכם כשהם מגיעים.

טעויות נפוצות

  • בזבוז המכסה השבועית על בדיקות. כל אשטאג חדש נספר מתוך 30 האשטאגים ב-7 ימים, ושליפת המדיה שלו נספרת גם כשהמזהה שמור.
  • בקשת username בתוצאות אשטאג. Meta לא מחזירה אותו למדיה שנמצאה דרך חיפוש אשטאג.
  • קריאה ל-recent_media כאל ארכיון. הוא מכסה מדיה שפורסמה ב-24 השעות שלפני השאילתה, ולא בסדר כרונולוגי מדויק.
  • קריאה עם אסימון Instagram Login. Meta מסמנת שחיפוש אשטאגים אינו נתמך בהגדרה הזו.
עושים את זה עם EasyCoexistence

מ-US$ 9 עד US$ 0.75 לכל חיבור בחודש, ויורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

האם אפשר לחפש אשטאגים דרך Instagram API בלי App Review?

לא. Meta דורשת אישור App Review לתכונה Instagram Public Content Access וגם ל-instagram_basic לפני שאפליקציה יכולה לקרוא לחיפוש אשטאגים.

אפשר לראות מי פירסם עם אשטאג מסוים?

לא לפי שם משתמש, כי Meta מסירה אותו מתוצאות האשטאג. כל permalink של פוסט פותח אותו ב-Instagram.

האם חיפוש אשטאגים כולל Stories?

לא. Meta לא תומכת באשטאגים ב-Stories, ושני הנתיבים מחזירים רק תמונות וסרטונים ציבוריים.

האם חיפוש חוזר של אותו אשטאג נספר פעמיים?

לא. שאילתות חוזרות לאותו אשטאג בתוך 7 הימים שלו לא נספרות מתוך 30 ולא מאפסות את תקופת 7 הימים של האשטאג.

המשיכו לקרוא

Instagram Business Discovery: קריאת הפוסטים ומספר העוקבים של חשבון אחראיך Business Discovery קורא מספר עוקבים, פרופיל ופוסטים של חשבון אחר לפי שם משתמש, וההתחברות שהוא דורש.@mentions ב-Instagram דרך ה-API: איתור ומענה להםאיך מגיעים @mentions של Instagram דרך ה-API ובוובהוק (Webhook) התגובות עם Instagram Login, ואיך משיבים להם בתגובות ובכיתובים.קבלת הפוסטים של חשבון Instagram דרך ה-APIאיך ה-API של Instagram מחזיר את הפוסטים של חשבון עם GET /<IG_ID>/media: השדות, פריטי קרוסלה, דפדוף לפי סמן ותאריך, ופיד לאתר.תיוג אנשים והוספת מיקום לפוסט דרך ה-API של Instagramאיך ה-API של Instagram מתייג אנשים ב-user_tags ומוסיף מיקום ב-location_id: אילו פוסטים תומכים בכך, קואורדינטות x ו-y ואיך מוצאים מיקום.הגבלות קצב של Instagram API: קריאות בכל 24 שעות ותפוקת הודעות DMהגבלות קצב של Instagram API: 4,800 קריאות לכל חשיפה בכל 24 שעות, 100 הודעות DM בשנייה, 750 תגובות פרטיות בשעה, כותרת השימוש ושגיאה 80002.הרשאות Instagram API: היקף ההרשאה שמאחורי כל תכונהההרשאות ש-Instagram API משתמש בהן עם Instagram Login, מההרשאה instagram_business_basic ועד manage_insights, ומה כל תכונה דורשת.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-