apick-api 4.4.0 → 4.8.1

package/README.md

@@ -64,6 +64,7 @@ Leave the allowed-IP list blank for unrestricted access. To restrict access, reg
 | `validatePhone(number)` | 전화번호 유효성 / Phone validation | JSON |
 | `holidays(year, month)` | 대한민국 공휴일 / Korean holidays | JSON |
 | `searchAddress(query, options)` | 도로명주소 검색 / Road address search | JSON |
+| `vehicleModelInfo(options)` | 차종별 차량정보 조회 / Vehicle model specifications for cars and motorcycles/scooters (승용차·이륜차 / 표기가 달라도 가장 비슷한 차종 / closest match when spelled differently · 값은 표준 표기 / standard notation values) | JSON |
 | `ocr(image, options)` | 이미지 OCR / Image OCR | JSON |
 | `dnsLookup(domain)` | DNS 조회 / DNS lookup | JSON |
 | `geolocate(address)` | 도메인·IP 위치 / Domain and IP location | JSON |
@@ -90,14 +91,11 @@ Leave the allowed-IP list blank for unrestricted access. To restrict access, reg
 | `amazonProduct(urlOrAsin)` | 아마존 상품 정보 / Amazon product | JSON |
 | `xProfile(usernameOrUrl)` | X 공개 프로필·최근 게시물 / X public profile and recent posts | JSON |
 | `xPost(url)` | X 게시물 / X post | JSON |
-| `createInstagramPostsJob(usernameOrUrl, options)` | 인스타그램 게시물 목록 수집 접수(최대 100) / Instagram posts job | JSON |
-| `createInstagramCommentsJob(url, options)` | 인스타그램 댓글 수집 접수(최대 15) / Instagram comments job | JSON |
-| `createTiktokSearchJob(keyword, options)` | 틱톡 키워드 영상 검색 접수(최대 50) / TikTok keyword search job | JSON |
-| `createTiktokVideoJob(url, options)` | 틱톡 영상 정보 접수 / TikTok video job | JSON |
-| `createTiktokCommentsJob(url, options)` | 틱톡 댓글 수집 접수(최대 100) / TikTok comments job | JSON |
-| `createAmazonReviewsJob(urlOrAsin, options)` | 아마존 리뷰 수집 접수(최대 100) / Amazon reviews job | JSON |
-| `createGoogleMapsPlaceJob(placeIdOrUrl, options)` | 구글 지도 장소 상세·별점 분포·대표 리뷰 접수 / Google Maps place details and top reviews job | JSON |
-| `getScrapeJob(jobId)` / `waitForScrapeJob(jobId, options)` | 수집 작업 상태·결과(무료, 결과 건수로 정산) / Collection job status and results | JSON |
+| `coupangProduct(urlOrProductId)` | 쿠팡 상품 정보 / Coupang product | JSON |
+| `naverShoppingProduct(url)` | 네이버 브랜드스토어 상품 정보 / Naver brand store product | JSON |
+| `linkedinProfile(url)` | 링크드인 프로필 / LinkedIn profile | JSON |
+| `linkedinCompany(url)` | 링크드인 회사 정보 / LinkedIn company | JSON |
+| `linkedinJob(url)` | 링크드인 채용공고 / LinkedIn job posting | JSON |
 | `createTtsJob(text, options)` | 한국어 내레이션 작업 접수 / Create TTS job | JSON |
 | `getTtsJob(jobId)` | TTS 작업 상태 / TTS job status | JSON |
 | `cancelTtsJob(jobId)` | 대기·생성 중 TTS 작업 취소 / Cancel waiting or processing TTS job | JSON |
@@ -120,6 +118,8 @@ Leave the allowed-IP list blank for unrestricted access. To restrict access, reg
 | `requestEmployment(input)` / `getEmployment(transactionId)` | 재직·보험료 확인 / Employment & insurance premium check | JSON |
 | `requestPersonalIncome(input)` / `getPersonalIncome(transactionId)` | 금융소득(이자·배당) 조회 / Financial income (interest/dividend) | JSON |
 | `requestNpsJoinHistory(input)` / `getNpsJoinHistory(transactionId)` | 국민연금 가입내역조회 / National Pension join history | JSON |
