instagram/
reels-search

텍스트 검색어로 공개 Instagram 릴스를 검색하고, 캡션, 크리에이터, 미디어, 게시 시각, 공개된 참여 수치, 검색어 정보를 정규화된 레코드로 반환합니다.

Instagram Reels Search API

텍스트 검색어 기반 탐색
릴스 레코드
게시 기간 지정
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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를 폴링한 뒤, 정규화된 레코드를 커서 페이지네이션으로 읽습니다.

  1. 비어 있지 않은 텍스트 검색어를 준비하고 필요하면 게시 기간을 고릅니다. results_limit는 20~2,000으로 설정합니다.
  2. query와 선택 필드인 results_limit, published_within을 /v1/instagram/reels-search로 POST합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /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일 수 있는 값으로 처리하세요.

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

Instagram Reels Search API — 자주 묻는 질문

Instagram Reels Search API는 제출한 텍스트 검색어로 공개 Instagram 릴스를 찾는 프로그래밍 인터페이스입니다. 정규화된 릴스 식별 정보, 캡션, 크리에이터, 미디어, 게시 시각, 공개된 참여 수치, 검색어 정보를 반환합니다.

query는 필수이며 공백이 아닌 텍스트가 포함되어야 합니다. results_limit는 20~2,000을 받고 기본값은 100이며, published_within은 hour, day, week, month, year 중 하나를 받습니다.

결과에는 릴스 ID와 URL, 캡션, 작성자 정보, 좋아요·댓글·조회·재생 수, 미디어 참조, created_at, collected_at, extra.search_query, 원본 상품 유형이 포함될 수 있습니다.

results_limit는 보장 값이 아니라 최대치입니다. 실행할 때마다 확인 가능한 공개 검색 결과가 달라질 수 있고, 같은 고유 식별자를 가진 중복 릴스는 한 작업 안에서 제거됩니다.

저장된 정규화 결과 1건당 0.5 크레딧이 차감되며, 작업 자체에 대한 기본 요금은 없습니다. 초기 예상 금액은 results_limit 또는 기본값 100을 기준으로 계산하고, 최종 사용량은 실제로 저장된 레코드 수에 따라 정해집니다. 저장된 레코드가 없는 작업에는 결과 요금이 부과되지 않습니다.