# 링크드인 채용공고 조회 링크드인 채용공고 주소로 직무·회사·근무지·고용형태·경력수준·산업·공고 본문·게시일·지원자 수를 조회합니다. 인증: Authorization: Bearer $APICK_API_KEY 본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다. 인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다. ## POST /rest/linkedin_job 응답 필드 - `data` (object): 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. - `data.job_posting_id` (string): 공고 번호 - `data.title` (string): 직무명 - `data.company_name` (string): 회사명 - `data.company_id` (string): 회사 아이디 - `data.company_url` (string): 회사 페이지 주소 - `data.company_logo` (string): 회사 로고 주소 - `data.location` (string): 근무지 - `data.employment_type` (string): 고용 형태 - `data.seniority_level` (string): 경력 수준 - `data.industries` (string): 산업 - `data.summary` (string): 공고 요약 - `data.description_html` (string): 공고 본문(HTML) - `data.posted_time` (string): 게시 경과 표기 - `data.posted_date` (string): 게시 시각 (ISO 8601) - `data.applicants` (integer): 지원자 수 - `data.apply_link` (string): 지원 주소 - `data.is_easy_apply` (boolean): 간편 지원 여부 - `data.url` (string): 공고 주소 - `data.base_salary` (object): 급여 정보(있을 때만) - `data.salary_standards` (string): 급여 기준 - `api` (object): API 호출 공통 데이터 - `api.success` (boolean): API 서버 정상 응답 여부 - `api.cost` (integer): 차감된 포인트. 실패한 응답은 0 - `api.pl_id` (integer): API 결제 로그 ID - `api.ms` (integer): API 응답 시간(밀리초) ## API 요청: POST /rest/linkedin_job ### 입력 - `url` (string, 필수): 링크드인 채용공고 주소 (예: https://www.linkedin.com/jobs/view/{번호}) ### 응답 명세 ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "job_posting_id": { "type": "string", "description": "공고 번호" }, "title": { "type": "string", "description": "직무명" }, "company_name": { "type": "string", "description": "회사명" }, "company_id": { "type": "string", "description": "회사 아이디" }, "company_url": { "type": "string", "description": "회사 페이지 주소" }, "company_logo": { "type": "string", "description": "회사 로고 주소" }, "location": { "type": "string", "description": "근무지" }, "employment_type": { "type": "string", "description": "고용 형태" }, "seniority_level": { "type": "string", "description": "경력 수준" }, "industries": { "type": "string", "description": "산업" }, "summary": { "type": "string", "description": "공고 요약" }, "description_html": { "type": "string", "description": "공고 본문(HTML)" }, "posted_time": { "type": "string", "description": "게시 경과 표기" }, "posted_date": { "type": "string", "description": "게시 시각 (ISO 8601)" }, "applicants": { "type": "integer", "description": "지원자 수" }, "apply_link": { "type": "string", "description": "지원 주소" }, "is_easy_apply": { "type": "boolean", "description": "간편 지원 여부" }, "url": { "type": "string", "description": "공고 주소" }, "base_salary": { "type": "object", "description": "급여 정보(있을 때만)" }, "salary_standards": { "type": "string", "description": "급여 기준" } }, "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": { "job_posting_id": "4445916652", "title": "AI Engineer", "company_name": "Next Securities", "company_id": "105355907", "company_url": "https://kr.linkedin.com/company/next-securities", "company_logo": "https://media.licdn.com/...", "location": "Seoul, South Korea", "employment_type": "Full-time", "seniority_level": "Not Applicable", "industries": "Financial Services", "summary": "직무 Summary 넥스트증권과 함께 성장할 AI엔지니어 (경력) 담당자를 모집합니다.", "description_html": "...", "posted_time": "2 months ago", "posted_date": "2026-08-13T08:00:00.965Z", "applicants": 0, "apply_link": "", "is_easy_apply": false, "url": "https://www.linkedin.com/jobs/view/4445916652" }, "api": { "success": true, "cost": 30, "pl_id": 1595635, "ms": 4260 } } ``` ### curl ```curl curl --fail-with-body --request POST 'https://apick.app/rest/linkedin_job' \ --header "Authorization: Bearer $APICK_API_KEY" \ --form-string 'url=https://www.linkedin.com/jobs/view/4445916652' ``` ### Node.js (서버 ESM) ```javascript const form = new FormData(); form.append("url", "https://www.linkedin.com/jobs/view/4445916652"); const response = await fetch("https://apick.app/rest/linkedin_job", { 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 = [ ("url", (None, "https://www.linkedin.com/jobs/view/4445916652")), ] response = requests.request("POST", "https://apick.app/rest/linkedin_job", headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"]}, files=parts, timeout=(10, 120)) response.raise_for_status() result = response.json() print(result) ``` ### php ```php 'https://www.linkedin.com/jobs/view/4445916652', ]; $curl = curl_init('https://apick.app/rest/linkedin_job'); 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/linkedin_job 실패한 호출(입력 오류, 시간 초과, 대상 없음)은 과금하지 않습니다. 공개 채용공고 정보만 제공합니다. 보통 5~15초가 걸립니다. 최대 100초까지 기다립니다. 같은 요청은 최대 10분 동안 같은 결과가 반환될 수 있습니다. API 호출 요청 요청하기 Key Value url 응답 ## 상세 요청 Header 이름 필수 설명 Authorization O Bearer 인증키 ## 상세 응답 Body 이름 타입 설명 data Object 조회 데이터. 실패하면 error 에 안내 문구가 담깁니다. job_posting_id String 공고 번호 title String 직무명 company_name String 회사명 company_id String 회사 아이디 company_url String 회사 페이지 주소 company_logo String 회사 로고 주소 location String 근무지 employment_type String 고용 형태 seniority_level String 경력 수준 industries String 산업 summary String 공고 요약 description_html String 공고 본문(HTML) posted_time String 게시 경과 표기 posted_date String 게시 시각 (ISO 8601) base_salary Object 급여 정보(있을 때만) salary_standards String 급여 기준 applicants Integer 지원자 수 apply_link String 지원 주소 is_easy_apply Boolean 간편 지원 여부 url String 공고 주소 api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer 차감된 포인트. 실패한 응답은 0 ms Integer API 응답 시간(밀리초) pl_id Integer API 결제 로그 ID ## 상세 예제 요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "job_posting_id": "4445916652", "title": "AI Engineer", "company_name": "Next Securities", "company_id": "105355907", "company_url": "https://kr.linkedin.com/company/next-securities", "company_logo": "https://media.licdn.com/...", "location": "Seoul, South Korea", "employment_type": "Full-time", "seniority_level": "Not Applicable", "industries": "Financial Services", "summary": "직무 Summary 넥스트증권과 함께 성장할 AI엔지니어 (경력) 담당자를 모집합니다.", "description_html": "...", "posted_time": "2 months ago", "posted_date": "2026-08-13T08:00:00.965Z", "applicants": 0, "apply_link": "", "is_easy_apply": false, "url": "https://www.linkedin.com/jobs/view/4445916652" }, "api": { "success": true, "cost": 30, "pl_id": 1595635, "ms": 4260 } }