instagram/
trending-reels

선택 조건 없이 트렌딩 피드에 노출되는 현재 릴스를 수집하고, 캡션, 작성자, 미디어, 게시 시각, 공개된 참여 수치를 반환합니다.

Instagram Trending Reels API

선택 조건 입력 없음
현재 피드 스냅샷
정규화된 릴스 레코드
결과당 0.5 크레딧
준비됨
README

SocQ 작성 · 업데이트

Instagram Trending Reels

Instagram 트렌딩 릴스는 현재 탐색 피드에 노출되는 공개 숏폼 동영상으로, 캡션, 크리에이터 정보, 미디어, 게시 시각, 공개된 참여 신호를 갖추고 있습니다. 이러한 스냅샷 레코드는 크리에이티브 검토, 탐색 피드 모니터링, 콘텐츠 비교, 후속 릴스 리서치에 활용할 수 있습니다.

Instagram Trending Reels API 주요 기능

  • 조건 없는 피드 스냅샷검색어, 계정, 해시태그, 지역, 날짜 필터를 지정하지 않고도 트렌딩 피드에 노출되는 현재 릴스를 수집합니다.
  • 정규화된 릴스 레코드릴스 식별 정보, 공개 URL, 캡션, 작성자 정보, 미디어 메타데이터, 게시 시각, 공개된 좋아요·댓글·조회·재생 수를 하나의 형식으로 받습니다.
  • 중복 제거정규화된 레코드를 저장하기 전에, 피드에서 반복된 행을 릴스 ID, 기본 키, 숏코드 기준으로 하나로 합칩니다.

Instagram Trending Reels API 매개변수

바로 실행 가능

이 엔드포인트는 요청 매개변수가 필요하지 않습니다. 빈 JSON 객체를 그대로 전송하세요.

{}

Instagram Trending Reels API 사용 방법

빈 JSON 객체를 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 저장된 스냅샷 레코드를 결과 커서 페이지네이션으로 읽습니다.

  1. 빈 JSON 객체를 준비합니다.
  2. 요청 본문을 /v1/instagram/trending-reels로 POST합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50을 읽고, results.has_more가 true인 동안 results.next_cursor를 따라가며 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/trending-reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Instagram Trending Reels API 추천 활용 사례

  • 현재 탐색 피드 목록 확보: 릴스 ID, 공개 URL, 캡션, 크리에이터 정보, 수집 시각을 저장해 현재 피드 스냅샷을 검토할 수 있는 기록으로 남깁니다.
  • 숏폼 크리에이티브 검토: 캡션 텍스트, 작성자 정보, 썸네일, 동영상 참조, 크기, 길이를 살펴보며 한 번의 스냅샷에 담긴 크리에이티브 사례를 검토합니다.
  • 스냅샷 내 참여 수치 비교: 같은 수집 작업에서 반환된 릴스들의 공개 좋아요, 댓글, 조회, 재생 수와 생성 시각을 비교합니다.

Instagram Trending Reels API 활용 팁

  • 빈 객체만 보내세요. query, region, username, hashtag, date, results_limit 필드는 거부됩니다.
  • 각 응답은 수집 시점에 소스가 정의한 피드 스냅샷으로 보고, 공식 순위 산정 방식이나 전 세계 또는 지역 단위 커버리지를 뜻하는 것으로 해석하지 마세요.
  • 업스트림의 다음 페이지를 요청하지 마세요. results.next_cursor는 완료된 작업에 이미 저장된 레코드를 이어서 읽는 용도로만 쓰입니다.
  • 스냅샷을 반복 보관할 때는 중복 제거가 피드 응답 하나 안에서만 적용되므로, 작업 간 중복은 고유 릴스 ID나 URL로 제거하세요.
  • 이 엔드포인트는 과거 스냅샷이나 예약 실행을 제공하지 않으므로, 직접 시계열을 만들 때는 결과마다 collected_at을 함께 저장하세요.
  • 캡션, 작성자 필드, 카운터, 미디어, URL, 생성 시각은 null일 수 있는 공개 필드로 처리하세요.

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

  • Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
  • Instagram Reels API — 사용자 이름으로 공개 릴스, 미디어, 오디오, 해시태그, 멘션, 참여도를 수집합니다.
  • Instagram Comments API — 게시물 URL에서 공개 댓글, 작성자, 타임스탬프, 좋아요, 답글을 수집합니다.
  • Instagram Tagged Posts API — 선택한 프로필을 태그한 공개 게시물을 수집하며, 작성자, 미디어, 멘션, 태그된 사용자 맥락, 참여도를 포함합니다.
  • Instagram Transcript API — 공개 게시물 또는 릴스 URL에서 스크립트 텍스트, 언어, 형식, 출처 URL, 숏코드를 추출합니다.
  • Instagram Post Info API — 알고 있는 공개 게시물, 릴스, 레거시 IGTV URL을 조회하며, 캡션, 작성자 정보, 미디어, 타임스탬프, 공개된 참여도, 입력 맥락을 포함합니다.

다른 플랫폼 둘러보기

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

Instagram Trending Reels API — 자주 묻는 질문

Instagram Trending Reels API는 선택 조건 입력 없이 트렌딩 피드에 노출되는 현재 공개 릴스를 수집하는 프로그래밍 인터페이스입니다. 정규화된 릴스 식별 정보, 캡션, 작성자, 미디어, 게시 시각, 공개된 참여 수치를 반환합니다.

요청 본문은 빈 JSON 객체입니다. query, region, username, hashtag, date, results_limit 필드는 받지 않습니다.

트렌딩은 수집 시점에 설정된 탐색 피드가 반환한 현재 릴스 세트를 뜻합니다. 이 엔드포인트는 순위 산정 방식을 공개하지 않으며, 전 세계 커버리지나 지역별 개인화, 일정한 정렬 순서를 보장하지 않습니다.

정규화된 레코드에는 릴스 ID와 URL, 캡션 텍스트, 작성자 ID·사용자 이름·이름·프로필 이미지, 공개된 좋아요·댓글·조회·재생 수, 미디어 메타데이터, created_at, collected_at, 상품 유형이 포함될 수 있습니다.

results_limit나 업스트림 연속 조회 매개변수는 받지 않으며, 수집기는 피드 요청을 한 번만 보냅니다. 다만 작업 결과 엔드포인트에서는 limit와 results.next_cursor로 이미 저장된 레코드를 페이지로 나누어 읽을 수 있습니다.

아니요. 작업마다 수집 시점에 노출된 피드를 가져옵니다. 독립적으로 수집한 스냅샷끼리 비교해야 한다면 결과를 collected_at과 함께 보관하세요.

반환된 정규화 레코드 1건당 0.5 크레딧이 차감되며, 기본 요금은 없습니다. 제출 시에는 20건을 기준으로 예상 금액을 계산하고, 최종 사용량은 실제 반환된 레코드 수에 따라 정해집니다.