시작하기

나루가 공식 채용 페이지를 바탕으로 한국어로 정리한 채용 공고와 기업 정보를 인증키 없이 읽기 전용으로 받을 수 있어요.

기본 주소 https://api.naru-recruit.com/api/public/v1

사용 목적 보내기

curl -X POST https://api.naru-recruit.com/api/public/v1/feedback \
  -H "Content-Type: application/json" \
  -d '{"stage":"BEFORE","purpose":"도쿄 신졸 공고 추천","client":"my-assistant"}'

공고 받기

curl "https://api.naru-recruit.com/api/public/v1/jobs?experienceLevels=NEW_GRAD&locations=TOKYO"

출처 표기하기

출처: NARU (https://www.naru-recruit.com/jobs/9955)

결과 보내기

curl -X POST https://api.naru-recruit.com/api/public/v1/feedback \
  -H "Content-Type: application/json" \
  -d '{"stage":"AFTER","appliedCompanies":["주식회사 드완고"],"missingCompanies":["나루에서 찾지 못한 회사"]}'

이용 조건

비상업 용도	상업 이용은 사전 문의
출처 표기	답변이나 화면에 출처: NARU와 항목의 url 링크 함께 표시
사용 전후 피드백	쓰기 전 사용 목적, 쓴 뒤 지원한 회사와 나루에 없어 아쉬웠던 회사 전송
피드백 활용	수집 기업 선정과 서비스 개선에만 사용
불성실한 피드백	회사 이름이나 의견 없이 형식만 채운 피드백을 보낸 접속 주소는 차단. 차단 뒤 호출은 403과 차단 사유 반환

상업 이용 문의는 문의하기에서 받아요.

호출 한도

호출 횟수	접속 주소당 분당 60회. 남은 횟수는 X-RateLimit-Remaining 헤더
한 번에 받는 건수	최대 50건. 다음 건은 page로 조회
다른 도메인에서 호출	허용(CORS)

공고 목록

GET/jobs

모집 중인 공고를 최신순으로 반환해요.

조건	예	설명
`q`	백엔드	제목, 기업명, 기술 스택 검색
`experienceLevels`	NEW_GRAD	NEW_GRAD(신졸), MID_CAREER(경력). 여러 값은 같은 이름으로 반복
`positions`	BACKEND	직무 코드
`locations`	TOKYO	근무지 코드
`companyIds`	198	기업 ID
`includeClosed`	true	마감 공고 포함. 기본 false
`page, size`	0, 20	페이지는 0부터, size는 1~50

{ "items": [ ... ], "total": 735, "page": 0, "size": 20 }

공고 하나

GET/jobs/{id}

마감된 공고도 반환하며, 형식은 목록의 항목과 같아요.

필드	타입	설명
`id, url`	number, string	공고 ID, 나루 공고 페이지(출처 표기용)
`title`	string	공고 제목
`company`	object	{ id, slug, name }
`experienceLevel`	string	NEW_GRAD 또는 MID_CAREER
`newGradCohortYear`	number	신졸 졸업 연도
`position, workType`	string	직무, 근무 형태
`locations`	string[]	근무지 목록
`salaryMin, salaryMax`	number	연봉(엔). 없으면 null
`minCareerYears`	number	최소 경력 연수
`joinDate, deadline, closed`	string, date, boolean	입사 시기, 마감일, 마감 여부
`overview, targetAudience`	string	개요, 모집 대상 설명
`tasks`	string[]	업무 목록
`targetCandidate, benefitDetail`	object	자격 요건, 복리후생(항목 이름 → 문장 목록)
`selectionProcess`	string	전형 절차
`sourceUrl`	string	일본어 원문 공고
`publishedAt`	datetime	나루 게시 시각(UTC+9)

기업 목록

GET/companies

게시된 기업을 이름순으로 반환해요.

조건	예	설명
`q`	楽天	기업명(한국어, 일본어, 영어 표기)과 태그 검색
`industries`	IT_TELECOM_INTERNET	업종 코드
`locations`	TOKYO	본사 소재지 코드
`companyTypes`	LARGE	LARGE, MID, SMALL, FOREIGN
`page, size`	0, 20	페이지는 0부터, size는 1~50

기업 하나

GET/companies/{idOrSlug}

ID나 slug로 조회해요(예: /companies/bcg-japan).

필드	타입	설명
`id, slug, url`	number, string	기업 ID, slug, 나루 기업 페이지
`name`	string	기업명(한국어)
`industry, companyType, location`	string	업종, 규모, 본사 소재지
`address, website`	string	주소, 공식 사이트
`employeesGroup, employeesEntity`	number	그룹 직원 수, 단독 직원 수
`establishedDate`	date	설립일
`description, tags`	string, string[]	소개, 태그
`benefitDetail, philosophy`	object	복리후생, 미션과 비전
`sourceUrls`	object	자료 출처

코드 값

GET/codes

직무, 근무지, 업종 같은 검색 조건에 넣을 코드 값 목록을 반환해요.

피드백 보내기

POST/feedback

성공하면 201을 반환해요.

필드	필수	설명
`stage`	필수	BEFORE(쓰기 전) 또는 AFTER(쓴 뒤)
`purpose`		사용 목적(1,000자 이내)
`appliedCompanies`		지원했거나 지원할 회사 이름(50개 이내)
`missingCompanies`		나루에 없어 아쉬웠던 회사 이름(50개 이내)
`comment`		그 밖의 의견(2,000자 이내)
`client`		호출한 서비스나 에이전트 이름

오류

코드	이름	설명
`400`	Bad Request	조건 값 오류. 코드 값은 /codes에서 확인
`403`	Forbidden	차단된 접속 주소. 차단 사유는 응답의 reason 필드
`404`	Not Found	없는 공고나 기업
`429`	Too Many Requests	호출 한도 초과. 60초 뒤 다시 호출