Instagram Location Posts
위치 게시물은 동네 카페부터 경기가 열리는 날의 경기장까지, 사람들이 장소를 태그해 올린 사진과 릴스로 각각 캡션, 작성자, 좋아요, 댓글, 미디어를 갖추고 있습니다. 이를 따라가 보면 사람들이 그 장소에서 지금 공유하는 모습을 볼 수 있어 지역 트렌드 조사, 행사 취재, 특정 장소에서 게시하는 크리에이터 찾기에 도움이 됩니다.
Instagram Location Posts API 주요 기능
- 장소 하나의 게시물location_id 또는 위치 페이지 링크를 지정하면 그곳에 태그된 공개 게시물과 릴스를 가져옵니다.
- 인기순 또는 최신순sort_by가 top이면 Instagram이 해당 장소에서 가장 높게 평가한 게시물을, recent이면 가장 최신 게시물부터 results_limit에 이를 때까지 계속 반환합니다.
- 게시물 전체 정보각 게시물에는 숏코드, 링크, 캡션, 작성자, 좋아요·댓글 수, 게시 시각, 이미지 또는 동영상 미디어가 포함되며, 캐러셀의 모든 슬라이드가 나열됩니다.
- 게시물과 함께 이동하는 장소 정보extra.location_id와 extra.location_name이 레코드마다 위치를 함께 유지하므로, 여러 장소를 합쳐 다룰 때 유용합니다.
Instagram Location Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
location_id | 필수(하나 이상) | 태그된 게시물을 가져오려는 장소의 숫자형 ID입니다. 이 값 또는 url 중 하나를 사용하세요. |
url | 필수(하나 이상) | 위치 페이지 링크이며, 예를 들어 https://www.instagram.com/explore/locations/212988663/ 형식입니다. 이 값 또는 location_id 중 하나를 사용하세요. |
sort_by | 선택 | top은 해당 장소에서 가장 높게 평가된 게시물(기본값), recent는 가장 최신 게시물부터입니다. |
results_limit | 선택 | 반환할 게시물 수로, 1~100 사이입니다. 기본값은 20입니다. |
Instagram Location Posts API 사용 방법
장소와 정렬 순서를 정해 작업을 실행한 뒤, 게시물을 읽습니다.
- Instagram Location Search에서 위치 ID를 찾거나, 위치 페이지 링크를 복사합니다.
- location_id, top 또는 recent인 sort_by, results_limit을 /v1/instagram/location-posts로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- results.items에서 게시물을 읽고, 나머지는 results.next_cursor를 따라가 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/location-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"location_id":"384695225271379","sort_by":"top","results_limit":20}'
# Switch sort_by to "recent" for the newest posts first.
# The posts are returned by GET /v1/tasks/{task_id}.Instagram Location Posts API 추천 활용 사례
- 행사 취재: 경기장, 공연장, 축제 현장에서 행사가 진행되는 동안 최근 게시물을 모아 사진, 캡션, 반응을 수집합니다.
- 지역 트렌드 포착: 동네나 랜드마크의 최근 캡션과 미디어를 살펴 이번 주 사람들이 그곳에서 무엇을 이야기하는지 파악합니다.
- 지역 크리에이터 찾기: 한 장소의 인기 게시물 작성자를 활용해 그 위치에서 콘텐츠를 올리는 크리에이터 목록을 만듭니다.
Instagram Location Posts API 활용 팁
- 간단한 스냅샷보다 많은 양이 필요하면 sort_by를 recent로 사용하세요. results_limit이 허용하는 만큼의 게시물을 계속 넘겨 가며 가져옵니다.
- recent 실행을 예약하고 이미 확인한 게시물 id를 보관해 두면, 매 실행마다 새 게시물만 추가됩니다.
- 눈에 띄는 게시물 URL은 Instagram Comments나 Instagram Post Likers에 넘겨 그 뒤의 대화와 오디언스를 확인하세요.
관련 API
Instagram Location Posts API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
- Instagram Reels API — 사용자 이름으로 공개 릴스, 미디어, 오디오, 해시태그, 멘션, 참여도를 수집합니다.
- Instagram Comments API — 게시물 URL에서 공개 댓글, 작성자, 타임스탬프, 좋아요, 답글을 수집합니다.
- Instagram Post Info API — 알고 있는 공개 게시물, 릴스, 레거시 IGTV URL을 조회하며, 캡션, 작성자 정보, 미디어, 타임스탬프, 공개된 참여도, 입력 맥락을 포함합니다.
- Instagram Post Likers API — 게시물 URL에서 공개된 좋아요 목록의 계정을 가져오며, 사용자 이름, 이름, 프로필 이미지, 인증 상태를 포함합니다.
- Instagram Location Info API — ID 또는 위치 페이지 URL로 위치 하나를 조회하며, 이름, 카테고리, 전화번호, 좌표, 태그된 게시물 수를 포함합니다.
- Instagram Followers Count API
- Instagram Search API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API