# X 프로필 조회 X(트위터) 공개 계정의 팔로워·팔로잉·게시물 수·소개·인증 여부와 최근 게시물의 반응 지표를 조회합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/x_profile 응답 필드 - `data` (object): 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. - `data.username` (string): 사용자명 - `data.name` (string): 표시 이름 - `data.biography` (string): 소개 - `data.followers` (integer): 팔로워 수 - `data.following` (integer): 팔로잉 수 - `data.posts_count` (integer): 게시물 수 - `data.is_verified` (boolean): 인증 여부 - `data.is_business_account` (boolean): 비즈니스 계정 여부 - `data.is_government_account` (boolean): 정부 계정 여부 - `data.location` (string): 프로필 위치 표기 - `data.website` (string): 프로필 링크 - `data.joined_at` (string): 가입 시각 (ISO 8601) - `data.profile_image_url` (string): 프로필 사진 - `data.banner_image_url` (string): 배너 이미지 - `data.profile_url` (string): 프로필 주소 - `data.recent_posts` (array): 최근 게시물 (최대 20개) - `data.recent_posts[].post_id` (string): 게시물 ID - `data.recent_posts[].url` (string): 게시물 주소 - `data.recent_posts[].text` (string): 본문 (최대 1,000자) - `data.recent_posts[].posted_at` (string): 작성 시각 - `data.recent_posts[].likes` (integer): 좋아요 수 - `data.recent_posts[].reposts` (integer): 리포스트 수 - `data.recent_posts[].replies` (integer): 답글 수 - `data.recent_posts[].views` (integer): 조회수 - `data.recent_posts[].hashtags` (array): 해시태그 - `api` (object): API 호출 공통 데이터 - `api.success` (boolean): API 서버 정상 응답 여부 - `api.cost` (integer): 차감된 포인트. 실패한 응답은 0 - `api.pl_id` (integer): API 결제 로그 ID - `api.ms` (integer): API 응답 시간(밀리초) ## API 요청: POST /rest/x_profile ### 입력 - `username` (string, 조건부): X 사용자명 (@ 없이도 가능, username 또는 url 중 하나 필수) - `url` (string, 조건부): X 프로필 주소 (예: https://x.com/NASA) ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "username": { "type": "string", "description": "사용자명" }, "name": { "type": "string", "description": "표시 이름" }, "biography": { "type": "string", "description": "소개" }, "followers": { "type": "integer", "description": "팔로워 수" }, "following": { "type": "integer", "description": "팔로잉 수" }, "posts_count": { "type": "integer", "description": "게시물 수" }, "is_verified": { "type": "boolean", "description": "인증 여부" }, "is_business_account": { "type": "boolean", "description": "비즈니스 계정 여부" }, "is_government_account": { "type": "boolean", "description": "정부 계정 여부" }, "location": { "type": "string", "description": "프로필 위치 표기" }, "website": { "type": "string", "description": "프로필 링크" }, "joined_at": { "type": "string", "description": "가입 시각 (ISO 8601)" }, "profile_image_url": { "type": "string", "description": "프로필 사진" }, "banner_image_url": { "type": "string", "description": "배너 이미지" }, "profile_url": { "type": "string", "description": "프로필 주소" }, "recent_posts": { "type": "array", "items": { "type": "object", "properties": { "post_id": { "type": "string", "description": "게시물 ID" }, "url": { "type": "string", "description": "게시물 주소" }, "text": { "type": "string", "description": "본문 (최대 1,000자)" }, "posted_at": { "type": "string", "description": "작성 시각" }, "likes": { "type": "integer", "description": "좋아요 수" }, "reposts": { "type": "integer", "description": "리포스트 수" }, "replies": { "type": "integer", "description": "답글 수" }, "views": { "type": "integer", "description": "조회수" }, "hashtags": { "type": "array", "items": { "type": "string" }, "description": "해시태그" } } }, "description": "최근 게시물 (최대 20개)" } }, "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": "NASA", "name": "NASA", "biography": "Making the seemingly impossible, possible.", "followers": 92374816, "following": 115, "posts_count": 74382, "is_verified": true, "is_business_account": false, "is_government_account": false, "location": "Pale Blue Dot", "website": "http://www.nasa.gov/", "joined_at": "2007-12-19T20:20:32.000Z", "profile_image_url": "https://pbs.twimg.com/profile_images/...", "banner_image_url": "https://pbs.twimg.com/profile_banners/...", "profile_url": "https://x.com/NASA", "recent_posts": [ { "post_id": "2107371838498054539", "url": "https://x.com/NASA/status/2107371838498054539", "text": "A strong start to #IAC2026 ...", "posted_at": "2026-10-06T07:26:14.000Z", "likes": 152, "reposts": 27, "replies": 5, "views": 41542, "hashtags": [ "IAC2026" ] } ] }, "api": { "success": true, "cost": 20, "pl_id": 1595635, "ms": 12180 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/x_profile' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'username=NASA' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("username", "NASA"); const response = await fetch("https://apick.app/rest/x_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, "NASA")), ] response = requests.request("POST", "https://apick.app/rest/x_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 'NASA', ]; $curl = curl_init('https://apick.app/rest/x_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/x_profile 실패한 호출(입력 오류, 시간 초과, 대상 없음)은 과금하지 않습니다. 공개 계정의 공개 정보만 제공합니다. 처리에 보통 10~20초가 걸립니다. 같은 요청은 최대 10분 동안 같은 결과가 반환될 수 있습니다. API 호출 요청 요청하기 Key Value username url 응답 ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. username String 사용자명 name String 표시 이름 biography String 소개 followers Integer 팔로워 수 following Integer 팔로잉 수 posts_count Integer 게시물 수 is_verified Boolean 인증 여부 is_business_account Boolean 비즈니스 계정 여부 is_government_account Boolean 정부 계정 여부 location String 프로필 위치 표기 website String 프로필 링크 joined_at String 가입 시각 (ISO 8601) profile_image_url String 프로필 사진 banner_image_url String 배너 이미지 profile_url String 프로필 주소 recent_posts Array 최근 게시물 (최대 20개) post_id String 게시물 ID url String 게시물 주소 text String 본문 (최대 1,000자) posted_at String 작성 시각 likes Integer 좋아요 수 reposts Integer 리포스트 수 replies Integer 답글 수 views Integer 조회수 hashtags Array 해시태그 api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer 차감된 포인트. 실패한 응답은 0 ms Integer API 응답 시간(밀리초) pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "username": "NASA", "name": "NASA", "biography": "Making the seemingly impossible, possible.", "followers": 92374816, "following": 115, "posts_count": 74382, "is_verified": true, "is_business_account": false, "is_government_account": false, "location": "Pale Blue Dot", "website": "http://www.nasa.gov/", "joined_at": "2007-12-19T20:20:32.000Z", "profile_image_url": "https://pbs.twimg.com/profile_images/...", "banner_image_url": "https://pbs.twimg.com/profile_banners/...", "profile_url": "https://x.com/NASA", "recent_posts": [ { "post_id": "2107371838498054539", "url": "https://x.com/NASA/status/2107371838498054539", "text": "A strong start to #IAC2026 ...", "posted_at": "2026-10-06T07:26:14.000Z", "likes": 152, "reposts": 27, "replies": 5, "views": 41542, "hashtags": [ "IAC2026" ] } ] }, "api": { "success": true, "cost": 20, "pl_id": 1595635, "ms": 12180 } }