+| `requestNpsDeductionCert(input)` / `getNpsDeductionCert(transactionId)` | 국민연금 소득공제용 납부확인서 / National Pension payment certificate for income deduction | JSON |
+| `requestNpsCareerHistory(input)` / `getNpsCareerHistory(transactionId)` | 국민연금 경력 이력 조회 / National Pension career history | JSON |
 | `requestDrivingLicense(input)` / `getDrivingLicense(transactionId)` | 운전면허 조회 / Driver's license check | JSON |
 | `requestHealthCheckup(input)` / `getHealthCheckup(transactionId)` | 국가 건강검진 결과 조회 / National health checkup results | JSON |
 | `requestCashReceiptDeduction(input)` / `getCashReceiptDeduction(transactionId)` | 현금영수증 소득공제 내역 / Cash receipt income deductions | JSON |
@@ -405,6 +405,8 @@ Acceptance is billed at a flat rate; the result is billed only on its first succ
 | 재직·보험료 확인 / Employment & insurance premium | `requestEmployment` / `getEmployment` | `insuranceYears` (1–3) |
 | 금융소득 조회 / Financial income | `requestPersonalIncome` / `getPersonalIncome` | `incomeYears` (1–5) |
 | 국민연금 가입내역 / NPS join history | `requestNpsJoinHistory` / `getNpsJoinHistory` | `from`, `to` (`YYYY-MM`) |
+| 국민연금 소득공제용 납부확인서 / NPS payment certificate | `requestNpsDeductionCert` / `getNpsDeductionCert` | `years` (1–5) |
+| 국민연금 경력 이력 / NPS career history | `requestNpsCareerHistory` / `getNpsCareerHistory` | `from`, `to` (`YYYY-MM`) |
 | 운전면허 조회 / Driver's license | `requestDrivingLicense` / `getDrivingLicense` | — |
 | 국가 건강검진 결과 / Health checkup | `requestHealthCheckup` / `getHealthCheckup` | — |
 | 현금영수증 소득공제 내역 / Cash receipt deductions | `requestCashReceiptDeduction` / `getCashReceiptDeduction` | `incomeYears` (1–3) |

package/docs/guide.en.md

