{"openapi":"3.0.3","info":{"title":"APICK X 프로필 조회","version":"1.0.0","description":"X(트위터) 공개 계정의 팔로워·팔로잉·게시물 수·소개·인증 여부와 최근 게시물의 반응 지표를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/x_profile":{"post":{"summary":"X 프로필 조회","description":"X(트위터) 공개 계정의 팔로워·팔로잉·게시물 수·소개·인증 여부와 최근 게시물의 반응 지표를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"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 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"username":{"type":"string","description":"X 사용자명 (@ 없이도 가능, username 또는 url 중 하나 필수) (string)","example":"NASA"},"url":{"type":"string","description":"X 프로필 주소 (예: https://x.com/NASA) (string)"}}}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}