instagram/
location-posts

ID 또는 URL로 Instagram 위치에 태그된 공개 게시물과 릴스를 수집하여, 캡션, 작성자, 좋아요, 댓글, 미디어, 타임스탬프를 인기순 또는 최신순으로 반환합니다.

Instagram Location Posts API

위치 ID 또는 URL
인기순 또는 최신순
캐러셀 미디어
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용 방법

장소와 정렬 순서를 정해 작업을 실행한 뒤, 게시물을 읽습니다.

  1. Instagram Location Search에서 위치 ID를 찾거나, 위치 페이지 링크를 복사합니다.
  2. location_id, top 또는 recent인 sort_by, results_limit을 /v1/instagram/location-posts로 POST합니다.
  3. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  4. 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에 넘겨 그 뒤의 대화와 오디언스를 확인하세요.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Instagram Location Posts API — 자주 묻는 질문

Instagram Location Posts API는 위치 ID 또는 위치 페이지 URL을 입력으로 받아 Instagram 위치에 태그된 공개 게시물을 수집하는 프로그래밍 인터페이스입니다. 게시물 링크, 캡션, 작성자, 좋아요·댓글 수, 미디어, 게시 시각을 인기순 또는 최신순으로 반환합니다.

Instagram Location Search API로 장소의 위치 ID를 찾은 다음, sort_by를 top 또는 recent로 설정해 이 엔드포인트에 보내세요.

top은 Instagram이 해당 장소에서 가장 높게 평가한 게시물을 반환하고, recent는 태그된 가장 최신 게시물부터 results_limit에 이를 때까지 계속 반환합니다.

sort_by가 recent이면 최대 100개이며, results_limit의 기본값은 20입니다.

반환된 게시물 1개당 0.5 크레딧이 차감됩니다.