@@ -84,28 +84,14 @@ const post = await client.instagramPost('https://www.instagram.com/p/DeHufcWDCjf
 const tiktok = await client.tiktokProfile('https://www.tiktok.com/@tiktok');
 const product = await client.amazonProduct('B0BDHWDR12');
 const x = await client.xProfile('NASA');
+const coupang = await client.coupangProduct('https://www.coupang.com/vp/products/7812020679');
+const naver = await client.naverShoppingProduct('https://brand.naver.com/pulmuonebynature/products/4995061380');
+const profile = await client.linkedinProfile('https://www.linkedin.com/in/example/');
+const company = await client.linkedinCompany('https://www.linkedin.com/company/example/');
+const job = await client.linkedinJob('https://www.linkedin.com/jobs/view/4001234567/');
 ```
 
-### Collection jobs (lists, comments, search, reviews)
-
-Products that collect many items return a `job_id` immediately. Submitting reserves `maxResults` × unit price; when you read the result, only the results actually returned are charged and the rest is refunded. Failed jobs and missing targets are fully refunded, and results are kept for 72 hours. Comment and review authors are public usernames only.
-
-```js
-const job = await client.createTiktokSearchJob('camping recipes', { maxResults: 10, idempotencyKey: 'camping-0001' });
-const done = await client.waitForScrapeJob(job.data.job_id); // every 10 s, up to 10 min
-console.log(done.data.status, done.data.charged_point, done.data.items);
-```
-
-Result-billed collection jobs are charged per result; from 2026-11-06 a job with at least one result has a base fee (10 points, Instagram comments 50). Jobs with no results or failures are fully refunded.
-
-For a Google Maps place, pass the `place_id` from `googleMapsSearch` to get details, the star distribution and top reviews (up to 10). 20 points per place; text is returned in English.
-
-```js
-const places = await client.googleMapsSearch('cafes near Gangnam station');
-const placeJob = await client.createGoogleMapsPlaceJob(places.data.items[0].place_id);
-const place = await client.waitForScrapeJob(placeJob.data.job_id);
-console.log(place.data.items[0].rating_distribution, place.data.items[0].top_reviews);
-```
+Coupang accepts a product number or a product URL (`/vp/products/{id}`), and Naver accepts a brand store product URL (`brand.naver.com/{store}/products/{id}`). LinkedIn accepts profile (`/in/`), company (`/company/`) and job posting (`/jobs/view/`) URLs.
 
 ## OCR
 
@@ -318,7 +304,7 @@ try {
 
 Sources: [APICK development guide](https://apick.app/dev_guide/data_health_checkup) · [MCP 3.5.0 status contract](https://github.com/lead788/apick-mcp/blob/a803abcb81d07377c85f49bb0b670baf0c17ed04/TOOLS.md)
 
-`authProvider` is one of the 13 values in `AUTH_PROVIDERS` (kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad). Acceptance is billed at a flat rate; the result is billed only on its first return and free to re-poll afterward. `requestEmployment` takes an optional `insuranceYears` (1-3), `requestPersonalIncome` takes `incomeYears` (1-5), and `requestNpsJoinHistory` takes optional `from`/`to` (`YYYY-MM`). `requestCashReceiptDeduction` takes optional `incomeYears` (1-3) and `requestTaxReturnHistory` takes optional `years` (1-10). The remaining products are `requestDrivingLicense` and `requestHealthCheckup`.
+`authProvider` is one of the 13 values in `AUTH_PROVIDERS` (kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad). Acceptance is billed at a flat rate; the result is billed only on its first return and free to re-poll afterward. `requestEmployment` takes an optional `insuranceYears` (1-3), `requestPersonalIncome` takes `incomeYears` (1-5), and `requestNpsJoinHistory` takes optional `from`/`to` (`YYYY-MM`). `requestNpsDeductionCert` takes optional `years` (1-5) and `requestNpsCareerHistory` takes optional `from`/`to` (`YYYY-MM`). `requestCashReceiptDeduction` takes optional `incomeYears` (1-3) and `requestTaxReturnHistory` takes optional `years` (1-10). The remaining products are `requestDrivingLicense` and `requestHealthCheckup`.
 
 ## Skills
 

package/docs/guide.ko.md

@@ -84,28 +84,14 @@ const post = await client.instagramPost('https://www.instagram.com/p/DeHufcWDCjf
 const tiktok = await client.tiktokProfile('https://www.tiktok.com/@tiktok');
 const product = await client.amazonProduct('B0BDHWDR12');
 const x = await client.xProfile('NASA');
+const coupang = await client.coupangProduct('https://www.coupang.com/vp/products/7812020679');
+const naver = await client.naverShoppingProduct('https://brand.naver.com/pulmuonebynature/products/4995061380');
+const profile = await client.linkedinProfile('https://www.linkedin.com/in/example/');
+const company = await client.linkedinCompany('https://www.linkedin.com/company/example/');
+const job = await client.linkedinJob('https://www.linkedin.com/jobs/view/4001234567/');
 ```
 
-### 수집 작업(목록·댓글·검색·리뷰)
-
-여러 건을 모으는 상품은 접수 즉시 `job_id` 를 돌려줍니다. 접수 때 `maxResults` × 단가를 예약하고, 결과를 받을 때 실제 결과 건수만 차감한 뒤 나머지는 돌려드립니다. 실패하거나 대상이 없으면 전액 환불되며 결과는 72시간 보관합니다. 댓글·리뷰 작성자는 공개 사용자명만 제공합니다.
-
-```js
-const job = await client.createTiktokSearchJob('캠핑 요리', { maxResults: 10, idempotencyKey: 'camping-0001' });
-const done = await client.waitForScrapeJob(job.data.job_id); // 기본 10초 간격, 최대 10분
-console.log(done.data.status, done.data.charged_point, done.data.items);
-```
-
-결과 건수 과금 수집 작업은 결과 1건당 단가로 정산하며, 2026-11-06부터 결과가 1건 이상이면 작업당 기본요금(10P, 인스타그램 댓글 50P)을 최소액으로 받습니다. 결과가 없거나 실패하면 예약한 포인트를 모두 돌려드립니다.
-
-구글 지도 장소는 `googleMapsSearch` 결과의 `place_id` 로 상세·별점 분포·대표 리뷰(최대 10건)를 받습니다. 건당 20포인트이고 텍스트는 영어로 제공합니다.
-
-```js
-const places = await client.googleMapsSearch('강남역 카페');
-const placeJob = await client.createGoogleMapsPlaceJob(places.data.items[0].place_id);
-const place = await client.waitForScrapeJob(placeJob.data.job_id);
-console.log(place.data.items[0].rating_distribution, place.data.items[0].top_reviews);
-```
+쿠팡은 상품 번호나 상품 주소(`/vp/products/{번호}`)를, 네이버는 브랜드스토어 상품 주소(`brand.naver.com/{스토어}/products/{번호}`)를 받습니다. 링크드인은 프로필(`/in/`)·회사(`/company/`)·채용공고(`/jobs/view/`) 주소를 받습니다.
 
 ## OCR
 
@@ -321,7 +307,7 @@ try {
 
 근거: [APICK 개발가이드](https://apick.app/dev_guide/data_health_checkup) · [MCP 3.5.0 상태 계약](https://github.com/lead788/apick-mcp/blob/a803abcb81d07377c85f49bb0b670baf0c17ed04/TOOLS.md)
 
-`authProvider`는 `AUTH_PROVIDERS`(13종: kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad) 중 하나입니다. 접수는 정액 과금, 결과는 최초 반환에서만 과금되며 재조회는 무료입니다. `requestEmployment`는 `insuranceYears`(1~3), `requestPersonalIncome`은 `incomeYears`(1~5), `requestNpsJoinHistory`는 `from`/`to`(`YYYY-MM`) 선택 입력을 받습니다. `requestCashReceiptDeduction`은 `incomeYears`(1~3), `requestTaxReturnHistory`는 `years`(1~10) 선택 입력을 받습니다. 나머지 상품은 `requestDrivingLicense`, `requestHealthCheckup`입니다.
+`authProvider`는 `AUTH_PROVIDERS`(13종: kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad) 중 하나입니다. 접수는 정액 과금, 결과는 최초 반환에서만 과금되며 재조회는 무료입니다. `requestEmployment`는 `insuranceYears`(1~3), `requestPersonalIncome`은 `incomeYears`(1~5), `requestNpsJoinHistory`는 `from`/`to`(`YYYY-MM`) 선택 입력을 받습니다. `requestNpsDeductionCert`는 `years`(1~5), `requestNpsCareerHistory`는 `from`/`to`(`YYYY-MM`) 선택 입력을 받습니다. `requestCashReceiptDeduction`은 `incomeYears`(1~3), `requestTaxReturnHistory`는 `years`(1~10) 선택 입력을 받습니다. 나머지 상품은 `requestDrivingLicense`, `requestHealthCheckup`입니다.
 
 ## Skills
 

package/package.json

@@ -1,71 +1,71 @@
-{
-  "name": "apick-api",
-  "version": "4.4.0",
-  "description": "Official zero-dependency Node.js client for APICK data, AI, and image APIs. 에이픽 데이터·AI·이미지 API 공식 Node.js SDK.",
-  "type": "module",
-  "main": "./src/index.cjs",
-  "module": "./src/index.js",
-  "types": "./src/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./src/index.d.ts",
-      "import": "./src/index.js",
-      "require": "./src/index.cjs"
-    }
-  },
-  "files": [
-    "src",
-    "docs",
-    "examples",
-    "README.md",
-    "CHANGELOG.md",
-    "SECURITY.md",
-    "LICENSE"
-  ],
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "test": "node --test && npm run test:types",
-    "test:types": "tsc -p tsconfig.json",
-    "test:coverage": "node --test --experimental-test-coverage",
-    "prepublishOnly": "npm test"
-  },
-  "devDependencies": {
-    "typescript": "^7.0.2"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/lead788/apick-api.git"
-  },
-  "bugs": {
-    "url": "https://github.com/lead788/apick-api/issues"
-  },
-  "homepage": "https://apick.app/dev_guide",
-  "license": "MIT",
-  "author": "APICK",
-  "publishConfig": {
-    "access": "public",
-    "provenance": false
-  },
-  "keywords": [
-    "apick",
-    "api",
-    "sdk",
-    "korea",
-    "korean-api",
-    "business-registry",
-    "parcel-tracking",
-    "address",
-    "ocr",
-    "whois",
-    "dns",
-    "google-search",
-    "pdf",
-    "excel",
-    "tts-jobs",
-    "text-summary",
-    "image-generation"
-  ]
-}
+{
+  "name": "apick-api",
+  "version": "4.8.1",
+  "description": "Official zero-dependency Node.js client for APICK data, AI, and image APIs. 에이픽 데이터·AI·이미지 API 공식 Node.js SDK.",
+  "type": "module",
+  "main": "./src/index.cjs",
+  "module": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "require": "./src/index.cjs"
+    }
+  },
+  "files": [
+    "src",
+    "docs",
+    "examples",
+    "README.md",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test && npm run test:types",
+    "test:types": "tsc -p tsconfig.json",
+    "test:coverage": "node --test --experimental-test-coverage",
+    "prepublishOnly": "npm test"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lead788/apick-api.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lead788/apick-api/issues"
+  },
+  "homepage": "https://apick.app/dev_guide",
+  "license": "MIT",
+  "author": "APICK",
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "keywords": [
+    "apick",
+    "api",
+    "sdk",
+    "korea",
+    "korean-api",
+    "business-registry",
+    "parcel-tracking",
+    "address",
+    "ocr",
+    "whois",
+    "dns",
+    "google-search",
+    "pdf",
+    "excel",
+    "tts-jobs",
+    "text-summary",
+    "image-generation"
+  ]
+}

