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 или ссылку и получите одну запись о локации.
- Получите ID локации через Instagram Location Search или скопируйте ссылку на страницу локации с instagram.com.
- Отправьте {"location_id": "384695225271379"} методом POST на /v1/instagram/location-info.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Локация — первый элемент в 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.
Связанные API
Помимо 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 Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Comments API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Account Age Checker API