Instagram Transcript
Instagram Transcript 레코드는 공개 게시물과 릴스의 음성에서 얻은 텍스트를 담고 있으며, 언어, 출력 형식, 원본 URL, 숏코드, 수집 시각이 함께 제공됩니다. 이러한 레코드는 음성 콘텐츠 검색, 접근성 검토, 콘텐츠 색인, 원본 링크를 포함한 리서치에 활용할 수 있습니다.
Instagram Transcript API 주요 기능
- 여러 원본 URL 지원공개 Instagram 게시물 또는 릴스 URL을 하나 이상 제출하면, 음성이 포함된 미디어에 대한 스크립트 레코드를 받습니다.
- 캐러셀 대응 결과캐러셀 게시물 하나에서 미디어 스크립트가 둘 이상 나오면 각각을 별도의 스크립트 레코드로 보존합니다.
- 정규화된 텍스트와 출처 정보스크립트 텍스트와 함께 언어, plaintext 또는 WebVTT 형식, 원본 URL, 미디어 식별자, 숏코드, 수집 시각을 반환합니다.
Instagram Transcript API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 Instagram 게시물 또는 릴스 URL 하나 이상으로, 쉼표 또는 줄바꿈으로 구분합니다. |
Instagram Transcript API 사용 방법
공개 Instagram 미디어 URL을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 스크립트 레코드를 모두 커서 페이지네이션으로 읽습니다.
- 공개 Instagram 게시물 또는 릴스 URL을 하나 이상 준비합니다.
- urls 배열을 /v1/instagram/transcript로 POST합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /v1/tasks/{task_id}?limit=50을 읽고, 입력 URL 하나에 레코드가 없거나 여러 개인 경우를 대조하며, results.has_more가 true인 동안 results.next_cursor를 따라가며 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.instagram.com/reel/DHsD6HGqJhp/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueInstagram Transcript API 추천 활용 사례
- 음성 콘텐츠 검색: 스크립트 텍스트를 언어, 원본 URL, 숏코드와 함께 색인해, 선택한 공개 게시물과 릴스를 음성 속 단어로 검색할 수 있게 합니다.
- 게시물·릴스 리서치: 엄선한 URL 세트의 스크립트 텍스트를 검토하면서, 출처 확인을 위해 미디어 식별자와 수집 시각을 함께 보관합니다.
- 자막·접근성 검토: 반환된 텍스트와 형식 메타데이터로 읽기 쉬운 사본을 준비하거나, 선택한 공개 미디어에 사용할 수 있는 음성 콘텐츠 레코드가 있는지 확인합니다.
Instagram Transcript API 활용 팁
- 작업을 시작하기 전에 정식 공개 게시물·릴스 URL을 제출하고 완전히 같은 URL은 제거해, 의도한 원본마다 한 번씩만 처리되게 하세요.
- 소리가 없는 미디어는 레코드가 반환되지 않을 수 있고 캐러셀 URL 하나가 여러 레코드를 반환할 수도 있으므로, URL만으로 대조하지 말고 레코드 ID로 대조하세요.
- 후속 파싱은 format에 따라 분기하세요. 시간 구조가 중요하면 WebVTT 큐를 보존하고, plaintext는 구간이 나뉘지 않은 텍스트로 취급하세요.
- created_at에는 Instagram 미디어의 게시 시각이 채워지지 않으므로, 수집 이력은 collected_at으로 관리하세요.
- 스크립트 텍스트를 청크로 나눌 때는 파생된 모든 구간에 레코드 ID, 원본 URL, 숏코드, 언어, 형식, collected_at을 함께 유지하세요.
관련 API
Instagram Transcript API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
- Instagram Reels API — 사용자 이름으로 공개 릴스, 미디어, 오디오, 해시태그, 멘션, 참여도를 수집합니다.
- Instagram Tagged Posts API — 선택한 프로필을 태그한 공개 게시물을 수집하며, 작성자, 미디어, 멘션, 태그된 사용자 맥락, 참여도를 포함합니다.
- Instagram Audio Reels API — 알고 있는 숫자형 오디오 ID로 공개 릴스를 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 공개된 참여도, 원본 오디오 맥락을 포함합니다.
- Instagram Highlight Items API — 알고 있는 하이라이트 ID에서 저장된 공개 스토리 항목을 가져오며, 텍스트, 작성자 정보, 미디어, 타임스탬프, 공개된 지표, 출처 맥락을 포함합니다.
- Instagram Post Info API — 알고 있는 공개 게시물, 릴스, 레거시 IGTV URL을 조회하며, 캡션, 작성자 정보, 미디어, 타임스탬프, 공개된 참여도, 입력 맥락을 포함합니다.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts 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