package/src/index.cjs

@@ -26,6 +26,7 @@ const SERVICE_DEFINITIONS = Object.freeze({
 	validatePhone: { endpoint: '/rest/check_phone_valid', timeoutMs: 20_000, output: 'json' },
 	holidays: { endpoint: '/rest/holiday_info', timeoutMs: 35_000, output: 'json' },
 	searchAddress: { endpoint: '/rest/search_juso', timeoutMs: 20_000, output: 'json' },
+	vehicleModelInfo: { endpoint: '/rest/vehicle_model_info', timeoutMs: 20_000, output: 'json' },
 	ocr: { endpoint: '/rest/ocr', timeoutMs: 35_000, output: 'json' },
 	maskResidentNumber: { endpoint: '/rest/hide_rrn', timeoutMs: 35_000, output: 'binary', filename: 'masked.png' },
 	maskResidenceCard: { endpoint: '/rest/identity_document_residence_card', timeoutMs: 35_000, output: 'json' },
@@ -47,7 +48,11 @@ const SERVICE_DEFINITIONS = Object.freeze({
 	amazonProduct: { endpoint: '/rest/amazon_product', timeoutMs: 110_000, output: 'json' },
 	xProfile: { endpoint: '/rest/x_profile', timeoutMs: 110_000, output: 'json' },
 	xPost: { endpoint: '/rest/x_post', timeoutMs: 110_000, output: 'json' },
-	getScrapeJob: { endpoint: '/rest/scrape_jobs', timeoutMs: 35_000, output: 'json' },
+	coupangProduct: { endpoint: '/rest/coupang_product', timeoutMs: 110_000, output: 'json' },
+	naverShoppingProduct: { endpoint: '/rest/naver_shopping_product', timeoutMs: 110_000, output: 'json' },
+	linkedinProfile: { endpoint: '/rest/linkedin_profile', timeoutMs: 110_000, output: 'json' },
+	linkedinCompany: { endpoint: '/rest/linkedin_company', timeoutMs: 110_000, output: 'json' },
+	linkedinJob: { endpoint: '/rest/linkedin_job', timeoutMs: 110_000, output: 'json' },
 	screenshot: { endpoint: '/rest/url_screenshot', timeoutMs: 75_000, output: 'binary', filename: 'screenshot.jpeg' },
 	youtubeMetadata: { endpoint: '/rest/youtube_metadata', timeoutMs: 60_000, output: 'json' },
 	youtubeThumbnail: { endpoint: '/rest/youtube_thumbnail', timeoutMs: 60_000, output: 'binary', filename: 'thumbnail.jpg' },
@@ -68,6 +73,8 @@ const SERVICE_DEFINITIONS = Object.freeze({
 	requestEmployment: { endpoint: '/rest/req_employment', timeoutMs: 35_000, output: 'json' },
 	requestPersonalIncome: { endpoint: '/rest/req_personal_income', timeoutMs: 35_000, output: 'json' },
 	requestNpsJoinHistory: { endpoint: '/rest/req_nps_join_history', timeoutMs: 35_000, output: 'json' },
+	requestNpsDeductionCert: { endpoint: '/rest/req_nps_deduction_cert', timeoutMs: 35_000, output: 'json' },
+	requestNpsCareerHistory: { endpoint: '/rest/req_nps_career_history', timeoutMs: 35_000, output: 'json' },
 	requestDrivingLicense: { endpoint: '/rest/req_driving_license', timeoutMs: 35_000, output: 'json' },
 	requestHealthCheckup: { endpoint: '/rest/req_health_checkup', timeoutMs: 35_000, output: 'json' },
 	requestCashReceiptDeduction: { endpoint: '/rest/req_cash_receipt_deduction', timeoutMs: 35_000, output: 'json' },
@@ -94,33 +101,26 @@ function profileInput(value) {
 	return /^https?:\/\//i.test(text) ? { url: text } : { username: text.replace(/^@/, '') };
 }
 
-// 구글 지도 장소 입력: 주소면 url, 아니면 place_id(googleMapsSearch 결과의 place_id)로 보낸다.
-function placeInput(value) {
-	const text = requiredString('placeIdOrUrl', value, 2048);
-	return /^https?:\/\//i.test(text) ? { url: text } : { place_id: text };
-}
-
 // 아마존 상품 입력: 주소면 url, 10자리 ASIN 이면 asin 으로 보낸다.
 function amazonInput(value) {
 	const text = requiredString('urlOrAsin', value, 2048);
 	return /^https?:\/\//i.test(text) ? { url: text } : { asin: text.toUpperCase() };
 }
 
-const SCRAPE_JOB_PRODUCTS = Object.freeze({ instagram_posts: 100, instagram_comments: 15, tiktok_search: 50, tiktok_video: 1, tiktok_comments: 100, amazon_reviews: 100, google_maps_place: 1 });
+// 쿠팡 상품 입력: 주소면 url, 상품 번호면 product_id 로 보낸다.
+function coupangInput(value) {
+	const text = requiredString('urlOrProductId', value, 2048);
+	return /^https?:\/\//i.test(text) ? { url: text } : { product_id: text };
+}
 
-// 수집 작업 공통 옵션: maxResults(상품별 상한), idempotencyKey(응답을 못 받아 다시 보낼 때 같은 접수로 처리).
-function scrapeJobOptions(product, payload, options) {
-	const config = options || {};
-	if (config.maxResults !== undefined && SCRAPE_JOB_PRODUCTS[product] > 1) {
-		const max = Number(config.maxResults);
-		if (!Number.isInteger(max) || max < 1 || max > SCRAPE_JOB_PRODUCTS[product]) throw new RangeError(`maxResults must be an integer from 1 to ${SCRAPE_JOB_PRODUCTS[product]}.`);
-		payload.max_results = max;
-	}
-	if (config.idempotencyKey !== undefined) {
-		if (typeof config.idempotencyKey !== 'string' || !/^[A-Za-z0-9_.:-]{8,128}$/.test(config.idempotencyKey)) throw new TypeError('idempotencyKey must be 8-128 characters of letters, digits, and . _ : -');
-		payload.idempotency_key = config.idempotencyKey;
-	}
-	return payload;
+// 네이버 브랜드스토어 상품 입력: 상품 주소만 받는다.
+function naverInput(value) {
+	return { url: requiredString('url', value, 2048) };
+}
+
+// LinkedIn 입력: 프로필(/in/), 회사(/company/), 채용공고(/jobs/view/) 주소.
+function linkedinInput(value) {
+	return { url: requiredString('url', value, 2048) };
 }
 
 function requiredString(name, value, maxLength) {
@@ -264,6 +264,10 @@ function optionalSkillText(name, value, maxLength) {
 	return requiredString(name, String(value), maxLength);
 }
 
+function optionalText(name, value, maxLength) {
+	return optionalSkillText(name, value, maxLength);
+}
+
 function numberOrNull(value) {
 	if (value === undefined || value === null || value === '') return null;
 	const number = Number(value);
@@ -563,6 +567,19 @@ class ApickClient {
 		});
 	}
 
+	// 브랜드·차명·연식·등급으로 제원·사양·등급 후보를 조회한다.
+	// 차명(model)을 비우면 브랜드 목록 또는 그 브랜드의 차종 목록을 무료로 돌려준다.
+	// 제원 값은 표준 표기로만 내려간다(연료·구동방식·변속기·차체형상·에너지효율등급, 여러 값은 "+" 연결).
+	vehicleModelInfo(options) {
+		const config = options || {};
+		return this._call('vehicleModelInfo', {
+			maker: optionalText('maker', config.maker, 60),
+			model: optionalText('model', config.model, 60),
+			modelYear: optionalText('modelYear', config.modelYear, 60),
+			trim: optionalText('trim', config.trim, 60)
+		});
+	}
+
 	async ocr(image, options) {
 		const upload = await normalizeImage(image, options);
 		const form = new FormData();
@@ -638,7 +655,6 @@ class ApickClient {
 	googleMapsSearch(keyword) {
 		return this._call('googleMapsSearch', { keyword: requiredString('keyword', keyword, 200) });
 	}
-
 	// keyword 로 구글을 검색했을 때 domain 이 1~100위 중 몇 위인지 확인한다.
 	googleRankCheck(keyword, domain) {
 		return this._call('googleRankCheck', {
@@ -674,58 +690,29 @@ class ApickClient {
 		return this._call('xPost', { url: requiredString('url', url, 2048) });
 	}
 
-	// 수집 작업: 접수 즉시 job_id 를 돌려준다. maxResults × 단가를 예약하고 결과를 받을 때 실제 건수만 차감한다.
-	_createScrapeJob(product, payload, options) {
-		return this._call('getScrapeJob', scrapeJobOptions(product, payload, options), null, { endpoint: '/rest/' + product + '/jobs', json: true });
-	}
-
-	createInstagramPostsJob(usernameOrUrl, options) {
-		return this._createScrapeJob('instagram_posts', profileInput(usernameOrUrl), options);
+	// 상품 주소(/vp/products/{번호}) 또는 상품 번호. 처리에 보통 25~40초가 걸린다.
+	coupangProduct(urlOrProductId) {
+		return this._call('coupangProduct', coupangInput(urlOrProductId));
 	}
 
-	createInstagramCommentsJob(url, options) {
-		return this._createScrapeJob('instagram_comments', { url: requiredString('url', url, 2048) }, options);
+	// 네이버 브랜드스토어 상품 주소(/{스토어}/products/{번호}). 스마트스토어 직링크는 받지 않는다.
+	naverShoppingProduct(url) {
+		return this._call('naverShoppingProduct', naverInput(url));
 	}
 
-	createTiktokSearchJob(keyword, options) {
-		return this._createScrapeJob('tiktok_search', { keyword: requiredString('keyword', keyword, 100) }, options);
+	// LinkedIn 프로필 주소(/in/{아이디}). 처리에 보통 20초 안팎이 걸린다.
+	linkedinProfile(url) {
+		return this._call('linkedinProfile', linkedinInput(url));
 	}
 
-	createTiktokVideoJob(url, options) {
-		return this._createScrapeJob('tiktok_video', { url: requiredString('url', url, 2048) }, options);
+	// LinkedIn 회사 주소(/company/{아이디}).
+	linkedinCompany(url) {
+		return this._call('linkedinCompany', linkedinInput(url));
 	}
 
-	createTiktokCommentsJob(url, options) {
-		return this._createScrapeJob('tiktok_comments', { url: requiredString('url', url, 2048) }, options);
-	}
-
-	createAmazonReviewsJob(urlOrAsin, options) {
-		return this._createScrapeJob('amazon_reviews', amazonInput(urlOrAsin), options);
-	}
-
-	// 구글 지도 장소 상세·대표 리뷰(건당 고정가). 텍스트는 영어로 온다.
-	createGoogleMapsPlaceJob(placeIdOrUrl, options) {
-		return this._createScrapeJob('google_maps_place', placeInput(placeIdOrUrl), options);
-	}
-
-	// 상태·결과 조회(무료). 끝난 작업은 실제 결과 건수로 정산돼 있다.
-	getScrapeJob(jobId) {
-		if (typeof jobId !== 'string' || !/^[a-f0-9]{32}$/.test(jobId)) throw new TypeError('jobId must be a 32-character job ID.');
-		return this._call('getScrapeJob', null, null, { endpoint: '/rest/scrape_jobs/' + jobId, method: 'GET', timeoutMs: 70_000 });
-	}
-
-	// completed 또는 failed 가 될 때까지 조회한다. 기본 10초 간격, 최대 10분.
-	async waitForScrapeJob(jobId, options) {
-		const config = options || {};
-		const intervalMs = Math.max(3_000, positiveInteger('intervalMs', config.intervalMs, 10_000));
-		const deadline = Date.now() + positiveInteger('timeoutMs', config.timeoutMs, 600_000);
-		for (;;) {
-			const result = await this.getScrapeJob(jobId);
-			const status = result && result.data && result.data.status;
-			if (status === 'completed' || status === 'failed') return result;
-			if (Date.now() + intervalMs > deadline) throw new ApickApiError('Scrape job did not finish in time.', { code: 'APICK_TIMEOUT' });
-			await new Promise((resolve) => setTimeout(resolve, intervalMs));
-		}
+	// LinkedIn 채용공고 주소(/jobs/view/{번호}).
+	linkedinJob(url) {
+		return this._call('linkedinJob', linkedinInput(url));
 	}
 
 	screenshot(url) {
@@ -1075,6 +1062,31 @@ class ApickClient {
 		return this._call('requestNpsJoinHistory', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_nps_join_history' });
 	}
 
+	requestNpsDeductionCert(input) {
+		const payload = dataRequestInput(input);
+		const years = optionalRangeInteger('years', (input || {}).years, 1, 5);
+		if (years !== undefined) payload.years = years;
+		return this._call('requestNpsDeductionCert', payload);
+	}
+
+	getNpsDeductionCert(transactionId) {
+		return this._call('requestNpsDeductionCert', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_nps_deduction_cert' });
+	}
+
+	requestNpsCareerHistory(input) {
+		const payload = dataRequestInput(input);
+		const config = input || {};
+		const from = normalizeYearMonth('from', config.from);
+		const to = normalizeYearMonth('to', config.to);
+		if (from !== undefined) payload.from = from;
+		if (to !== undefined) payload.to = to;
+		return this._call('requestNpsCareerHistory', payload);
+	}
+
+	getNpsCareerHistory(transactionId) {
+		return this._call('requestNpsCareerHistory', { transactionId: normalizeTransactionId(transactionId) }, null, { endpoint: '/rest/get_nps_career_history' });
+	}
+
 	requestDrivingLicense(input) {
 		return this._call('requestDrivingLicense', dataRequestInput(input));
 	}