apick-api 4.5.0 → 4.8.2

package/CHANGELOG.md

@@ -1,3 +1,35 @@
+# 4.8.2
+
+- 차명에 등급·연식·좌석을 함께 넣을 수 있습니다(`파나메라 gts 4인승 19년식`, `PANAMERA GTS 19년`). 입력한 연식·등급을 우선하며 좌석 수는 실제 제원과 일치해야 합니다. 근접 연식을 선택하면 반환 연식과 안내를 확인하세요. 지정 등급을 찾지 못하거나 확신이 낮으면 제원 없이 무료 후보만 반환하며, 유사 차량이 전혀 없으면 없음 오류로 응답하고 과금하지 않습니다. 별도 연식·등급과 문장 조건이 충돌하면 입력 오류입니다.
+- Put the model, trim, year and seat count in model (for example, PANAMERA GTS 19년). Matching prioritizes the supplied year and trim, and the seat count must match the specification. Check the returned year and notice when a nearby year is selected. Unmatched trims and low-confidence matches return suggestions without specifications or charges; no similar vehicle returns a no-result error without charging. Conflicting explicit and free-text constraints are rejected.
+
+# 4.8.1
+
+- `vehicleModelInfo(options)` also covers motorcycles and scooters alongside passenger cars; the `차체형상` value adds 스쿠터, 언더본, 네이키드, 스포츠바이크, 투어링바이크, 크루저, 어드벤처, 오프로드 and 클래식바이크. Request and response shapes are unchanged.
+- `vehicleModelInfo(options)` 가 승용차에 더해 오토바이·스쿠터 같은 이륜차도 조회합니다. `차체형상` 값에 스쿠터·언더본·네이키드·스포츠바이크·투어링바이크·크루저·어드벤처·오프로드·클래식바이크가 추가됩니다. 요청·응답 형식은 바뀌지 않았습니다.
+
+# 4.8.0
+
+- `vehicleModelInfo(options)` now finds the closest model when the brand, model name or trim is written differently (`아반테`/`아반떼`, `K5 하이브리드`/`K5`, `520i`/`5시리즈`). A high-confidence match returns the specification plus `추천` (`자동선택: true`, `대안`); a low-confidence match returns `추천.대안` only and is not billed. When the requested trim has no specification, the response keeps the same model's base specification and adds `제원.등급후보` and `안내` instead of silently returning a different trim.
+- 브랜드·차명·등급 표기가 달라도(`아반테`/`아반떼`, `K5 하이브리드`/`K5`, `520i`/`5시리즈`) `vehicleModelInfo(options)` 가 가장 비슷한 차종을 찾습니다. 확신이 높으면 제원과 함께 `추천`(`자동선택: true`, `대안`)을 주고, 낮으면 `추천.대안` 만 주며 과금하지 않습니다. 지정한 등급의 제원이 없으면 다른 등급을 조용히 돌려주지 않고 같은 차명의 기본 제원과 `제원.등급후보`, `안내` 를 함께 줍니다.
+
+- Added `requestNpsDeductionCert(input)` / `getNpsDeductionCert(transactionId)` for `POST /rest/req_nps_deduction_cert` and `POST /rest/get_nps_deduction_cert` — the National Pension payment certificate used for income deduction. Takes an optional `years` (1-5, default 1) and returns per-year paid amounts (`연도별내역`) for workplace subscribers, regional subscribers, retroactive payments, additional payments and unemployment credit, plus the certificate holder name and birth date.
+- Added `requestNpsCareerHistory(input)` / `getNpsCareerHistory(transactionId)` for `POST /rest/req_nps_career_history` and `POST /rest/get_nps_career_history` — employment career history derived from the join history. Takes optional `from`/`to` (`YYYY-MM`) and returns workplace careers (`경력`) with the workplace name, period, last standard monthly income, paid and unpaid months and paid amount, a per-workplace summary (`합계`), and periods without a workplace such as regional subscribers (`사업장외가입`). Both share one phone approval with `requestNpsJoinHistory` and are billed the same way (acceptance is billed, the first result is billed, re-reads are free).
+- 국민연금 소득공제용 납부확인서 조회 메서드 `requestNpsDeductionCert()` / `getNpsDeductionCert()` 를 추가했습니다(`POST /rest/req_nps_deduction_cert`·`POST /rest/get_nps_deduction_cert`). 선택 입력 `years`(1~5, 기본 1)를 받고 발급연도별 납부금액(`연도별내역`: 사업장가입자 고지·지역가입자 등 납부·소급·추납·실업크레딧·총합계)과 증명서의 이름·생년월일을 돌려줍니다.
+- 국민연금 경력 이력 조회 메서드 `requestNpsCareerHistory()` / `getNpsCareerHistory()` 를 추가했습니다(`POST /rest/req_nps_career_history`·`POST /rest/get_nps_career_history`). 가입내역에서 사업장 단위 경력을 파생하며 선택 입력 `from`/`to`(`YYYY-MM`)를 받습니다. 사업장명·기간·기준소득월액·납부개월·미납개월·납부금액(`경력`), 사업장 기준 합계(`합계`), 지역가입 등 사업장이 없는 구간(`사업장외가입`)을 돌려줍니다. 두 상품 모두 `requestNpsJoinHistory` 와 승인 1회를 공유하고 과금 방식도 같습니다(접수 과금, 최초 결과 과금, 재조회 무료).
+
+# 4.7.0
+
+- Added `vehicleModelInfo(options)` for `POST /rest/vehicle_model_info` — look up Korean-market vehicle model specifications (dimensions, engine, efficiency, tires, trim candidates) by brand, model name, model year and trim. Every input field is optional: with no `model` the response is the brand or model list and the call is free, and an unknown model or a model without specifications fails without being charged. Specification values come back in fixed standard notation (`연료` gasoline·diesel·LPG·electric·hydrogen·hybrid, `구동방식` front·rear·2WD·AWD, `변속기` `자동 8단`·`DCT 7단`·`CVT`, `에너지효율등급` `1등급`~`5등급`), with multiple values joined by `+`.
+- 차종별 차량정보 조회 메서드 `vehicleModelInfo(options)` 를 추가했습니다(`POST /rest/vehicle_model_info`). 브랜드·차명·연식·등급으로 배기량·연비·치수·타이어·등급 후보 같은 제원을 조회합니다. 입력은 모두 선택이며 `model` 을 비우면 브랜드·차종 목록을 무료로 돌려주고, 없는 차종이나 제원이 아직 없는 차종은 과금 없이 실패합니다. 제원 값은 고정된 표준 표기로만 내려갑니다(연료·구동방식·변속기·차체형상·에너지효율등급, 여러 값은 `+` 연결).
+
+# 4.6.0
+
+- Removed the collection-job methods `createInstagramPostsJob()`, `createInstagramCommentsJob()`, `createTiktokSearchJob()`, `createTiktokVideoJob()`, `createTiktokCommentsJob()`, `createAmazonReviewsJob()`, `createGoogleMapsPlaceJob()`, `getScrapeJob()` and `waitForScrapeJob()` and their types (`ScrapeJobProduct`, `ScrapeJobOptions`, `ScrapeJob<T>`) — every request is now a single synchronous call. The synchronous methods (`amazonProduct()`, `xProfile()`, `xPost()`, `googleMapsSearch()`, `youtubeComments()`, …) are unchanged.
+- Results of retired job submissions already accepted are still settled by the server; `apick-mcp` 4.6.0 matches this release.
+- 결과 건수 과금 수집 작업 메서드 `createInstagramPostsJob()`·`createInstagramCommentsJob()`·`createTiktokSearchJob()`·`createTiktokVideoJob()`·`createTiktokCommentsJob()`·`createAmazonReviewsJob()`·`createGoogleMapsPlaceJob()`·`getScrapeJob()`·`waitForScrapeJob()` 과 타입(`ScrapeJobProduct`, `ScrapeJobOptions`, `ScrapeJob<T>`)을 제거했습니다. 모든 요청은 단발 동기 호출만 사용합니다. 동기 메서드(`amazonProduct()`, `xProfile()`, `xPost()`, `googleMapsSearch()`, `youtubeComments()` 등)는 그대로입니다.
+- 이미 접수된 작업의 정산은 서버가 계속 처리합니다. `apick-mcp` 4.6.0 과 같은 계약입니다.
+
 # 4.5.0
 
 - Added `coupangProduct(urlOrProductId)`, `naverShoppingProduct(url)`, `linkedinProfile(url)`, `linkedinCompany(url)` and `linkedinJob(url)` with the matching result types (`CoupangProduct`, `NaverShoppingProduct`, `LinkedinProfile`, `LinkedinCompany`, `LinkedinJob`). Coupang takes a product number or `/vp/products/{id}` URL, Naver takes a brand store product URL (`brand.naver.com/{store}/products/{id}`), and LinkedIn takes profile (`/in/`), company (`/company/`) or job posting (`/jobs/view/`) URLs. Each call is synchronous; failed calls are not charged.

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 APICK
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 APICK
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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 |
@@ -95,14 +96,6 @@ Leave the allowed-IP list blank for unrestricted access. To restrict access, reg
 | `linkedinProfile(url)` | 링크드인 프로필 / LinkedIn profile | JSON |
 | `linkedinCompany(url)` | 링크드인 회사 정보 / LinkedIn company | JSON |
 | `linkedinJob(url)` | 링크드인 채용공고 / LinkedIn job posting | 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 |
 | `createTtsJob(text, options)` | 한국어 내레이션 작업 접수 / Create TTS job | JSON |
 | `getTtsJob(jobId)` | TTS 작업 상태 / TTS job status | JSON |
 | `cancelTtsJob(jobId)` | 대기·생성 중 TTS 작업 취소 / Cancel waiting or processing TTS job | JSON |
