{"openapi":"3.0.3","info":{"title":"APICK 인스타그램 프로필 조회","version":"1.0.0","description":"인스타그램 공개 계정의 팔로워·팔로잉·게시물 수·소개·인증 여부와 최근 게시물 12개를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/instagram_profile":{"post":{"summary":"인스타그램 프로필 조회","description":"인스타그램 공개 계정의 팔로워·팔로잉·게시물 수·소개·인증 여부와 최근 게시물 12개를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"username":{"type":"string","description":"사용자명"},"full_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_private":{"type":"boolean","description":"비공개 계정 여부"},"external_urls":{"type":"array","items":{"type":"string"},"description":"프로필 외부 링크"},"highlights_count":{"type":"integer","description":"하이라이트 수"},"profile_image_url":{"type":"string","description":"프로필 사진 주소"},"profile_url":{"type":"string","description":"프로필 주소"},"recent_posts":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"게시물 주소"},"content_type":{"type":"string","description":"Image · Video · Carousel"},"caption":{"type":"string","description":"캡션 (최대 500자)"},"posted_at":{"type":"string","description":"게시 시각 (ISO 8601)"},"image_url":{"type":"string","description":"대표 이미지 주소"},"hashtags":{"type":"array","items":{},"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":"natgeo"},"url":{"type":"string","description":"인스타그램 프로필 주소 (예: https://www.instagram.com/natgeo/) (string)"}}}}}}}}},"x-code-tables":[{"title":"HTTP 상태 코드","columns":["HTTP","상황","설명"],"rows":[["400","입력 오류","username과 url이 모두 없거나 사용자명·프로필 주소 형식이 아닙니다. 과금되지 않습니다."],["404","계정 없음","없는 계정이거나 주소가 잘못됐습니다. 과금되지 않습니다."],["408","시간 초과","제한 시간 안에 결과를 받지 못했습니다. 잠시 후 다시 요청하세요. 과금되지 않습니다."],["424","조회 실패","결과를 받지 못해 실패로 끝났습니다. 잠시 후 다시 요청하세요. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}