Instagram Trending Reels
Instagram 트렌딩 릴스는 현재 탐색 피드에 노출되는 공개 숏폼 동영상으로, 캡션, 크리에이터 정보, 미디어, 게시 시각, 공개된 참여 신호를 갖추고 있습니다. 이러한 스냅샷 레코드는 크리에이티브 검토, 탐색 피드 모니터링, 콘텐츠 비교, 후속 릴스 리서치에 활용할 수 있습니다.
Instagram Trending Reels API 주요 기능
- 조건 없는 피드 스냅샷검색어, 계정, 해시태그, 지역, 날짜 필터를 지정하지 않고도 트렌딩 피드에 노출되는 현재 릴스를 수집합니다.
- 정규화된 릴스 레코드릴스 식별 정보, 공개 URL, 캡션, 작성자 정보, 미디어 메타데이터, 게시 시각, 공개된 좋아요·댓글·조회·재생 수를 하나의 형식으로 받습니다.
- 중복 제거정규화된 레코드를 저장하기 전에, 피드에서 반복된 행을 릴스 ID, 기본 키, 숏코드 기준으로 하나로 합칩니다.
Instagram Trending Reels API 매개변수
바로 실행 가능
이 엔드포인트는 요청 매개변수가 필요하지 않습니다. 빈 JSON 객체를 그대로 전송하세요.
{}Instagram Trending Reels API 사용 방법
빈 JSON 객체를 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 저장된 스냅샷 레코드를 결과 커서 페이지네이션으로 읽습니다.
- 빈 JSON 객체를 준비합니다.
- 요청 본문을 /v1/instagram/trending-reels로 POST합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /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 trueInstagram 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일 수 있는 공개 필드로 처리하세요.
관련 API
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 Followers Count API
- Instagram Search API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API