instagram/
post-info

알고 있는 URL로 공개 Instagram 게시물, 릴스, 과거 IGTV 콘텐츠를 조회하고, 캡션, 작성자 정보, 미디어, 게시 시각, 공개된 참여 수치를 반환합니다.

Instagram Post Info API

URL로 바로 조회
게시물 메타데이터
공개 콘텐츠
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Instagram Post Info

Instagram Post Info 레코드는 공개 게시물, 릴스, 과거 IGTV 콘텐츠 하나하나를 캡션, 작성자 정보, 미디어 참조, 게시 시각, 공개된 참여 수치, 원본 상품 유형으로 설명합니다. 이러한 필드는 알고 있는 URL의 정보 보강, 콘텐츠 카탈로그 작성, 참여 현황 스냅샷, 포맷 비교에 활용할 수 있습니다.

Instagram Post Info API 주요 기능

  • 콘텐츠 URL 직접 조회프로필 수집이나 탐색 없이, 알고 있는 공개 Instagram /p/, /reel/, /tv/ URL을 바로 조회합니다.
  • 캡션과 작성자 정보공개된 캡션 텍스트와 함께 확인 가능한 작성자 ID, 사용자 이름, 표시 이름, 프로필 이미지 참조를 반환합니다.
  • 미디어와 참여 상세공개된 이미지·동영상 참조를 정규화하고, 공개된 좋아요·댓글·조회·재생 수를 함께 제공합니다.
  • 추적 가능한 정규화 레코드제출한 URL과 확인 가능한 원본 상품 유형을 표준화된 게시물 레코드마다 그대로 보존합니다.

Instagram Post Info API 매개변수

매개변수필수설명
urls필수필수 값인 Instagram 콘텐츠 URL로, 쉼표 또는 줄바꿈으로 구분합니다. 허용되는 호스트는 instagram.com과 www.instagram.com이며, 경로는 /p/, /reel/, /tv/로 시작해야 합니다.

Instagram Post Info API 사용 방법

공개 콘텐츠 URL을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 레코드를 커서 페이지네이션으로 읽습니다.

  1. 경로가 /p/, /reel/, /tv/로 시작하고 콘텐츠 숏코드가 포함된 공개 instagram.com URL을 하나 이상 준비합니다.
  2. urls를 /v1/instagram/post-info로 POST합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50에서 data.results.items를 읽고, results.has_more가 true인 동안 results.next_cursor를 따라가며 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/post-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"urls\":[\"$INSTAGRAM_POST_URL\"]}"

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.items.

Instagram Post Info API 추천 활용 사례

  • 알고 있는 게시물 정보 보강: 저장해 둔 Instagram 콘텐츠 URL 목록에 캡션, 작성자, 미디어, 게시 시각, 공개된 참여 수치 필드를 추가합니다.
  • 콘텐츠 카탈로그 정규화: 게시물, 릴스, 과거 IGTV 링크가 섞인 목록을 고유 식별자와 출처 정보를 갖춘 일관된 레코드로 변환합니다.
  • 공개 참여 수치 스냅샷: 선택한 콘텐츠에 대해 수집 시점에 반환된 공개 좋아요·댓글·조회·재생 수를 기록합니다.
  • 콘텐츠 포맷 검토: 미디어 필드와 원본 상품 유형을 활용해 알고 있는 피드 게시물, 릴스, 과거 IGTV 콘텐츠의 메타데이터를 비교합니다.

Instagram Post Info API 활용 팁

  • /p/, /reel/, /tv/ 뒤에는 실제 숏코드를 넣으세요. 접두사만 있는 경로는 형식 검사를 통과해도 레코드가 반환되지 않을 수 있습니다.
  • 여러 URL을 제출한 작업의 결과를 입력과 대조할 때는 extra.input_url을 보관하세요. 중복 URL은 하나로 합쳐지며, 고유한 URL마다 레코드는 최대 1건입니다.
  • 제출한 URL보다 레코드가 적게 반환될 수 있음을 고려하고, 콘텐츠를 사용할 수 없거나 공개되지 않은 경우를 대비해 작성자·수치·미디어·시각·상품 유형 필드는 선택 값으로 처리하세요.

Instagram Post Info API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
  • Instagram Reels API — 사용자 이름으로 공개 릴스, 미디어, 오디오, 해시태그, 멘션, 참여도를 수집합니다.
  • Instagram Comments API — 게시물 URL에서 공개 댓글, 작성자, 타임스탬프, 좋아요, 답글을 수집합니다.
  • Instagram Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 링크, 계정 속성, 카테고리, 공개된 수치를 가져옵니다.
  • Instagram Transcript API — 공개 게시물 또는 릴스 URL에서 스크립트 텍스트, 언어, 형식, 출처 URL, 숏코드를 추출합니다.
  • Instagram Post Likers API — 게시물 URL에서 공개된 좋아요 목록의 계정을 가져오며, 사용자 이름, 이름, 프로필 이미지, 인증 상태를 포함합니다.

다른 플랫폼 둘러보기

Instagram 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Instagram Post Info API — 자주 묻는 질문

Instagram Post Info API는 알고 있는 Instagram URL에서 공개 게시물, 릴스, 과거 IGTV 콘텐츠를 하나씩 조회하는 프로그래밍 인터페이스입니다. 정규화된 캡션, 작성자, 미디어, 게시 시각, 공개된 참여 수치, 입력 컨텍스트 필드를 반환합니다.

경로가 /p/, /reel/, /tv/로 시작하는 instagram.com 또는 www.instagram.com URL을 제출합니다. 접두사 뒤에 실제 콘텐츠 숏코드를 포함해야 하며, 접두사만 있는 경로는 검증을 통과해도 레코드가 반환되지 않을 수 있습니다.

레코드에는 ID, 원본 URL, 캡션, 작성자 정보, 공개된 좋아요·댓글·조회·재생 수, 미디어 참조, 게시 시각과 수집 시각, 제출한 입력 URL, 원본 상품 유형이 포함될 수 있습니다.

중복된 입력은 하나로 합쳐지고, 비공개·삭제·제한·형식 오류 또는 그 밖의 이유로 사용할 수 없는 콘텐츠는 레코드가 생성되지 않을 수 있습니다. 고유한 URL마다 항목은 최대 1건 반환됩니다.

저장된 결과 1건당 0.5 크레딧이 차감되며, 작업 자체에 대한 기본 요금은 없습니다. 저장된 레코드가 없는 작업에는 결과 요금이 부과되지 않습니다.