این اندپوینت امکان دریافت پست‌ها یا محتواهای مرتبط با یک لوکیشن خاص در اینستاگرام را بر اساس شناسهٔ مکانی (Location ID) فراهم می‌کند. با این اندپوینت می‌توانید پست‌هایی که در آن‌ها لوکیشن مشخص شده است را ببینید؛ این برای بررسی محتوای تولید شده در یک منطقه، مکان توریستی، کسب‌وکار محلی یا رویداد مفید است.
پارامتر ورودی:
id(الزامی): شناسه عددی لوکیشن (Location ID) برای مکان مورد نظر.page(اختیاری): عدد صفحه برای صفحه‌بندی نتایج.tab(اختیاری): دو مقدار recent و ranked که به ترتیب محتوای اخیر و برتر را نمایش میدهد.max_id(اختیاری): شناسه‌ای (string) که برای ادامهٔ صفحه‌بندی (pagination) استفاده می‌شود؛ به شما امکان میدهد از نقطه‌ای خاص ادامه دهید.
خروجی: پاسخ JSON شامل لیستی از رسانه‌ها (Media) مرتبط با لوکیشن است. هر عنصر در این لیست ممکن است شامل فیلدهای زیر باشد:
- id: شناسهٔ مدیا
- shortcode: کد کوتاه مدیا (در اینستاگرام)
- type: نوع محتوا (عکس، ویدیو یا آلبوم)
- media_link: لینک مستقیم مدیا
- thumbnail_link: لینک تصویر کوچک یا پیش‌نمایش
- caption: متن توضیحی (کپشن) در صورت وجود
- timestamp: زمان انتشار محتوا
| Name | Type | Default | Description |
|---|---|---|---|
| id (required) | int | – | Location id |
| tab | string | recent |
Tab (allowed values: recent or ranked) |
| page | int | None |
Use for pagination |
| max_id | string | None |
Use for pagination |