@@ -125,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 |
@@ -410,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) |
@@ -508,3 +505,13 @@ Set `APICK_API_KEY` in the environment. 원격 MCP는 업로드된 자료를 처
 
 
 TTS: [Gemini·ChatGPT·정규화 / engines and normalization](docs/tts.md). `createOpenAiTtsJob`, `listOpenAiTtsVoices`, `getTtsOptions`를 포함한 최신 계약입니다.
+
+## 차량 자유문 검색 / Vehicle free-text search
+
+차명에 등급·연식·좌석을 함께 넣을 수 있습니다(`파나메라 gts 4인승 19년식`, `PANAMERA GTS 19년`). 입력한 연식·등급을 우선하며 좌석 수는 실제 제원과 일치해야 합니다. 근접 연식을 선택하면 반환 연식과 안내를 확인하세요. 지정 등급을 찾지 못하거나 확신이 낮으면 제원 없이 무료 후보만 반환하며, 유사 차량이 전혀 없으면 없음 오류로 응답하고 과금하지 않습니다. 별도 연식·등급과 문장 조건이 충돌하면 입력 오류입니다.
+
+Put the model, trim, year and seat count in model (for example, PANAMERA GTS 19년). Matching prioritizes the supplied year and trim, and the seat count must match the specification. Check the returned year and notice when a nearby year is selected. Unmatched trims and low-confidence matches return suggestions without specifications or charges; no similar vehicle returns a no-result error without charging. Conflicting explicit and free-text constraints are rejected.
+
+```js
+await client.vehicleModelInfo({ model: "파나메라 gts 4인승 19년식" });
+```

