instagram/
location-info

Находите локацию Instagram по ID или URL страницы локации и получайте ее название, категорию, телефон, город, координаты и число публикаций с отметкой этого места.

Instagram Location Info API

ID или URL локации
Сведения о месте
Число публикаций с отметкой
0,5 кредита за запрос
Готово
Готово

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

README

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

Instagram Location Info

У каждого места, которое отмечают в Instagram, есть своя страница локации с названием, категорией, адресом, городом, номером телефона, координатами на карте и постоянно растущим числом публикаций с отметкой. Эти сведения превращают голый ID локации в то, что можно нанести на карту, сравнить с соседними заведениями или добавить к собственным записям.

Возможности Instagram Location Info API

  • ID или ссылка на страницуИспользуйте числовой location_id или вставьте ссылку instagram.com/explore/locations/ — ID будет извлечен из нее.
  • Место в одной записиЗапись содержит название локации, категорию, телефон, адрес, город, широту и долготу, а также URL ее страницы.
  • Насколько место популярноextra.media_count показывает, сколько публикаций отмечено в локации, а в extra также есть статус часов работы и почтовый индекс.

Параметры Instagram Location Info API

ПараметрыОбязательныйОписание
location_idОбязательный (хотя бы один)Числовой ID локации, который возвращает Instagram Location Search. Укажите его или url.
urlОбязательный (хотя бы один)Ссылка на страницу локации, например https://www.instagram.com/explore/locations/212988663/. Укажите ее или location_id.

Как использовать Instagram Location Info API

Найдите локацию, отправьте ее ID или ссылку и получите одну запись о локации.

  1. Получите ID локации через Instagram Location Search или скопируйте ссылку на страницу локации с instagram.com.
  2. Отправьте {"location_id": "384695225271379"} методом POST на /v1/instagram/location-info.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  4. Локация — первый элемент в results.items.
curl -X POST "https://api.socq.ai/v1/instagram/location-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location_id":"384695225271379"}'

# Or send {"url": "https://www.instagram.com/explore/locations/384695225271379/"}.
# The location record is returned by GET /v1/tasks/{task_id}.

Сценарии использования Instagram Location Info API

  • Обогащение базы заведений: Добавляйте категорию, телефон, адрес и координаты к ID локаций, собранным из публикаций с отметками.
  • Сравнение популярности заведений: Сопоставляйте media_count конкурирующих ресторанов, отелей или достопримечательностей, чтобы понять, где люди публикуют больше всего.
  • Карта отмеченных мест: Наносите локации на карту по широте и долготе, чтобы увидеть, где в городе концентрируется активность.

Практические советы по Instagram Location Info API

  • Начните с Instagram Location Search, если у вас есть только название места или пара координат.
  • Для городов, районов и достопримечательностей определяйте положение локации по широте и долготе: телефон и адрес заполняются в основном у компаний.
  • Передайте тот же location_id в Instagram Location Posts, чтобы прочитать публикации, стоящие за media_count.

Помимо Instagram Location Info API, используйте эти API, когда нужен другой тип публичных данных Instagram.

  • Instagram Search API — Ищите публичные профили по ключевому слову или имени пользователя: данные аккаунта и видимые признаки.
  • Instagram Hashtag Posts API — Находите публичные публикации по хештегу: контекст исходного тега, медиа, авторы, метки времени и видимая вовлеченность.
  • Instagram Reels Search API — Ищите публичные Reels по текстовому запросу: подписи, авторы, медиа, метки времени, видимая вовлеченность и контекст запроса.
  • Instagram Location Posts API — Собирайте топовые или самые свежие публичные публикации с отметкой места: подписи, авторы, вовлеченность и медиа.
  • Instagram Location Search API — Находите ID мест по названию или по широте и долготе: названия, адреса, города и координаты.
  • Instagram Hashtag Search API — Находите хештеги по ключевому слову: названия, ID, URL страниц хештегов и число публичных публикаций.

Другие платформы

Объединяйте данные Instagram с публичными данными других поддерживаемых соцсетей.

Instagram Location Info API — FAQ

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

Запустите Instagram Location Search API с названием места или координатами либо скопируйте число после /explore/locations/ в URL страницы локации.

Да. В extra.media_count хранится число публикаций с отметкой этой локации.

Каждый запрос стоит 0,5 кредита.