مستندات BoxAPI
API جامع، کامل و ساده

Hashtag Get Media

این اندپوینت امکان دریافت پست‌های مرتبط با یک هشتگ مشخص در اینستاگرام را فراهم می‌کند. با استفاده از آن می‌توانید پست‌های اخیر که توسط کاربران با آن هشتگ منتشر شده‌اند را دریافت کرده و تحلیل محتوا، روندها یا محبوبیت هشتگ را بررسی کنید.

پارامتر ورودی:

  • name (الزامی): نام هشتگ مورد نظر بدون علامت # (مثلاً cats).
  • tab (اختیاری): نوع پست‌ها برای دریافت. مقادیر ممکن:
    • recent (پیش‌فرض): پست‌های جدید.
    • top: پست‌های برتر.
    • clips: ویدیوهای کوتاه (ریلز).
  • page (اختیاری): شماره صفحه برای صفحه‌بندی نتایج.
  • max_id (اختیاری): شناسه حداکثر برای صفحه‌بندی نتایج.

خروجی: پاسخ JSON که شامل اطلاعات زیر است:

  • count: تعداد کل پست‌های مرتبط با هشتگ.
  • data: آرایه‌ای از پست‌ها که شامل موارد زیر است:
    • id: شناسه پست.
    • shortcode: کد کوتاه پست برای لینک‌دهی مستقیم.
    • type: نوع محتوا (عکس، ویدیو یا آلبوم).
    • media_link: لینک مستقیم به محتوا (عکس یا ویدیو).
    • thumbnail_link: لینک پیش‌نمایش محتوا (در صورت وجود).
    • caption: کپشن یا توضیح پست در صورت موجود بودن آن.
    • like_count: تعداد لایک‌ها.
    • comment_count: تعداد کامنت‌ها.
    • timestamp: زمان انتشار پست.
Name Type Default Description
name (required) string Hashtag name
tab string recent Tab (allowed values: recent or clips)
page int None Use for pagination
max_id string None Use for pagination

 

curl --request POST \
--url https://boxapi.ir/api/instagram/hashtag/get_media \
--user 'boxapi_username:boxapi_password' \
--data '{
        "name": "catsofinstagram"
    }'