Instagram Stories
Instagram 스토리는 계정이 24시간 동안 공유하는 사진과 동영상으로, 링크 스티커, 태그된 계정, 기간 한정 혜택처럼 메인 피드에는 나타나지 않는 정보가 담기는 경우가 많습니다. 스토리가 노출되는 동안 저장해 두면 브랜드, 마케팅, 리서치 팀은 그대로 사라질 신제품 출시, 프로모션, 크리에이터 활동 기록을 확보할 수 있습니다.
Instagram Stories API 주요 기능
- 계정에서 노출 중인 스토리 전체사용자 이름 하나로 요청 시점에 계정이 올려 둔 모든 스토리를 반환합니다.
- 바로 보관할 수 있는 미디어스토리마다 이미지 또는 동영상 URL, 가로·세로 크기, 커버 이미지가 포함되어 있어 콘텐츠를 저장하거나 나중에 검토할 수 있습니다.
- 게시 시각과 만료 시각게시 시각은 published_at으로, 만료 시각은 extra.expires_at으로 제공되므로 다음 수집까지 얼마나 여유가 있는지 정확히 알 수 있습니다.
- 스토리에 붙은 링크와 멘션 유지링크 스티커의 이동 경로는 extra.link_urls에, 태그된 계정은 extra.mentions에 담겨 해당 스토리에 연결됩니다.
Instagram Stories API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
username | 필수 | 현재 노출 중인 스토리를 가져올 공개 Instagram 계정의 사용자 이름입니다. 앞의 @는 생략할 수 있습니다. |
Instagram Stories API 사용 방법
사용자 이름을 보내고 작업이 끝날 때까지 기다린 뒤, 작업 결과에서 스토리를 읽습니다.
- 확인할 공개 계정을 정합니다. 예: natgeo.
- {"username": "natgeo"}를 /v1/instagram/stories로 POST하고, 응답의 task_id를 보관합니다.
- status가 succeeded가 될 때까지 몇 초 간격으로 GET /v1/tasks/{task_id}를 호출합니다.
- results.items에서 스토리를 읽고, results.has_more가 true이면 results.next_cursor를 전달해 다음 페이지를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/stories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"natgeo"}'
# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the stories once status is succeeded.Instagram Stories API 추천 활용 사례
- 일일 스토리 아카이브: 브랜드의 스토리를 하루에 한두 번 수집하고 미디어와 게시 시각을 보관해, 스토리가 만료된 뒤에도 검토할 수 있게 합니다.
- 프로모션 추적: 경쟁사가 스토리에 추가하는 링크 스티커 URL을 따라가, 이번 주에 어떤 상품, 세일, 랜딩 페이지를 밀고 있는지 확인합니다.
- 크리에이터 캠페인 점검: 크리에이터의 스토리 게시 시각, 미디어, 링크 스티커를 브리프와 대조해 합의한 스토리가 실제로 게시되었는지 확인합니다.
Instagram Stories API 활용 팁
- 모든 스토리가 노출되는 동안 최소 한 번은 수집되도록, 실행 간격을 24시간 미만으로 예약하세요.
- 스토리 미디어 링크는 임시 CDN 주소이므로, 보관하려는 이미지와 동영상은 수집 직후에 내려받으세요.
- 같은 계정을 다시 수집할 때는 스토리 id로 이미 저장한 스토리를 건너뛰세요.
- 계정이 프로필에 보관해 둔 스토리는 Instagram Story Highlights와 Instagram Highlight Items를 사용하세요.
관련 API
Instagram Stories API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
- Instagram Reels API — 사용자 이름으로 공개 릴스, 미디어, 오디오, 해시태그, 멘션, 참여도를 수집합니다.
- Instagram Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 링크, 계정 속성, 카테고리, 공개된 수치를 가져옵니다.
- Instagram Tagged Posts API — 선택한 프로필을 태그한 공개 게시물을 수집하며, 작성자, 미디어, 멘션, 태그된 사용자 맥락, 참여도를 포함합니다.
- Instagram Story Highlights API — 사용자 이름으로 공개 스토리 하이라이트 목록을 조회하며, 제목, 소유자 맥락, 미디어 수, 재사용 가능한 하이라이트 ID를 포함합니다.
- Instagram Similar Accounts API — 사용자 이름과 비슷한 계정으로 Instagram이 추천하는 계정 목록을 가져오며, 사용자 이름, 이름, 프로필 이미지, 인증 상태를 포함합니다.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Trending Reels 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