instagram/
reels

하나 이상의 사용자 이름으로 공개 Instagram 릴스를 수집하고, 정규화된 캡션, 미디어, 길이, 오디오, 해시태그, 멘션, 공개된 참여 수치를 반환합니다.

Instagram Reels API

릴스
공개 데이터
미디어 메타데이터
결과당 0.52 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Instagram Reels

Instagram 릴스는 캡션, 크리에이터 정보, 미디어, 오디오, 길이, 해시태그, 멘션, 재생수, 공개된 참여 수치를 담은 숏폼 동영상 게시물입니다. 이러한 크리에이티브·성과 신호는 포맷 리서치, 크리에이터 비교, 캠페인 검토, 트렌드 분석에 활용할 수 있습니다.

Instagram Reels API 주요 기능

  • 프로필별 릴스 수집하나 이상의 Instagram 사용자 이름에 대한 공개 릴스를 하나의 정규화된 응답 형식으로 수집합니다.
  • 콘텐츠·미디어·참여 필드캡션, 게시 시각, 재생수, 좋아요, 댓글, 공유, 길이, 썸네일, 동영상 참조, 해시태그, 멘션, 오디오 메타데이터를 반환합니다.
  • 요청 결과 수 상한results_limit로 요청마다 요청할 릴스 수의 상한을 지정합니다.
  • 공개 데이터 범위 준수비공개·제한·삭제 상태이거나 로그인이 필요한 릴스는 결과 범위에서 제외합니다.

Instagram Reels API 매개변수

매개변수필수설명
usernames필수@를 뺀 공개 Instagram 사용자 이름으로, 쉼표 또는 줄바꿈으로 구분합니다.
results_limit선택수집 작업이 요청할 최대 레코드 수입니다. 양의 정수여야 합니다.

Instagram Reels API 사용 방법

공개 사용자 이름을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 릴스 레코드를 커서 페이지네이션으로 읽습니다.

  1. @를 뺀 공개 Instagram 사용자 이름을 하나 이상 준비합니다.
  2. usernames와 선택 값인 results_limit를 /v1/instagram/reels로 POST합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50을 읽고, 레코드가 더 있으면 results.next_cursor를 따라가며 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Instagram Reels API 추천 활용 사례

  • 릴스 성과 리서치: 공개된 재생수, 좋아요, 댓글, 공유, 캡션, 게시 시각을 수집해 숏폼 동영상 성과를 비교합니다.
  • 크리에이터 발굴: 관련 프로필의 공개 릴스를 검토한 뒤, 선택한 크리에이터를 프로필 API나 게시물 타임라인 API로 보강합니다.
  • 캠페인 모니터링: 신제품 출시, 해시태그, 음악 트렌드, 크리에이터 브리프, 반복되는 콘텐츠 포맷과 관련된 공개 릴스를 추적합니다.
  • 미디어 아카이브 워크플로: 공개 릴스 메타데이터, 썸네일, 원본 URL, 길이, 오디오 정보, 수집 시각을 검토·리포팅 시스템에 저장합니다.
  • 오디오 분석: 공개된 오디오 필드가 있으면 활용해 주제 클러스터링, 모더레이션 검토, 크리에이티브 분석에 사용합니다.

Instagram Reels API 활용 팁

  • 수집 작업을 재시도하고 감사할 수 있도록 고유 릴스 ID, 숏코드, URL, 작업 ID를 저장하세요.
  • 공개 프로필의 릴스 목록을 대량으로 수집할 때는 results_limit를 보수적으로 설정하고 백오프 로직을 적용하세요.
  • 소스 상황에 따라 일부 공개 릴스에는 수치, 동영상 참조, 오디오 정보가 없을 수 있다고 가정하세요.
  • 프로필 탐색에는 Search API를, 선택한 사용자 이름의 공개 릴스에는 Reels API를 사용하세요.
  • 비공개 계정, 제한된 릴스, 로그인이 필요한 필드를 전제로 워크플로를 설계하지 마세요.

Instagram Reels API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
  • Instagram Comments API — 게시물 URL에서 공개 댓글, 작성자, 타임스탬프, 좋아요, 답글을 수집합니다.
  • Instagram Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 링크, 계정 속성, 카테고리, 공개된 수치를 가져옵니다.
  • Instagram Tagged Posts API — 선택한 프로필을 태그한 공개 게시물을 수집하며, 작성자, 미디어, 멘션, 태그된 사용자 맥락, 참여도를 포함합니다.
  • Instagram Transcript API — 공개 게시물 또는 릴스 URL에서 스크립트 텍스트, 언어, 형식, 출처 URL, 숏코드를 추출합니다.
  • Instagram Audio Reels API — 알고 있는 숫자형 오디오 ID로 공개 릴스를 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 공개된 참여도, 원본 오디오 맥락을 포함합니다.

다른 플랫폼 둘러보기

Instagram 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Instagram Reels API — 자주 묻는 질문

Instagram Reels API는 하나 이상의 Instagram 사용자 이름에 대해 공개적으로 접근 가능한 릴스를 수집합니다. 정규화된 캡션, 작성자 정보, 미디어 참조, 길이, 오디오, 해시태그, 멘션, 공개된 참여 수치를 반환합니다.

일반적으로 릴스 ID, 숏코드, URL, 작성자, 캡션, 게시 시각, 공개된 지표, 미디어 참조, 길이, 해시태그, 멘션, 오디오 메타데이터, 수집 시각이 포함됩니다.

현재 엔드포인트는 하나 이상의 공개 Instagram 사용자 이름을 받습니다. 개별 릴스 URL이나 숏코드는 요청 입력으로 받지 않습니다.

아니요. 이 엔드포인트는 공개적으로 접근 가능한 결과만 수집하므로, 비공개·제한·삭제 상태이거나 로그인이 필요한 릴스는 제한된 데이터만 반환되거나 레코드가 없을 수 있습니다.

공개 릴스 결과에서 URL이 제공되는 경우 공개 동영상 참조를 반환할 수 있습니다. 일부 릴스는 메타데이터나 썸네일만 제공할 수 있으므로, 클라이언트에서 미디어 필드가 없는 경우를 처리해야 합니다.

요청 빈도를 보수적으로 유지하고, 페이지 크기를 작게 하며, 커서 기반으로 이어서 가져오고, 429 또는 이와 비슷한 부하 응답이 오면 백오프를 적용하세요. 한 프로필을 대량으로 반복 스크래핑하는 일은 피하세요.

네. 공개 결과에서 오디오 데이터가 제공되는 경우에 한합니다. 정규화된 오디오 객체에는 ID, 제목, 아티스트, URL이 포함될 수 있습니다.