instagram/
tagged-posts

하나 이상의 사용자 이름으로 선택한 프로필을 태그한 공개 Instagram 게시물을 수집하고, 캡션, 작성자, 미디어, 멘션, 공개된 참여 수치를 반환합니다.

Instagram Tagged Posts API

프로필 태그
게시물 맥락
공개 콘텐츠
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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를 폴링한 뒤, 정규화된 태그 게시물을 커서 페이지네이션으로 읽습니다.

  1. 앞의 @ 문자를 뺀 공개 Instagram 사용자 이름을 하나 이상 준비합니다.
  2. usernames와 1~2,000 사이의 선택 값인 results_limit를 /v1/instagram/tagged-posts로 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/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_cursor

Instagram 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로 계속 가져오세요.

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

Instagram Tagged Posts API — 자주 묻는 질문

Instagram Tagged Posts API는 제출한 하나 이상의 사용자 이름으로 지정한 프로필을 태그한 공개 게시물을 가져오는 프로그래밍 인터페이스입니다. 정규화된 게시물·작성자 정보, 캡션, 미디어, 태그된 사용자 정보, 멘션, 게시 시각, 공개된 참여 수치를 반환합니다.

아니요. 이 엔드포인트는 대상 프로필을 태그한 게시물을 찾습니다. 멘션은 공개 결과에서 제공될 때 일치한 게시물과 함께 반환되는 필드일 뿐, 멘션된 게시물을 따로 검색하는 기능이 아닙니다.

공개 프로필 사용자 이름으로 이루어진, 비어 있지 않은 usernames 배열을 제출합니다. 입력 매핑 단계에서 앞의 @는 제거됩니다. results_limit는 선택 값이며 1~2,000 사이의 정수를 받고 기본값은 100입니다.

extra.tagged_users는 게시물에 대해 반환된 구조화된 프로필 태그 정보를 유지합니다. mentions는 정규화된 콘텐츠 레코드에서 멘션으로 반환된 사용자 이름의 별도 목록입니다.

Tagged Posts는 선택한 프로필을 태그한 공개 게시물을 찾습니다. 반면 Instagram Posts는 제출한 사용자 이름이 작성한 게시물을 수집합니다.

레코드에는 ID, 숏코드, URL, 캡션, 작성자 정보, 미디어, 해시태그, 멘션, 태그된 사용자, 상품 유형, 게시 시각과 수집 시각, 공개된 좋아요·댓글·조회·재생 수가 포함될 수 있습니다.

공개적으로 확인 가능한 일치 게시물만 반환할 수 있습니다. 삭제·제한·비공개 상태이거나 로그인이 필요하거나 원본에서 빠진 레코드와 필드 때문에 일부 결과만 오거나 결과가 비어 있을 수 있습니다.

페이지당 최대 500건의 작업 결과를 읽을 수 있으며, has_more가 true인 동안 next_cursor로 이어서 가져옵니다.

정규화된 결과가 성공적으로 반환되면 레코드 1건당 0.5 크레딧이 차감되며, 기본 요금은 없습니다. 기본 요금만 있는 정책에서 빈 결과는 0 크레딧입니다.