Instagram Location Search
Instagram은 자체 장소 카탈로그를 운영하며, 게시물에 붙은 모든 위치 태그는 이 카탈로그의 항목 하나를 ID로 가리킵니다. 이름이나 지도상의 한 지점으로 카탈로그를 검색하면 매장, 거리, 좌표가 Instagram 위치 페이지와 태그된 게시물에 쓰이는 ID로 바뀝니다.
Instagram Location Search API 주요 기능
- 이름으로 검색query에 장소 이름, 랜드마크, 도시를 입력하면 일치하는 위치를 ID와 함께 반환합니다.
- 특정 지점 주변 검색위도와 경도를 보내면 그 지점 주변의 위치를 목록으로 반환하며, 각 항목의 거리 표시는 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}를 /v1/instagram/location-search로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 뒤 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로 변환: 스프레드시트에 담긴 매장·호텔·행사장 이름을 게시물과 상세 정보 조회에 필요한 Instagram 위치 ID로 변환합니다.
- 동네 단위 위치 파악: 캠퍼스, 쇼핑몰, 행사장의 좌표 주변을 검색해 가까운 Instagram 위치를 목록으로 확인합니다.
- 중복 장소 정리: 이름과 좌표를 비교해 같은 실제 장소를 가리키는 여러 Instagram 위치를 찾아내고, 각각에서 게시물을 수집합니다.
Instagram Location Search API 활용 팁
- 흔한 장소 이름은 query에 도시를 함께 넣으세요. 예: 'Central Park New York'.
- ID를 재사용하기 전에 도시와 좌표로 올바른 결과인지 확인하세요.
- 장소의 정확한 위치를 알고 있다면 좌표로 검색하세요. 결과에는 해당 지점 주변의 위치가 거리 정보와 함께 나열됩니다.
관련 API
Instagram Location Search API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Instagram Search API — 키워드 또는 핸들로 공개 프로필을 검색하며, 계정 정보와 공개된 계정 신호를 포함합니다.
- Instagram Hashtag Posts API — 해시태그로 공개 게시물을 찾으며, 출처 태그 맥락, 미디어, 크리에이터, 타임스탬프, 공개된 참여도를 포함합니다.
- Instagram Reels Search API — 텍스트 검색어로 공개 릴스를 검색하며, 캡션, 크리에이터, 미디어, 타임스탬프, 공개된 참여도, 검색어 맥락을 포함합니다.
- 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