این اندپوینت امکان دریافت پستهای مرتبط با یک هشتگ مشخص در اینستاگرام را فراهم میکند. با استفاده از آن میتوانید پستهای اخیر که توسط کاربران با آن هشتگ منتشر شدهاند را دریافت کرده و تحلیل محتوا، روندها یا محبوبیت هشتگ را بررسی کنید.
پارامتر ورودی:
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 |