Instagram Reels Search
Instagram 릴스는 캡션, 크리에이터 정보, 미디어, 게시 시각, 원본 상품 유형, 공개된 참여 수치를 갖춘 공개 숏폼 동영상입니다. 이러한 콘텐츠·성과 신호는 주제 모니터링, 검색어별 리서치, 크리에이터 매핑, 비교 분석에 활용할 수 있습니다.
Instagram Reels Search API 주요 기능
- 텍스트 검색어로 릴스 탐색알고 있는 프로필, 해시태그, 오디오 ID, 콘텐츠 URL 없이도 의미 있는 검색어 하나로 공개 릴스를 찾습니다.
- 게시 기간 지정최신성 범위가 필요하면 최근 1시간, 1일, 1주, 1개월, 1년 중 하나로 탐색 범위를 제한합니다.
- 콘텐츠·크리에이터 레코드릴스 식별 정보, 정식 URL, 캡션, 작성자 정보, 미디어 참조, 게시 시각, 공개된 참여 수치를 하나의 형식으로 받습니다.
- 수집 범위 제한과 중복 제거작업마다 20~2,000건으로 수집량을 정하며, 고유한 릴스 식별자로 중복을 제거하고 저장된 항목마다 검색에 사용한 검색어를 유지합니다.
Instagram Reels Search API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | 현재 공개 Instagram 릴스를 검색하는 데 사용하는 필수 텍스트로, 비어 있으면 안 됩니다. |
results_limit | 선택 | 검색어 하나에 대해 요청하는 최대 레코드 수입니다. 기본값은 100이며 20~2,000 사이의 정수를 받습니다. |
published_within | 선택 | 선택 값인 게시 기간으로, hour, day, week, month, year 중 하나입니다. |
Instagram Reels Search API 사용 방법
릴스 검색을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 레코드를 커서 페이지네이션으로 읽습니다.
- 비어 있지 않은 텍스트 검색어를 준비하고 필요하면 게시 기간을 고릅니다. results_limit는 20~2,000으로 설정합니다.
- query와 선택 필드인 results_limit, published_within을 /v1/instagram/reels-search로 POST합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /v1/tasks/{task_id}?limit=50에서 data.results.items를 읽고, results.has_more가 true인 동안 results.next_cursor를 따라가며 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/reels-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"query\":\"$INSTAGRAM_REELS_QUERY\",\"results_limit\":20,\"published_within\":\"week\"}"
# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.Instagram Reels Search API 추천 활용 사례
- 검색어별 릴스 데이터셋: 릴스 ID, URL, 캡션, 미디어, 작성자, extra.search_query를 묶어 하나의 주제에 대한 추적 가능한 컬렉션을 만듭니다.
- 최근 주제 모니터링: 게시 기간 설정과 created_at, 공개된 참여 수치를 활용해 정기적으로 확인하는 검색어에 최근 노출된 릴스를 검토합니다.
- 주제 내 크리에이터 발굴: 정규화된 작성자 ID, 사용자 이름, 이름, 프로필 이미지로 검색어에 해당하는 릴스에 등장한 크리에이터를 파악합니다.
- 콘텐츠 포맷 비교: 같은 검색어로 반환된 릴스의 캡션, 미디어 메타데이터, 원본 상품 유형, 공개된 지표를 비교합니다.
Instagram Reels Search API 활용 팁
- 입력값의 공백을 제거한 뒤에도 의미 있는 검색어가 남도록, 공백이 아닌 문자로 이루어진 구체적인 검색어를 사용하세요.
- 현재 공개 검색 결과는 달라질 수 있으므로, 반복 실행한 결과를 비교할 때는 query, published_within, results_limit 값을 동일하게 유지하세요.
- 결과 페이지나 여러 작업을 결합할 때는 extra.search_query와 고유 릴스 ID를 보관해, 검색어 출처와 중복 제거 기준을 명확하게 유지하세요.
- 후속 코드에서는 캡션, 크리에이터 필드, 미디어, 시각, 상품 유형, 공개된 수치를 null일 수 있는 값으로 처리하세요.
관련 API
Instagram Reels Search API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Instagram Search API — 키워드 또는 핸들로 공개 프로필을 검색하며, 계정 정보와 공개된 계정 신호를 포함합니다.
- Instagram Comments API — 게시물 URL에서 공개 댓글, 작성자, 타임스탬프, 좋아요, 답글을 수집합니다.
- Instagram Hashtag Posts API — 해시태그로 공개 게시물을 찾으며, 출처 태그 맥락, 미디어, 크리에이터, 타임스탬프, 공개된 참여도를 포함합니다.
- Instagram Transcript API — 공개 게시물 또는 릴스 URL에서 스크립트 텍스트, 언어, 형식, 출처 URL, 숏코드를 추출합니다.
- Instagram Post Info API — 알고 있는 공개 게시물, 릴스, 레거시 IGTV URL을 조회하며, 캡션, 작성자 정보, 미디어, 타임스탬프, 공개된 참여도, 입력 맥락을 포함합니다.
- Instagram Location Info API — ID 또는 위치 페이지 URL로 위치 하나를 조회하며, 이름, 카테고리, 전화번호, 좌표, 태그된 게시물 수를 포함합니다.
- Instagram Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Audio Reels API
- Instagram Highlight Items 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