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