Instagram Audio Reels
Instagram 오디오 릴스는 같은 오디오 식별자와 연결된 공개 숏폼 동영상으로, 캡션, 크리에이터 정보, 미디어 참조 정보, 타임스탬프, 공개된 참여 지표를 담고 있습니다. 출처가 연결된 이 레코드는 오디오 활용 현황 검토, 크리에이티브 조사, 오디오 ID별 공개 릴스 활동 비교에 활용할 수 있습니다.
Instagram Audio Reels API 주요 기능
- 알고 있는 오디오 ID 지정제목이나 아티스트로 검색하지 않고, 숫자형 Instagram 오디오 ID를 하나 이상 제출해 정확히 그 식별자와 연결된 공개 릴스를 수집합니다.
- 오디오별 독립 수집오디오 ID마다 자체 results_limit, 커서 순서, 입력 내 레코드 중복 제거를 적용해 처리하므로 각 출처의 수집 범위가 제한됩니다.
- 출처가 연결된 릴스 레코드정규화된 릴스 ID, URL, 캡션, 크리에이터 정보, 미디어, 타임스탬프, 공개된 참여 지표와 출처를 나타내는 extra.audio_id를 받습니다.
Instagram Audio Reels API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
audio_ids | 필수 | 알고 있는 Instagram 오디오 ID를 비어 있지 않은 숫자 문자열로, 쉼표나 줄바꿈으로 구분해 하나 이상 지정합니다. |
results_limit | 선택 | 오디오 ID마다 요청하는 최대 레코드 수입니다. 기본값은 100이며 20 이상 2,000 이하의 정수를 받습니다. |
Instagram Audio Reels API 사용 방법
알고 있는 오디오 ID를 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 릴스 레코드를 커서 페이지네이션으로 읽습니다.
- 알고 있는 Instagram 오디오 ID를 비어 있지 않은 숫자 문자열로 하나 이상 준비합니다.
- audio_ids와 선택 항목인 오디오별 results_limit을 /v1/instagram/audio-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/audio-reels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"audio_ids":["123456789012345"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueInstagram Audio Reels API 추천 활용 사례
- 오디오 활용 현황 검토: 공개 릴스 URL, 캡션, 크리에이터, 타임스탬프를 extra.audio_id별로 묶어 알고 있는 오디오를 둘러싼 공개 참여 현황을 살펴봅니다.
- 크리에이티브 사례 조사: 선택한 오디오 ID와 연결된 캡션, 크리에이터 정보, 미디어 참조 정보, 원본 릴스 URL로 출처가 연결된 검토용 데이터셋을 만듭니다.
- 공개 참여 지표 비교: 수집한 릴스 전반에서 확인 가능한 좋아요, 댓글, 조회수, 재생수를 비교하되, 각 레코드를 만든 오디오 ID를 함께 유지합니다.
Instagram Audio Reels API 활용 팁
- 오디오 ID는 제출 전에 찾아서 확인하세요. 이 엔드포인트는 숫자 식별자를 받으며 곡 제목, 아티스트, 키워드로는 오디오를 검색하지 않습니다.
- results_limit은 제출한 모든 식별자에 각각 독립적으로 적용되므로, 오디오 ID마다 수집량과 예상 크레딧을 계획하세요.
- 반복 수집한 결과를 합칠 때는 안정적인 릴스 ID나 정식 URL로 중복을 제거하고, 출처 표기를 위해 extra.audio_id는 그대로 유지하세요.
- 카운터, 미디어, 크리에이터 필드, 타임스탬프는 선택 값으로 취급하세요. 수집은 오디오별 제한, 피드의 끝, 100페이지 상한 중 먼저 닿는 지점까지로 제한되며 전체 이력 아카이브가 아니라고 해석해야 합니다.
관련 API
Instagram Audio 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 Highlight Items API
- Instagram Reels Search 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 Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API