instagram/
location-search

장소 이름 또는 위도·경도로 Instagram 위치를 검색하고, 후속 조회에 쓸 위치 ID와 이름, 주소, 도시, 좌표를 반환합니다.

Instagram Location Search API

이름 또는 좌표
위치 ID
주변 장소
요청당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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를 재사용합니다.

  1. 장소 이름으로 검색할지, 좌표로 검색할지 정합니다.
  2. {"query": "Times Square"} 또는 {"latitude": 40.758, "longitude": -73.9855}를 /v1/instagram/location-search로 POST합니다.
  3. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 뒤 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로 변환: 스프레드시트에 담긴 매장·호텔·행사장 이름을 게시물과 상세 정보 조회에 필요한 Instagram 위치 ID로 변환합니다.
  • 동네 단위 위치 파악: 캠퍼스, 쇼핑몰, 행사장의 좌표 주변을 검색해 가까운 Instagram 위치를 목록으로 확인합니다.
  • 중복 장소 정리: 이름과 좌표를 비교해 같은 실제 장소를 가리키는 여러 Instagram 위치를 찾아내고, 각각에서 게시물을 수집합니다.

Instagram Location Search API 활용 팁

  • 흔한 장소 이름은 query에 도시를 함께 넣으세요. 예: 'Central Park New York'.
  • ID를 재사용하기 전에 도시와 좌표로 올바른 결과인지 확인하세요.
  • 장소의 정확한 위치를 알고 있다면 좌표로 검색하세요. 결과에는 해당 지점 주변의 위치가 거리 정보와 함께 나열됩니다.

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

Instagram Location Search API — 자주 묻는 질문

Instagram Location Search API는 장소 이름이나 위도·경도로 Instagram 위치를 찾는 프로그래밍 인터페이스입니다. 위치 ID와 함께 이름, 위치 페이지 URL, 주소, 도시, 좌표를 반환합니다.

장소를 이름이나 좌표로 검색하면 됩니다. 각 결과의 id 필드가 Instagram 위치 페이지에 쓰이는 위치 ID입니다.

네. 위도와 경도를 함께 보내면 해당 지점 주변의 위치를 작업 결과로 반환합니다.

검색 1회당 0.5 크레딧이 차감되며, 반환되는 위치 수와는 관계없습니다.