Instagram Location Posts
Публикации локации — это фото и ролики Reels, которые люди отмечают местом, от кафе на углу до стадиона в день матча, и у каждой есть подпись, автор, лайки, комментарии и медиафайлы. Следя за ними, вы видите, чем люди делятся в этом месте прямо сейчас, а это помогает исследовать локальные тренды, освещать события и находить авторов, которые публикуют контент из конкретной точки.
Возможности Instagram Location Posts API
- Публикации одного местаУкажите location_id или ссылку на страницу локации и получите публичные публикации и ролики Reels, отмеченные там.
- Лучшие или новыеsort_by top возвращает публикации, которые Instagram ставит выше всего для этого места, а recent — сначала самые новые и продолжает сбор до results_limit.
- Публикация целикомКаждая публикация содержит шорткод, ссылку, подпись, автора, число лайков и комментариев, время публикации и медиа — изображения или видео, причем каждый слайд карусели указан отдельно.
- Место остается с публикациейextra.location_id и extra.location_name сохраняют привязку локации к каждой записи, что удобно, когда вы объединяете несколько мест.
Параметры Instagram Location Posts API
| Параметры | Обязательный | Описание |
|---|---|---|
location_id | Обязательный (хотя бы один) | Числовой ID места, публикации с отметкой которого нужно получить. Укажите его или url. |
url | Обязательный (хотя бы один) | Ссылка на страницу локации, например https://www.instagram.com/explore/locations/212988663/. Укажите ее или location_id. |
sort_by | Необязательный | top — публикации места с самым высоким рейтингом (по умолчанию), recent — сначала самые новые публикации. |
results_limit | Необязательный | Сколько публикаций вернуть — от 1 до 100. По умолчанию 20. |
Как использовать Instagram Location Posts API
Выберите место и порядок сортировки, запустите задачу и прочитайте публикации.
- Найдите ID локации через Instagram Location Search или скопируйте ссылку на страницу локации.
- Отправьте location_id, sort_by со значением top или recent и results_limit методом POST на /v1/instagram/location-posts.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте публикации из results.items и переходите по results.next_cursor за остальными.
curl -X POST "https://api.socq.ai/v1/instagram/location-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"location_id":"384695225271379","sort_by":"top","results_limit":20}'
# Switch sort_by to "recent" for the newest posts first.
# The posts are returned by GET /v1/tasks/{task_id}.Сценарии использования Instagram Location Posts API
- Освещение событий: Собирайте свежие публикации на стадионе, концертной площадке или фестивале во время события, чтобы получить фото, подписи и реакции.
- Поиск локальных трендов: Просматривайте свежие подписи и медиафайлы в районе или у достопримечательности, чтобы понять, о чем там говорят на этой неделе.
- Поиск локальных авторов: Используйте авторов лучших публикаций места, чтобы составить список авторов, публикующих контент из этой локации.
Практические советы по Instagram Location Posts API
- Используйте sort_by recent, когда нужен не просто быстрый снимок: этот режим листает столько публикаций, сколько позволяет results_limit.
- Запускайте сбор в режиме recent по расписанию и храните id уже просмотренных публикаций, чтобы каждый запуск добавлял только новые.
- Передавайте URL интересных публикаций в Instagram Comments или Instagram Post Likers, чтобы увидеть обсуждение и аудиторию за ними.
Связанные API
Помимо Instagram Location Posts API, используйте эти API, когда нужен другой тип публичных данных Instagram.
- Instagram Posts API — Собирайте публичные публикации, медиа, хештеги, упоминания, метки времени и вовлеченность по имени пользователя.
- Instagram Reels API — Собирайте публичные Reels, медиа, аудио, хештеги, упоминания и вовлеченность по имени пользователя.
- Instagram Comments API — Собирайте публичные комментарии, авторов, метки времени, лайки и ответы по URL публикаций.
- Instagram Post Info API — Получайте данные по известным URL публичных публикаций, Reels или старых IGTV: подписи, данные автора, медиа, метки времени, видимая вовлеченность и контекст входных данных.
- Instagram Post Likers API — Получайте аккаунты из видимого списка лайкнувших публикацию по ее URL: имена пользователей, имена, аватары и статус верификации.
- Instagram Location Info API — Получайте данные об одном месте по ID или URL страницы места: название, категория, телефон, координаты и число публикаций с отметкой.
- Instagram Followers Count API
- Instagram Search API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API