Instagram Search
Instagram 검색 결과는 이름, 키워드, 주제와 일치하는 공개 프로필이며, 사용자 이름, 소개글, 프로필 이미지, 인증 여부, 비공개 여부, 공개된 계정 신호를 담고 있습니다. 이러한 레코드는 크리에이터 발굴, 브랜드 리서치, 오디언스 선별, 프로필 정보 보강에 활용할 수 있습니다.
Instagram Search API 주요 기능
- 키워드 프로필 검색키워드, 핸들, 이름, 계정 관련 문구로 공개 Instagram 프로필을 검색합니다.
- 계정 정보와 수치프로필 결과마다 사용자 이름, 표시 이름, 소개글, 프로필 URL, 프로필 이미지, 인증 여부, 비공개 여부, 공개된 수치 필드를 반환합니다.
- 일관된 프로필 스키마넓은 키워드, 이름, 정확한 핸들 검색 어디서나 같은 정규화된 프로필 형식으로 반환합니다.
- 요청 결과 수 상한results_limit로 검색 한 번에 요청할 프로필 레코드 수의 상한을 지정합니다.
- 공개 데이터 범위 준수비공개·제한·삭제 상태이거나 로그인이 필요한 프로필 데이터는 응답 범위에서 제외합니다.
Instagram Search API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | 검색할 키워드, 핸들 또는 프로필 문구입니다. |
results_limit | 선택 | 수집 작업이 요청할 최대 레코드 수입니다. 양의 정수여야 합니다. |
Instagram Search API 사용 방법
프로필 검색어를 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 프로필 결과를 커서 페이지네이션으로 읽습니다.
- 비어 있지 않은 프로필 키워드, 핸들 또는 검색 문구를 준비합니다.
- query와 선택 값인 results_limit를 /v1/instagram/search로 POST합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /v1/tasks/{task_id}?limit=50을 읽고, 프로필이 더 있으면 results.next_cursor를 따라가며 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"sustainable travel","results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Instagram Search API 추천 활용 사례
- 크리에이터 발굴: 상세 정보를 보강하기 전에 키워드, 핸들, 카테고리, 캠페인 문구와 관련된 공개 프로필을 찾습니다.
- 계정 정보 보강: 선택한 검색 결과의 공개 프로필 식별 정보, 소개글, 인증 여부, 비공개 여부, 공개된 수치 필드를 확인합니다.
- 브랜드 발굴: 이름, 상품 카테고리, 시장 관련 문구와 연결된 공개 브랜드·기관 프로필을 찾습니다.
- 리서치 디렉터리 구축: 리서치, 아웃리치 대상 선별, 내부 분석에 쓸 공개 Instagram 프로필 목록을 검토 가능한 형태로 만듭니다.
- 프로필 선별 워크플로: 관련 있는 프로필을 고른 뒤, 게시물·릴스·팔로워 수 API를 호출해 더 자세한 공개 레코드를 가져옵니다.
Instagram Search API 활용 팁
- 검색 워크플로에서 429 응답은 정상적인 부하 신호로 보고, 공격적으로 재시도하지 말고 백오프와 더 작은 결과 범위를 사용하세요.
- 검색을 다시 실행하고 감사할 수 있도록 작업 ID, 고유 프로필 ID, 사용자 이름, 정식 URL을 저장하세요.
- 검색 결과는 프로필 탐색에 쓰고, 더 자세한 레코드가 필요하면 게시물·릴스·팔로워 수 API를 호출하세요.
- 공개된 API 문서에서 명시적으로 지원하지 않는 한, 비공개·로그인 필요·계정 소유자 전용 데이터는 연동 전제에서 제외하세요.
- 사용자가 입력한 검색어는 운영 파이프라인으로 보내기 전에 반드시 정제하세요.
관련 API
Instagram Search API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
- Instagram Reels API — 사용자 이름으로 공개 릴스, 미디어, 오디오, 해시태그, 멘션, 참여도를 수집합니다.
- Instagram Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 링크, 계정 속성, 카테고리, 공개된 수치를 가져옵니다.
- Instagram Hashtag Posts API — 해시태그로 공개 게시물을 찾으며, 출처 태그 맥락, 미디어, 크리에이터, 타임스탬프, 공개된 참여도를 포함합니다.
- Instagram Reels Search API — 텍스트 검색어로 공개 릴스를 검색하며, 캡션, 크리에이터, 미디어, 타임스탬프, 공개된 참여도, 검색어 맥락을 포함합니다.
- Instagram Location Info API — ID 또는 위치 페이지 URL로 위치 하나를 조회하며, 이름, 카테고리, 전화번호, 좌표, 태그된 게시물 수를 포함합니다.
- Instagram Followers Count API
- Instagram Comments 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 Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API