Instagram Tagged Posts
Instagram 태그된 게시물은 게시물 단위 태그로 다른 프로필을 지정한 공개 게시물이며, 멘션된 사용자 이름과 함께 캡션, 작성자, 미디어, 해시태그, 게시 시각, 공개된 참여 수치를 포함할 수 있습니다. 이러한 콘텐츠·관계 신호는 태그 모니터링, 출처 검토, 크리에이터 리서치, 구조화된 콘텐츠 아카이브에 활용할 수 있습니다.
Instagram Tagged Posts API 주요 기능
- 프로필 태그 탐색공개 Instagram 사용자 이름을 대상으로 지정하면, 대상 계정이 작성한 게시물이 아니라 해당 프로필을 태그한 게시물을 반환합니다.
- 게시물·작성자 식별 정보추적 가능한 콘텐츠 레코드를 위해 게시물 ID, 숏코드, 게시물 URL, 캡션, 정규화된 작성자 프로필 필드를 받습니다.
- 태그된 사용자·멘션 맥락구조화된 tagged_users 정보를 해시태그, 반환된 멘션과 함께 유지해 게시물 간 서로 다른 관계를 구분할 수 있습니다.
- 미디어와 공개 참여 수치공개 게시물마다 제공되는 공개 좋아요·댓글·조회·재생 수와 함께 정규화된 이미지·동영상 참조를 반환합니다.
- 게시 맥락시간순 검토와 게시물 포맷 분류를 위해 정규화된 게시 시각, 수집 시각, product_type 정보를 포함합니다.
Instagram Tagged Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
usernames | 필수 | @를 뺀 공개 Instagram 프로필 사용자 이름 하나 이상으로, 쉼표 또는 줄바꿈으로 구분합니다. |
results_limit | 선택 | 작업이 요청하는 태그 게시물 레코드의 최대 개수입니다. 1~2,000 사이의 정수이며 기본값은 100입니다. |
Instagram Tagged Posts API 사용 방법
대상 프로필의 사용자 이름을 비동기 작업으로 제출하고, 반환된 작업 ID를 폴링한 뒤, 정규화된 태그 게시물을 커서 페이지네이션으로 읽습니다.
- 앞의 @ 문자를 뺀 공개 Instagram 사용자 이름을 하나 이상 준비합니다.
- usernames와 1~2,000 사이의 선택 값인 results_limit를 /v1/instagram/tagged-posts로 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/tagged-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["instagram"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursorInstagram Tagged Posts API 추천 활용 사례
- 프로필 태그 모니터링: tagged_users, 게시물 URL, 캡션, 작성자, 타임스탬프를 활용해 선택한 프로필을 태그한 공개 게시물을 검토합니다.
- 캠페인 연관성 검토: 캠페인 프로필 태그와 연결된 게시물들의 캡션, 미디어, 태그된 사용자 정보, 공개된 참여 수치를 비교합니다.
- 크리에이터 기여도 리서치: 정규화된 작성자 정보와 프로필 태그 관계를 활용해, 선택한 계정과 관련된 콘텐츠를 게시하는 공개 크리에이터를 찾아냅니다.
- 태그된 콘텐츠 아카이빙: 게시물 ID, 숏코드, 반환된 URL, 미디어 참조, 게시 시각, 수집 시각을 검토할 수 있는 콘텐츠 레코드로 저장합니다.
Instagram Tagged Posts API 활용 팁
- 요청에 깨끗한 프로필 식별자가 들어가도록, 제출 전에 대상 사용자 이름마다 앞의 @를 제거하세요.
- extra.tagged_users는 게시물 단위 프로필 태그를, mentions는 반환된 멘션 문자열을 담고 있으므로 두 필드를 같은 것으로 취급하지 마세요.
- 반복 수집한 데이터는 게시물 ID나 숏코드로 중복을 제거하고, 검토와 추적을 위해 반환된 게시물 URL을 보관하세요.
- 정규화된 공개 레코드는 원본의 null 가능한 필드를 그대로 유지하므로, 미디어·참여 수치·작성자 플래그·타임스탬프가 없을 수 있다고 가정하세요.
- 큰 규모의 태그 게시물 결과가 첫 페이지 이후에 잘리지 않도록, results.has_more가 true인 동안에는 results.next_cursor로 계속 가져오세요.
관련 API
Instagram Tagged Posts API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
- Instagram Reels API — 사용자 이름으로 공개 릴스, 미디어, 오디오, 해시태그, 멘션, 참여도를 수집합니다.
- Instagram Comments API — 게시물 URL에서 공개 댓글, 작성자, 타임스탬프, 좋아요, 답글을 수집합니다.
- Instagram Profiles 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