instagram/
audio-reels

알고 있는 숫자형 오디오 ID로 공개 Instagram 릴스를 수집하여, 캡션, 크리에이터 정보, 미디어, 공개된 참여 지표, 타임스탬프, 원본 오디오 정보를 반환합니다.

Instagram Audio Reels API

오디오 ID 조회
공개 릴스 레코드
오디오별 개수 제한
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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

  1. 알고 있는 Instagram 오디오 ID를 비어 있지 않은 숫자 문자열로 하나 이상 준비합니다.
  2. audio_ids와 선택 항목인 오디오별 results_limit을 /v1/instagram/audio-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/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 true

Instagram Audio Reels API 추천 활용 사례

  • 오디오 활용 현황 검토: 공개 릴스 URL, 캡션, 크리에이터, 타임스탬프를 extra.audio_id별로 묶어 알고 있는 오디오를 둘러싼 공개 참여 현황을 살펴봅니다.
  • 크리에이티브 사례 조사: 선택한 오디오 ID와 연결된 캡션, 크리에이터 정보, 미디어 참조 정보, 원본 릴스 URL로 출처가 연결된 검토용 데이터셋을 만듭니다.
  • 공개 참여 지표 비교: 수집한 릴스 전반에서 확인 가능한 좋아요, 댓글, 조회수, 재생수를 비교하되, 각 레코드를 만든 오디오 ID를 함께 유지합니다.

Instagram Audio Reels API 활용 팁

  • 오디오 ID는 제출 전에 찾아서 확인하세요. 이 엔드포인트는 숫자 식별자를 받으며 곡 제목, 아티스트, 키워드로는 오디오를 검색하지 않습니다.
  • results_limit은 제출한 모든 식별자에 각각 독립적으로 적용되므로, 오디오 ID마다 수집량과 예상 크레딧을 계획하세요.
  • 반복 수집한 결과를 합칠 때는 안정적인 릴스 ID나 정식 URL로 중복을 제거하고, 출처 표기를 위해 extra.audio_id는 그대로 유지하세요.
  • 카운터, 미디어, 크리에이터 필드, 타임스탬프는 선택 값으로 취급하세요. 수집은 오디오별 제한, 피드의 끝, 100페이지 상한 중 먼저 닿는 지점까지로 제한되며 전체 이력 아카이브가 아니라고 해석해야 합니다.

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

Instagram Audio Reels API — 자주 묻는 질문

Instagram Audio Reels API는 제출한 숫자형 오디오 ID와 연결된 공개 Instagram 릴스를 수집하는 프로그래밍 인터페이스입니다. 정규화된 릴스 식별 정보, 캡션, 크리에이터, 미디어, 타임스탬프, 공개된 참여 지표, 원본 오디오 정보를 반환합니다.

알고 있는 Instagram 오디오 ID를 나타내는 숫자 문자열의 비어 있지 않은 배열을 보내세요. 이 엔드포인트는 곡 제목, 아티스트 이름, 키워드를 ID로 변환하지 않습니다.

results_limit은 20 이상 2,000 이하의 정수를 받으며 기본값은 100입니다. 오디오 ID마다 따로 적용되고, 각 출처의 수집은 피드의 끝이나 100페이지 상한에서도 멈춥니다.

레코드에는 릴스 ID, URL, 캡션 텍스트, 크리에이터 ID, 사용자 이름, 이름, 아바타, 미디어 참조 정보, created_at, collected_at, 공개된 좋아요·댓글·조회·재생 수와 함께 extra.audio_id가 포함될 수 있습니다.

아니요. 결과는 요청한 오디오별 개수, 원본이 반환하는 공개 피드, 100페이지 수집 상한으로 제한되며, 확인할 수 없는 공개 필드는 null이거나 없을 수도 있습니다.

반환된 정규화 레코드 1건당 0.5 크레딧이 청구되며 기본 요금은 없습니다. 예상 요금은 오디오별 results_limit에 제출한 오디오 ID 수를 곱해 계산하고, 최종 사용량은 실제로 저장된 레코드를 따릅니다.