instagram/
location-posts

Собирайте публичные публикации и ролики Reels с отметкой локации Instagram по ID или URL: подписи, авторы, лайки, комментарии, медиафайлы и метки времени в порядке top или recent.

Instagram Location Posts API

ID или URL локации
Top или recent
Медиа каруселей
0,5 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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

Выберите место и порядок сортировки, запустите задачу и прочитайте публикации.

  1. Найдите ID локации через Instagram Location Search или скопируйте ссылку на страницу локации.
  2. Отправьте location_id, sort_by со значением top или recent и results_limit методом POST на /v1/instagram/location-posts.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  4. Читайте публикации из 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, чтобы увидеть обсуждение и аудиторию за ними.

Помимо 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 с публичными данными других поддерживаемых соцсетей.

Instagram Location Posts API — FAQ

Instagram Location Posts API — это программный интерфейс для сбора публичных публикаций с отметкой локации Instagram по ее ID или URL страницы локации. Он возвращает ссылки на публикации, подписи, авторов, число лайков и комментариев, медиафайлы и время публикации в порядке top или recent.

Найдите ID локации места через Instagram Location Search API, затем отправьте его сюда с sort_by со значением top или recent.

top возвращает публикации, которые Instagram ставит выше всего для этого места, а recent — сначала самые новые публикации с отметкой и листает их, пока не будет достигнут results_limit.

До 100 при sort_by recent; по умолчанию results_limit равен 20.

Каждая возвращенная публикация стоит 0,5 кредита.