Instagram Posts
Instagram 게시물은 캡션, 작성자 정보, 이미지 또는 동영상, 게시 시각, 해시태그, 멘션, 공개된 참여 수치를 담은 피드 콘텐츠입니다. 이러한 콘텐츠 신호는 크리에이터 리서치, 캠페인 검토, 미디어 분석, 과거 데이터 리포팅에 활용할 수 있습니다.
Instagram Posts API 주요 기능
- 사용자 이름 기반 게시물 수집하나 이상의 사용자 이름에 대한 공개 Instagram 게시물을 하나의 정규화된 응답 형식으로 수집합니다.
- 미디어 참조와 크기 정보공개된 미디어·썸네일 참조, 크기, 동영상 길이를 정규화된 미디어 필드로 반환합니다.
- 사진·동영상 레코드공개된 사진 게시물과 동영상 게시물을 같은 응답 구조로 정규화합니다.
- 콘텐츠·참여 필드게시물 레코드마다 캡션 텍스트, 작성자 정보, 게시 시각, 공개된 지표, 해시태그, 멘션을 포함합니다.
- 공개 데이터 범위 준수비공개·삭제·제한 상태이거나 로그인이 필요한 콘텐츠는 응답 범위에서 제외합니다.
Instagram Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
usernames | 필수 | @를 뺀 공개 Instagram 사용자 이름으로, 쉼표 또는 줄바꿈으로 구분합니다. |
results_limit | 선택 | 수집 작업이 요청할 최대 레코드 수입니다. 양의 정수여야 합니다. |
Instagram Posts API 사용 방법
공개 사용자 이름을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 게시물 레코드를 커서 페이지네이션으로 읽습니다.
- @를 뺀 공개 Instagram 사용자 이름을 하나 이상 준비합니다.
- usernames와 선택 값인 results_limit를 /v1/instagram/posts로 POST합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /v1/tasks/{task_id}?limit=50을 읽고, 레코드가 더 있으면 results.next_cursor를 따라가며 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["natgeo"],"results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Instagram Posts API 추천 활용 사례
- 프로필 게시물 수집: 선택한 Instagram 사용자 이름의 공개 게시물을 미디어 참조와 고유 식별자가 담긴 정규화된 레코드로 수집합니다.
- 콘텐츠 리서치: 리서치·분석 팀이 검토할 게시물의 공개 캡션, 게시 시각, 해시태그, 공개된 참여 수치를 수집합니다.
- 아카이브 워크플로: 공개 게시물 메타데이터, 미디어 참조, 작성자 정보, 원본 URL, 수집 시각을 검토 대기열, 리포팅 시스템, 내부 기록에 저장합니다.
- 캠페인 QA: 크리에이터나 브랜드 사용자 이름으로 반환된 공개 게시물을 검토한 뒤, 선택한 레코드를 캠페인 데이터와 결합합니다.
- 프로필 콘텐츠 정보 보강: 게시물 ID, 작성자 정보, 캡션, 미디어 참조, 공개된 지표를 기존 프로필 또는 캠페인 레코드와 결합합니다.
Instagram Posts API 활용 팁
- 사용자 이름은 @ 접두사 없이 제출하고, 새 워크플로를 검증하는 동안에는 배치를 작게 유지하세요.
- 소스 상황에 따라 일부 공개 레코드에는 미디어 참조, 수치, 시각이 없을 수 있다고 가정하세요.
- 429, 챌린지, 일시적 차단 응답이 오면 공격적으로 재시도하지 말고 보수적인 재시도와 백오프를 적용하세요.
- 프로필 단위로 릴스를 수집할 때는 Reels API를, 탐색에는 Search API를, 공개 댓글 스레드가 필요할 때는 Comments API를 사용하세요.
- 비공개 계정, 스토리, 하이라이트, 로그인이 필요한 필드를 전제로 워크플로를 설계하지 마세요.
관련 API
Instagram Posts API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Instagram Reels API — 사용자 이름으로 공개 릴스, 미디어, 오디오, 해시태그, 멘션, 참여도를 수집합니다.
- Instagram Comments API — 게시물 URL에서 공개 댓글, 작성자, 타임스탬프, 좋아요, 답글을 수집합니다.
- Instagram Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 링크, 계정 속성, 카테고리, 공개된 수치를 가져옵니다.
- Instagram Tagged Posts API — 선택한 프로필을 태그한 공개 게시물을 수집하며, 작성자, 미디어, 멘션, 태그된 사용자 맥락, 참여도를 포함합니다.
- Instagram Transcript API — 공개 게시물 또는 릴스 URL에서 스크립트 텍스트, 언어, 형식, 출처 URL, 숏코드를 추출합니다.
- Instagram Post Info API — 알고 있는 공개 게시물, 릴스, 레거시 IGTV URL을 조회하며, 캡션, 작성자 정보, 미디어, 타임스탬프, 공개된 참여도, 입력 맥락을 포함합니다.
- Instagram Followers Count API
- Instagram Search 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 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