instagram/
location-search

Ищите локации Instagram по названию места или по широте и долготе и получайте ID локаций с названиями, адресами, городами и координатами для последующих запросов.

Instagram Location Search API

Название или координаты
ID локаций
Места поблизости
0,5 кредита за запрос
Готово
Готово

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

README

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

Instagram Location Search

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

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

  • Поиск по названиюВведите в query название места, достопримечательности или города и получите подходящие локации с их ID.
  • Поиск вокруг точкиПередайте latitude и longitude, чтобы получить список локаций вокруг этой точки, у каждой — метка расстояния в extra.distance.
  • Готово для следующего шагаКаждое совпадение содержит ID локации, URL страницы, название, адрес, город, широту и долготу, поэтому его можно сразу передать в запрос сведений или публикаций.

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

ПараметрыОбязательныйОписание
queryОбязательный (хотя бы один)Название места, достопримечательности или города, до 100 символов. Укажите его или latitude и longitude.
latitudeОбязательный (хотя бы один)Широта точки, вокруг которой ведется поиск, от -90 до 90. Передавайте вместе с longitude.
longitudeОбязательный (хотя бы один)Долгота точки, вокруг которой ведется поиск, от -180 до 180. Передавайте вместе с latitude.

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

Ищите по названию или координатам, выберите нужное совпадение и используйте его ID повторно.

  1. Решите, будете ли вы искать по названию места или по его координатам.
  2. Отправьте {"query": "Times Square"} или {"latitude": 40.758, "longitude": -73.9855} методом POST на /v1/instagram/location-search.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, и читайте results.items.
  4. Выберите совпадение по городу и координатам и сохраните его id для Instagram Location Info или Instagram Location Posts.
curl -X POST "https://api.socq.ai/v1/instagram/location-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Times Square"}'

# To search around a point instead: -d '{"latitude":40.758,"longitude":-73.9855}'
# Matching locations are returned by GET /v1/tasks/{task_id}.

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

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

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

  • Добавляйте город в query, если название места распространенное, например «Central Park New York».
  • Проверяйте нужный результат по городу и координатам, прежде чем использовать его ID повторно.
  • Если вы точно знаете, где находится место, ищите по координатам: в результатах будут локации вокруг этой точки вместе с расстоянием до них.

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

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

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

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

Instagram Location Search API — FAQ

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

Найдите место по названию или координатам; поле id каждого результата — это ID локации, который Instagram использует для своих страниц локаций.

Да. Передайте latitude и longitude вместе, и задача вернет локации вокруг этой точки.

Каждый поиск стоит 0,5 кредита независимо от числа найденных локаций.