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 повторно.
- Решите, будете ли вы искать по названию места или по его координатам.
- Отправьте {"query": "Times Square"} или {"latitude": 40.758, "longitude": -73.9855} методом POST на /v1/instagram/location-search.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, и читайте results.items.
- Выберите совпадение по городу и координатам и сохраните его 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 повторно.
- Если вы точно знаете, где находится место, ищите по координатам: в результатах будут локации вокруг этой точки вместе с расстоянием до них.
Связанные API
Помимо 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 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