# 인스타그램 게시물·릴스 조회 인스타그램 게시물·릴스 주소로 좋아요·댓글 수·조회수·캡션·해시태그·미디어 주소를 조회합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/instagram_post 응답 필드 - `data` (object): 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. - `data.url` (string): 게시물 주소 - `data.shortcode` (string): 게시물 코드 - `data.username` (string): 작성자 사용자명 - `data.caption` (string): 캡션 - `data.content_type` (string): Image · Video · Carousel · Reel - `data.posted_at` (string): 게시 시각 (ISO 8601) - `data.likes` (integer): 좋아요 수. 숨김이면 null null 허용. - `data.comments` (integer): 댓글 수 - `data.views` (integer): 조회수 (영상). 없으면 null null 허용. - `data.duration_sec` (number): 영상 길이(초). 없으면 null null 허용. - `data.hashtags` (array): 해시태그 - `data.is_paid_partnership` (boolean): 유료 광고 표시 여부 - `data.coauthors` (array): 공동 작성자 사용자명 - `data.thumbnail_url` (string): 썸네일 주소 - `data.image_urls` (array): 이미지 주소 목록 - `data.video_url` (string): 영상 주소. 없으면 빈 문자열 - `data.author` (object): 작성자 정보 - `data.author.followers` (integer): 작성자 팔로워 수 - `data.author.is_verified` (boolean): 작성자 인증 여부 - `data.author.profile_url` (string): 작성자 프로필 주소 - `api` (object): API 호출 공통 데이터 - `api.success` (boolean): API 서버 정상 응답 여부 - `api.cost` (integer): 차감된 포인트. 실패한 응답은 0 - `api.pl_id` (integer): API 결제 로그 ID - `api.ms` (integer): API 응답 시간(밀리초) ## API 요청: POST /rest/instagram_post ### 입력 - `url` (string, 필수): 인스타그램 게시물·릴스 주소 (예: https://www.instagram.com/p/코드/ 또는 /reel/코드/) ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "url": { "type": "string", "description": "게시물 주소" }, "shortcode": { "type": "string", "description": "게시물 코드" }, "username": { "type": "string", "description": "작성자 사용자명" }, "caption": { "type": "string", "description": "캡션" }, "content_type": { "type": "string", "description": "Image · Video · Carousel · Reel" }, "posted_at": { "type": "string", "description": "게시 시각 (ISO 8601)" }, "likes": { "type": "integer", "description": "좋아요 수. 숨김이면 null", "nullable": true }, "comments": { "type": "integer", "description": "댓글 수" }, "views": { "nullable": true, "type": "integer", "description": "조회수 (영상). 없으면 null" }, "duration_sec": { "nullable": true, "type": "number", "description": "영상 길이(초). 없으면 null" }, "hashtags": { "type": "array", "items": {}, "description": "해시태그" }, "is_paid_partnership": { "type": "boolean", "description": "유료 광고 표시 여부" }, "coauthors": { "type": "array", "items": { "type": "string" }, "description": "공동 작성자 사용자명" }, "thumbnail_url": { "type": "string", "description": "썸네일 주소" }, "image_urls": { "type": "array", "items": { "type": "string" }, "description": "이미지 주소 목록" }, "video_url": { "type": "string", "description": "영상 주소. 없으면 빈 문자열" }, "author": { "type": "object", "properties": { "followers": { "type": "integer", "description": "작성자 팔로워 수" }, "is_verified": { "type": "boolean", "description": "작성자 인증 여부" }, "profile_url": { "type": "string", "description": "작성자 프로필 주소" } }, "description": "작성자 정보" } }, "description": "조회 데이터. 실패하면 error 에 안내 문구가 담깁니다." }, "api": { "type": "object", "properties": { "success": { "type": "boolean", "description": "API 서버 정상 응답 여부" }, "cost": { "type": "integer", "description": "차감된 포인트. 실패한 응답은 0" }, "pl_id": { "type": "integer", "description": "API 결제 로그 ID" }, "ms": { "type": "integer", "description": "API 응답 시간(밀리초)" } }, "description": "API 호출 공통 데이터" } } } ``` ### 정적 응답 예시 ```json { "data": { "url": "https://www.instagram.com/p/DeHufcWDCjf", "shortcode": "DeHufcWDCjf", "username": "natgeo", "caption": "Women in this Sardinian mountain village have high odds of living to 100...", "content_type": "Image", "posted_at": "2026-10-05T17:17:36.000Z", "likes": 35618, "comments": 246, "views": null, "duration_sec": null, "hashtags": [], "is_paid_partnership": false, "coauthors": [ "natgeoscience" ], "thumbnail_url": "https://scontent.cdninstagram.com/...", "image_urls": [ "https://scontent.cdninstagram.com/..." ], "video_url": "", "author": { "followers": 268000000, "is_verified": true, "profile_url": "https://www.instagram.com/natgeo" } }, "api": { "success": true, "cost": 10, "pl_id": 1595635, "ms": 18160 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/instagram_post' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'url=https://www.instagram.com/p/DeHufcWDCjf/' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("url", "https://www.instagram.com/p/DeHufcWDCjf/"); const response = await fetch("https://apick.app/rest/instagram_post", { method: "POST", headers: { Authorization: "Bearer " + process.env.APICK_API_KEY }, body: form, signal: AbortSignal.timeout(120_000), }); if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`); const result = await response.json(); console.log(result); ``` ### python ```python import os import requests parts = [ ("url", (None, "https://www.instagram.com/p/DeHufcWDCjf/")), ] response = requests.request("POST", "https://apick.app/rest/instagram_post", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php 'https://www.instagram.com/p/DeHufcWDCjf/', ]; $curl = curl_init('https://apick.app/rest/instagram_post'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => $headers, CURLOPT_POSTFIELDS => $form, CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120, ]); $body = curl_exec($curl); if ($body === false) { throw new RuntimeException(curl_error($curl)); } $status = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($status >= 400) { throw new RuntimeException($body); } $result = json_decode($body, true, 512, JSON_THROW_ON_ERROR); print_r($result); ``` ## 코드·오류 ## 상세 기능·요금 Method URL POST https://apick.app/rest/instagram_post 공개 게시물만 조회할 수 있습니다. 게시물은 보통 20초, 릴스는 40~50초가 걸립니다. 클라이언트 타임아웃을 100초 이상으로 설정해 주세요. 미디어 주소(image_urls, video_url)는 일정 시간이 지나면 만료됩니다. 필요하면 바로 내려받아 보관하세요. 실패한 호출(입력 오류, 시간 초과, 대상 없음)은 과금하지 않습니다. 같은 요청은 최대 10분 동안 같은 결과가 반환될 수 있습니다. API 호출 요청 요청하기 Key Value url 응답 ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. url String 게시물 주소 shortcode String 게시물 코드 username String 작성자 사용자명 caption String 캡션 content_type String Image · Video · Carousel · Reel posted_at String 게시 시각 (ISO 8601) likes Integer 좋아요 수. 숨김이면 null comments Integer 댓글 수 views Integer 조회수 (영상). 없으면 null duration_sec Number 영상 길이(초). 없으면 null hashtags Array 해시태그 is_paid_partnership Boolean 유료 광고 표시 여부 coauthors Array 공동 작성자 사용자명 thumbnail_url String 썸네일 주소 image_urls Array 이미지 주소 목록 video_url String 영상 주소. 없으면 빈 문자열 author Object 작성자 정보 followers Integer 작성자 팔로워 수 is_verified Boolean 작성자 인증 여부 profile_url String 작성자 프로필 주소 api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer 차감된 포인트. 실패한 응답은 0 ms Integer API 응답 시간(밀리초) pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "url": "https://www.instagram.com/p/DeHufcWDCjf", "shortcode": "DeHufcWDCjf", "username": "natgeo", "caption": "Women in this Sardinian mountain village have high odds of living to 100...", "content_type": "Image", "posted_at": "2026-10-05T17:17:36.000Z", "likes": 35618, "comments": 246, "views": null, "duration_sec": null, "hashtags": [], "is_paid_partnership": false, "coauthors": [ "natgeoscience" ], "thumbnail_url": "https://scontent.cdninstagram.com/...", "image_urls": [ "https://scontent.cdninstagram.com/..." ], "video_url": "", "author": { "followers": 268000000, "is_verified": true, "profile_url": "https://www.instagram.com/natgeo" } }, "api": { "success": true, "cost": 10, "pl_id": 1595635, "ms": 18160 } }