package/SECURITY.md

@@ -1,11 +1,11 @@
-# Security
-
-## API keys
-
-Keep APICK API keys in server-side environment variables. Do not commit keys, include them in client-side browser bundles, place them in URLs, or print them in logs.
-
-If a key may have been exposed, regenerate it from your APICK account immediately.
-
-## Reporting a vulnerability
-
-Please report security issues privately through the contact channel listed at <https://apick.app>. Do not open a public issue containing credentials, personal data, or exploit details.
+# Security
+
+## API keys
+
+Keep APICK API keys in server-side environment variables. Do not commit keys, include them in client-side browser bundles, place them in URLs, or print them in logs.
+
+If a key may have been exposed, regenerate it from your APICK account immediately.
+
+## Reporting a vulnerability
+
+Please report security issues privately through the contact channel listed at <https://apick.app>. Do not open a public issue containing credentials, personal data, or exploit details.

package/docs/guide.en.md

@@ -93,27 +93,6 @@ const job = await client.linkedinJob('https://www.linkedin.com/jobs/view/4001234
 
 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.
 
-### 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);
-```
-
 ## OCR
 
 OCR accepts PNG and JPEG files up to 50MB.
@@ -325,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

@@ -93,27 +93,6 @@ const job = await client.linkedinJob('https://www.linkedin.com/jobs/view/4001234
 
 쿠팡은 상품 번호나 상품 주소(`/vp/products/{번호}`)를, 네이버는 브랜드스토어 상품 주소(`brand.naver.com/{스토어}/products/{번호}`)를 받습니다. 링크드인은 프로필(`/in/`)·회사(`/company/`)·채용공고(`/jobs/view/`) 주소를 받습니다.
 
-### 수집 작업(목록·댓글·검색·리뷰)
-
-여러 건을 모으는 상품은 접수 즉시 `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);
-```
-
 ## OCR
 
 PNG와 JPEG를 지원하며 최대 크기는 50MB입니다.
@@ -328,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.5.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.2",
+  "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' },
@@ -52,7 +53,6 @@ const SERVICE_DEFINITIONS = Object.freeze({
 	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' },
-	getScrapeJob: { endpoint: '/rest/scrape_jobs', timeoutMs: 35_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' },
@@ -73,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' },
@@ -99,12 +101,6 @@ 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);
@@ -127,23 +123,6 @@ function linkedinInput(value) {
 	return { url: requiredString('url', value, 2048) };
 }
 
-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 });
-
-// 수집 작업 공통 옵션: 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 requiredString(name, value, maxLength) {
 	if (typeof value !== 'string' || !value.trim()) {
 		throw new TypeError(`${name} must be a non-empty string.`);
@@ -285,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);
@@ -584,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();
@@ -659,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', {
@@ -720,60 +715,6 @@ class ApickClient {
 		return this._call('linkedinJob', linkedinInput(url));
 	}
 
-	// 수집 작업: 접수 즉시 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);
-	}
-
-	createInstagramCommentsJob(url, options) {
-		return this._createScrapeJob('instagram_comments', { url: requiredString('url', url, 2048) }, options);
-	}
-
-	createTiktokSearchJob(keyword, options) {
-		return this._createScrapeJob('tiktok_search', { keyword: requiredString('keyword', keyword, 100) }, options);
-	}
-
-	createTiktokVideoJob(url, options) {
-		return this._createScrapeJob('tiktok_video', { url: requiredString('url', url, 2048) }, options);
-	}
-
-	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));
-		}
-	}
-
 	screenshot(url) {
 		return this._call('screenshot', { url: normalizeUrl(url) });
 	}
@@ -1121,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));
 	}

package/src/index.d.ts

@@ -269,104 +269,6 @@ export interface LinkedinJob {
 	readonly url: string;
 }
 
-export interface TiktokVideo {
-	readonly video_id: string;
-	readonly url: string;
-	readonly username: string;
-	readonly description: string;
-	readonly posted_at: string;
-	readonly views: number | null;
-	readonly likes: number | null;
-	readonly comments: number | null;
-	readonly shares: number | null;
-	readonly saves: number | null;
-	readonly duration_sec: number | null;
-	readonly hashtags: readonly string[];
-	readonly region: string;
-	readonly cover_image_url: string;
-	readonly author: { readonly followers: number | null; readonly is_verified: boolean };
-}
-
-/** 댓글 작성자는 공개 사용자명만 제공한다. */
-export interface SocialComment {
-	readonly comment_id: string;
-	readonly username: string;
-	readonly text: string;
-	readonly posted_at: string;
-	readonly likes: number | null;
-	readonly replies: number | null;
-}
-
-export interface AmazonReview {
-	readonly review_id: string;
-	readonly rating: number | null;
-	readonly title: string;
-	readonly text: string;
-	readonly author: string;
-	readonly posted_at: string;
-	readonly country: string;
-	readonly is_verified_purchase: boolean;
-	readonly helpful_count: number | null;
-	readonly variant: string;
-}
-
-export interface GoogleMapsPlace {
-	readonly name: string;
-	readonly category: string;
-	readonly categories: readonly string[];
-	readonly address: string;
-	readonly country_code: string;
-	readonly phone: string;
-	readonly website: string;
-	readonly description: string;
-	readonly rating: number | null;
-	readonly reviews_count: number | null;
-	/** 별점별 리뷰 수. */
-	readonly rating_distribution: Readonly<Record<"1" | "2" | "3" | "4" | "5", number | null>>;
-	/** 대표 리뷰(최대 10건). 작성자는 공개 표시 이름만. */
-	readonly top_reviews: readonly { readonly reviewer_name: string; readonly rating: number | null; readonly posted_at: string; readonly text: string }[];
-	readonly open_hours: Readonly<Record<string, string>>;
-	/** day: 1=월 … 7=일 */
-	readonly popular_times: readonly { readonly day: number | null; readonly hours: readonly { readonly hour: string; readonly busy_percent: number | null }[] }[];
-	readonly similar_places: readonly { readonly name: string; readonly category: string; readonly rating: number | null; readonly reviews_count: number | null }[];
-	readonly photo_urls: readonly string[];
-	readonly main_image_url: string;
-	readonly is_claimed: boolean;
-	readonly permanently_closed: boolean;
-	readonly temporarily_closed: boolean;
-	readonly latitude: number | null;
-	readonly longitude: number | null;
-	readonly place_id: string;
-	readonly map_url: string;
-}
-
-export type ScrapeJobProduct = "instagram_posts" | "instagram_comments" | "tiktok_search" | "tiktok_video" | "tiktok_comments" | "amazon_reviews" | "google_maps_place";
-
-export interface ScrapeJobOptions {
-	/** 최대 결과 수. 이 수 × 단가를 예약하고 실제 결과 건수만 차감한다(instagram_comments 15, tiktok_search 50, 그 밖 100). */
-	readonly maxResults?: number;
-	/** 응답을 못 받아 다시 보낼 때 같은 접수로 처리할 키(8~128자). */
-	readonly idempotencyKey?: string;
-}
-
-export interface ScrapeJob<T = unknown> {
-	readonly job_id: string;
-	readonly product: ScrapeJobProduct;
-	readonly status: "waiting" | "processing" | "completed" | "failed";
-	readonly max_results: number;
-	readonly unit_point: number;
-	readonly reserved_point: number;
-	readonly charged_point: number;
-	readonly result_count: number;
-	readonly created_at: string;
-	readonly completed_at: string | null;
-	/** 결과 보관 기한(완료 후 72시간). */
-	readonly result_expires_at?: string;
-	readonly result_expired?: boolean;
-	readonly items?: readonly T[];
-	readonly error?: { readonly code: string; readonly message: string };
-}
-
 export interface InstagramProfile {
 	readonly username: string;
 	readonly full_name: string;
@@ -469,6 +371,8 @@ export interface DataRequestInput {
 export interface RequestEmploymentInput extends DataRequestInput { insuranceYears?: number; }
 export interface RequestPersonalIncomeInput extends DataRequestInput { incomeYears?: number; }
 export interface RequestNpsJoinHistoryInput extends DataRequestInput { from?: string; to?: string; }
+export interface RequestNpsDeductionCertInput extends DataRequestInput { years?: number; }
+export interface RequestNpsCareerHistoryInput extends DataRequestInput { from?: string; to?: string; }
 export interface RequestDrivingLicenseInput extends DataRequestInput {}
 export interface RequestHealthCheckupInput extends DataRequestInput {}
 export interface RequestCashReceiptDeductionInput extends DataRequestInput { incomeYears?: number; }
@@ -552,6 +456,33 @@ export interface NpsJoinHistoryInfo {
 }
 export interface NpsJoinHistoryResultPayload { npsJoinHistory: NpsJoinHistoryInfo; }
 
+export interface NpsDeductionCertYearEntry {
+	발급연도: string; 사업장가입자고지금액: number; 지역가입자등납부금액: number;
+	사업장가입자소급금액: number; 추납보험료납부금액: number; 실업크레딧납부금액: number; 총합계: number;
+}
+export interface NpsDeductionCertInfo {
+	조회기간: { 시작: string; 끝: string };
+	신청인: string;
+	생년월일: string;
+	연도별내역: NpsDeductionCertYearEntry[];
+}
+export interface NpsDeductionCertResultPayload { npsDeductionCert: NpsDeductionCertInfo; }
+
+export interface NpsCareerHistoryEntry {
+	사업장: string; 시작: string; 종료: string;
+	기준소득월액: number; 납부개월: number; 미납개월: number; 납부금액: number;
+}
+export interface NpsCareerHistoryOtherEntry {
+	시작: string; 종료: string; 가입자구분: string; 납부개월: number; 납부금액: number;
+}
+export interface NpsCareerHistoryInfo {
+	조회기간: { 시작: string; 끝: string };
+	합계: { 사업장수: number; 경력건수: number; 사업장납부개월: number; 사업장납부금액: number; 사업장외납부개월: number };
+	경력: NpsCareerHistoryEntry[];
+	사업장외가입: NpsCareerHistoryOtherEntry[];
+}
+export interface NpsCareerHistoryResultPayload { npsCareerHistory: NpsCareerHistoryInfo; }
+
 export interface DrivingLicenseAcquisition {
 	면허종류코드: string; 발급일자: string; 합격일자: string; 발급지역: string; 발급일련번호: string;
 	학원명: string; 졸업일자: string; 공고시험장: string; 등록일자: string; 면허조건: string;
@@ -709,12 +640,21 @@ export class ApickBinaryResult {
 }
 
 export const DEFAULT_BASE_URL: 'https://apick.app';
-
 export const SERVICES: Readonly<Record<string, Readonly<{
 	endpoint: string;
 	output: 'json' | 'binary';
 }>>>;
 
+/** Brand, model name, model year and trim — all optional. With no `model` the call returns the brand/model list and is free. */
+export interface VehicleModelInfoOptions {
+	maker?: string;
+	/** 차명과 등급·연식·좌석을 함께 입력할 수 있습니다. Free text, e.g. PANAMERA GTS 19년. */
+	model?: string;
+	/** 2자리 또는 4자리 연식. Two or four digits; must agree with the year in model. */
+	modelYear?: string;
+	trim?: string;
+}
+
 export class ApickClient {
 	createVideoJob(model: VideoModel, prompt: string, options?: VideoJobOptions): Promise<ApickResult<VideoJobData>>;
 	getVideoJob(model: VideoModel, jobId: string): Promise<ApickResult<VideoJobData>>;
@@ -728,6 +668,8 @@ export class ApickClient {
 	validatePhone(number: string): Promise<ApickResult>;
 	holidays(year: number | string, month: number | string): Promise<ApickResult>;
 	searchAddress(query: string, options?: { page?: number }): Promise<ApickResult>;
+	/** Look up Korean-market vehicle specifications. Values use fixed standard notation (fuel, drive type, transmission, body type, efficiency grade; multiple values joined with `+`). */
+	vehicleModelInfo(options?: VehicleModelInfoOptions): Promise<ApickResult>;
 	ocr(image: string | BinaryInput | ArrayBuffer | ArrayBufferView, options?: OcrOptions): Promise<ApickResult>;
 	maskResidentNumber(image: string | BinaryInput | ArrayBuffer | ArrayBufferView, options: MaskResidentNumberOptions): Promise<ApickBinaryResult>;
 	maskResidenceCard(image: string | BinaryInput | ArrayBuffer | ArrayBufferView, options?: OcrOptions): Promise<ApickResult>;
@@ -754,15 +696,6 @@ export class ApickClient {
 	linkedinProfile(url: string): Promise<ApickResult<LinkedinProfile>>;
 	linkedinCompany(url: string): Promise<ApickResult<LinkedinCompany>>;
 	linkedinJob(url: string): Promise<ApickResult<LinkedinJob>>;
-	createInstagramPostsJob(usernameOrUrl: string, options?: ScrapeJobOptions): Promise<ApickResult<ScrapeJob<InstagramPost>>>;
-	createInstagramCommentsJob(url: string, options?: ScrapeJobOptions): Promise<ApickResult<ScrapeJob<SocialComment>>>;
-	createTiktokSearchJob(keyword: string, options?: ScrapeJobOptions): Promise<ApickResult<ScrapeJob<TiktokVideo>>>;
-	createTiktokVideoJob(url: string, options?: Pick<ScrapeJobOptions, "idempotencyKey">): Promise<ApickResult<ScrapeJob<TiktokVideo>>>;
-	createTiktokCommentsJob(url: string, options?: ScrapeJobOptions): Promise<ApickResult<ScrapeJob<SocialComment>>>;
-	createAmazonReviewsJob(urlOrAsin: string, options?: ScrapeJobOptions): Promise<ApickResult<ScrapeJob<AmazonReview>>>;
-	createGoogleMapsPlaceJob(placeIdOrUrl: string, options?: Pick<ScrapeJobOptions, "idempotencyKey">): Promise<ApickResult<ScrapeJob<GoogleMapsPlace>>>;
-	getScrapeJob<T = unknown>(jobId: string): Promise<ApickResult<ScrapeJob<T>>>;
-	waitForScrapeJob<T = unknown>(jobId: string, options?: { intervalMs?: number; timeoutMs?: number }): Promise<ApickResult<ScrapeJob<T>>>;
 	screenshot(url: string): Promise<ApickBinaryResult>;
 	youtubeMetadata(url: string): Promise<ApickResult<YoutubeMetadata>>;
 	youtubeThumbnail(url: string): Promise<ApickBinaryResult>;
@@ -807,6 +740,10 @@ export class ApickClient {
 	getPersonalIncome(transactionId: string): Promise<ApickResult<DataRequestResult<PersonalIncomeResultPayload>>>;
 	requestNpsJoinHistory(input: RequestNpsJoinHistoryInput): Promise<ApickResult<DataRequestAcceptedData>>;
 	getNpsJoinHistory(transactionId: string): Promise<ApickResult<DataRequestResult<NpsJoinHistoryResultPayload>>>;
+	requestNpsDeductionCert(input: RequestNpsDeductionCertInput): Promise<ApickResult<DataRequestAcceptedData>>;
+	getNpsDeductionCert(transactionId: string): Promise<ApickResult<DataRequestResult<NpsDeductionCertResultPayload>>>;
+	requestNpsCareerHistory(input: RequestNpsCareerHistoryInput): Promise<ApickResult<DataRequestAcceptedData>>;
+	getNpsCareerHistory(transactionId: string): Promise<ApickResult<DataRequestResult<NpsCareerHistoryResultPayload>>>;
 	requestDrivingLicense(input: RequestDrivingLicenseInput): Promise<ApickResult<DataRequestAcceptedData>>;
 	getDrivingLicense(transactionId: string): Promise<ApickResult<DataRequestResult<DrivingLicenseResultPayload>>>;
 	requestHealthCheckup(input: RequestHealthCheckupInput): Promise<ApickResult<DataRequestAcceptedData>>;