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를 폴링한 뒤, 정규화된 레코드를 커서 페이지네이션으로 읽습니다.
- 경로가 /p/, /reel/, /tv/로 시작하고 콘텐츠 숏코드가 포함된 공개 instagram.com URL을 하나 이상 준비합니다.
- urls를 /v1/instagram/post-info로 POST합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /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보다 레코드가 적게 반환될 수 있음을 고려하고, 콘텐츠를 사용할 수 없거나 공개되지 않은 경우를 대비해 작성자·수치·미디어·시각·상품 유형 필드는 선택 값으로 처리하세요.
관련 API
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 Followers Count API
- Instagram Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Tagged 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 Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API