# 틱톡 프로필 조회 틱톡 공개 계정의 팔로워·좋아요·영상 수·소개와 최근 인기 영상의 조회수·반응 지표를 조회합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/tiktok_profile 응답 필드 - `data` (object): 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. - `data.username` (string): 사용자명 - `data.nickname` (string): 표시 이름 - `data.biography` (string): 소개 - `data.followers` (integer): 팔로워 수 - `data.following` (integer): 팔로잉 수 - `data.likes` (integer): 받은 좋아요 합계 - `data.videos_count` (integer): 영상 수 - `data.is_verified` (boolean): 인증 계정 여부 - `data.is_private` (boolean): 비공개 계정 여부 - `data.bio_link` (string): 프로필 링크. 없으면 빈 문자열 - `data.engagement_rate` (number): 평균 참여율 (0~1) - `data.created_at` (string): 계정 생성 시각 (ISO 8601) - `data.profile_image_url` (string): 프로필 사진 주소 - `data.profile_url` (string): 프로필 주소 - `data.recent_videos` (array): 최근 인기 영상 (최대 12개) - `data.recent_videos[].video_id` (string): 영상 ID - `data.recent_videos[].url` (string): 영상 주소 - `data.recent_videos[].views` (integer): 조회수 - `data.recent_videos[].likes` (integer): 좋아요 수 - `data.recent_videos[].comments` (integer): 댓글 수 - `data.recent_videos[].shares` (integer): 공유 수 - `data.recent_videos[].posted_at` (string): 게시 시각 (ISO 8601) - `data.recent_videos[].cover_image_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/tiktok_profile ### 입력 - `username` (string, 조건부): 틱톡 사용자명 (@ 없이도 가능, username 또는 url 중 하나 필수) - `url` (string, 조건부): 틱톡 프로필 주소 (예: https://www.tiktok.com/@tiktok) ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "username": { "type": "string", "description": "사용자명" }, "nickname": { "type": "string", "description": "표시 이름" }, "biography": { "type": "string", "description": "소개" }, "followers": { "type": "integer", "description": "팔로워 수" }, "following": { "type": "integer", "description": "팔로잉 수" }, "likes": { "type": "integer", "description": "받은 좋아요 합계" }, "videos_count": { "type": "integer", "description": "영상 수" }, "is_verified": { "type": "boolean", "description": "인증 계정 여부" }, "is_private": { "type": "boolean", "description": "비공개 계정 여부" }, "bio_link": { "type": "string", "description": "프로필 링크. 없으면 빈 문자열" }, "engagement_rate": { "type": "number", "description": "평균 참여율 (0~1)" }, "created_at": { "type": "string", "description": "계정 생성 시각 (ISO 8601)" }, "profile_image_url": { "type": "string", "description": "프로필 사진 주소" }, "profile_url": { "type": "string", "description": "프로필 주소" }, "recent_videos": { "type": "array", "items": { "type": "object", "properties": { "video_id": { "type": "string", "description": "영상 ID" }, "url": { "type": "string", "description": "영상 주소" }, "views": { "type": "integer", "description": "조회수" }, "likes": { "type": "integer", "description": "좋아요 수" }, "comments": { "type": "integer", "description": "댓글 수" }, "shares": { "type": "integer", "description": "공유 수" }, "posted_at": { "type": "string", "description": "게시 시각 (ISO 8601)" }, "cover_image_url": { "type": "string", "description": "표지 이미지 주소" } } }, "description": "최근 인기 영상 (최대 12개)" } }, "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": { "username": "tiktok", "nickname": "TikTok", "biography": "Your next discovery is waiting on TikTok.", "followers": 96100000, "following": 1, "likes": 465100000, "videos_count": 1510, "is_verified": true, "is_private": false, "bio_link": "", "engagement_rate": 0.00018, "created_at": "2015-02-28T17:22:29.000Z", "profile_image_url": "https://p19-common-sign.tiktokcdn-us.com/...", "profile_url": "https://www.tiktok.com/@tiktok", "recent_videos": [ { "video_id": "7693184538704416031", "url": "https://www.tiktok.com/@tiktok/video/7693184538704416031", "views": 72200, "likes": 3470, "comments": 593, "shares": 309, "posted_at": "2026-10-05T14:05:49.000Z", "cover_image_url": "https://p16-common-sign.tiktokcdn-us.com/..." } ] }, "api": { "success": true, "cost": 20, "pl_id": 1595635, "ms": 26990 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/tiktok_profile' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'username=tiktok' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("username", "tiktok"); const response = await fetch("https://apick.app/rest/tiktok_profile", { 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 = [ ("username", (None, "tiktok")), ] response = requests.request("POST", "https://apick.app/rest/tiktok_profile", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php 'tiktok', ]; $curl = curl_init('https://apick.app/rest/tiktok_profile'); 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/tiktok_profile 공개 계정의 공개 정보만 제공합니다. 처리에 보통 30초 안팎이 걸립니다. 클라이언트 타임아웃을 100초 이상으로 설정해 주세요. 실패한 호출(입력 오류, 시간 초과, 대상 없음)은 과금하지 않습니다. 같은 요청은 최대 10분 동안 같은 결과가 반환될 수 있습니다. API 호출 요청 요청하기 Key Value username url 응답 ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. username String 사용자명 nickname String 표시 이름 biography String 소개 followers Integer 팔로워 수 following Integer 팔로잉 수 likes Integer 받은 좋아요 합계 videos_count Integer 영상 수 is_verified Boolean 인증 계정 여부 is_private Boolean 비공개 계정 여부 bio_link String 프로필 링크. 없으면 빈 문자열 engagement_rate Number 평균 참여율 (0~1) created_at String 계정 생성 시각 (ISO 8601) profile_image_url String 프로필 사진 주소 profile_url String 프로필 주소 recent_videos Array 최근 인기 영상 (최대 12개) video_id String 영상 ID url String 영상 주소 views Integer 조회수 likes Integer 좋아요 수 comments Integer 댓글 수 shares Integer 공유 수 posted_at String 게시 시각 (ISO 8601) cover_image_url String 표지 이미지 주소 api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer 차감된 포인트. 실패한 응답은 0 ms Integer API 응답 시간(밀리초) pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "username": "tiktok", "nickname": "TikTok", "biography": "Your next discovery is waiting on TikTok.", "followers": 96100000, "following": 1, "likes": 465100000, "videos_count": 1510, "is_verified": true, "is_private": false, "bio_link": "", "engagement_rate": 0.00018, "created_at": "2015-02-28T17:22:29.000Z", "profile_image_url": "https://p19-common-sign.tiktokcdn-us.com/...", "profile_url": "https://www.tiktok.com/@tiktok", "recent_videos": [ { "video_id": "7693184538704416031", "url": "https://www.tiktok.com/@tiktok/video/7693184538704416031", "views": 72200, "likes": 3470, "comments": 593, "shares": 309, "posted_at": "2026-10-05T14:05:49.000Z", "cover_image_url": "https://p16-common-sign.tiktokcdn-us.com/..." } ] }, "api": { "success": true, "cost": 20, "pl_id": 1595635, "ms": 26990 } }