apick-api 4.4.0 → 4.5.0

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+# 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.
+- 쿠팡 상품·네이버 브랜드스토어 상품·링크드인 프로필/회사/채용공고 조회 메서드 `coupangProduct()`·`naverShoppingProduct()`·`linkedinProfile()`·`linkedinCompany()`·`linkedinJob()` 과 결과 타입(`CoupangProduct`, `NaverShoppingProduct`, `LinkedinProfile`, `LinkedinCompany`, `LinkedinJob`)을 추가했습니다. 쿠팡은 상품 번호나 `/vp/products/{번호}` 주소, 네이버는 브랜드스토어 상품 주소(`brand.naver.com/{스토어}/products/{번호}`), 링크드인은 프로필(`/in/`)·회사(`/company/`)·채용공고(`/jobs/view/`) 주소를 받습니다. 모두 동기 응답이며 실패한 호출은 과금되지 않습니다.
+
 # 4.4.0
 
 - Removed the YouTube download methods `youtubeFormats()`, `downloadYoutubeVideo()` and `downloadYoutubeAudio()` and their result types (`YoutubeFormats`, `YoutubeVideoFormat`, `YoutubeAudioFormat`, `YoutubeDownloadLink`, `YoutubeVideoDownloadOptions`, `YoutubeAudioDownloadOptions`) — the matching endpoints are gone. `youtubeMetadata()`, `youtubeThumbnail()`, `youtubeSubtitleList()`, `youtubeSubtitle()`, `youtubeSearch()`, `youtubeChannel()`, `youtubePlaylist()`, `youtubeHashtag()` and `youtubeComments()` are unchanged.

package/README.md

@@ -90,6 +90,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 |
+| `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 |
 | `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 |

package/docs/guide.en.md

@@ -84,8 +84,15 @@ 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/');
 ```
 
+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.

package/docs/guide.ko.md

@@ -84,8 +84,15 @@ 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/');
 ```
 
+쿠팡은 상품 번호나 상품 주소(`/vp/products/{번호}`)를, 네이버는 브랜드스토어 상품 주소(`brand.naver.com/{스토어}/products/{번호}`)를 받습니다. 링크드인은 프로필(`/in/`)·회사(`/company/`)·채용공고(`/jobs/view/`) 주소를 받습니다.
+
 ### 수집 작업(목록·댓글·검색·리뷰)
 
 여러 건을 모으는 상품은 접수 즉시 `job_id` 를 돌려줍니다. 접수 때 `maxResults` × 단가를 예약하고, 결과를 받을 때 실제 결과 건수만 차감한 뒤 나머지는 돌려드립니다. 실패하거나 대상이 없으면 전액 환불되며 결과는 72시간 보관합니다. 댓글·리뷰 작성자는 공개 사용자명만 제공합니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apick-api",
-  "version": "4.4.0",
+  "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",

package/src/index.cjs

@@ -47,6 +47,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' },
+	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' },
 	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' },
@@ -106,6 +111,22 @@ function amazonInput(value) {
 	return /^https?:\/\//i.test(text) ? { url: text } : { asin: text.toUpperCase() };
 }
 
+// 쿠팡 상품 입력: 주소면 url, 상품 번호면 product_id 로 보낸다.
+function coupangInput(value) {
+	const text = requiredString('urlOrProductId', value, 2048);
+	return /^https?:\/\//i.test(text) ? { url: text } : { product_id: text };
+}
+
+// 네이버 브랜드스토어 상품 입력: 상품 주소만 받는다.
+function naverInput(value) {
+	return { url: requiredString('url', value, 2048) };
+}
+
+// LinkedIn 입력: 프로필(/in/), 회사(/company/), 채용공고(/jobs/view/) 주소.
+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(응답을 못 받아 다시 보낼 때 같은 접수로 처리).
@@ -674,6 +695,31 @@ class ApickClient {
 		return this._call('xPost', { url: requiredString('url', url, 2048) });
 	}
 
+	// 상품 주소(/vp/products/{번호}) 또는 상품 번호. 처리에 보통 25~40초가 걸린다.
+	coupangProduct(urlOrProductId) {
+		return this._call('coupangProduct', coupangInput(urlOrProductId));
+	}
+
+	// 네이버 브랜드스토어 상품 주소(/{스토어}/products/{번호}). 스마트스토어 직링크는 받지 않는다.
+	naverShoppingProduct(url) {
+		return this._call('naverShoppingProduct', naverInput(url));
+	}
+
+	// LinkedIn 프로필 주소(/in/{아이디}). 처리에 보통 20초 안팎이 걸린다.
+	linkedinProfile(url) {
+		return this._call('linkedinProfile', linkedinInput(url));
+	}
+
+	// LinkedIn 회사 주소(/company/{아이디}).
+	linkedinCompany(url) {
+		return this._call('linkedinCompany', linkedinInput(url));
+	}
+
+	// LinkedIn 채용공고 주소(/jobs/view/{번호}).
+	linkedinJob(url) {
+		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 });

package/src/index.d.ts

@@ -153,6 +153,122 @@ export interface XPost {
 	readonly author: { readonly followers: number | null; readonly is_verified: boolean };
 }
 
+export interface CoupangProduct {
+	readonly product_id: string;
+	readonly url: string;
+	readonly title: string;
+	readonly rating: number | null;
+	readonly reviews: number | null;
+	readonly initial_price: string;
+	readonly final_price: string;
+	readonly discount_rate: number | null;
+	readonly currency: string;
+	readonly seller_name: string;
+	readonly shop_url: string;
+	readonly seller_rating: number | null;
+	readonly seller_reviews: number | null;
+	readonly images: readonly string[];
+	readonly main_image: string;
+	readonly categories: readonly { readonly name: string; readonly url: string }[];
+	readonly root_category: string;
+	readonly root_category_url: string;
+	readonly shipping_details: readonly string[];
+	readonly variations: readonly { readonly name: string; readonly variations: readonly string[] }[];
+	readonly is_in_stock: boolean;
+}
+
+/** 네이버 브랜드스토어 상품. 상품 주소는 `/{스토어}/products/{번호}` 형식만 받는다. */
+export interface NaverShoppingProduct {
+	readonly product_id: string;
+	readonly url: string;
+	readonly title: string;
+	readonly original_price: string;
+	readonly final_price: number | null;
+	readonly discount_rate: number | null;
+	readonly currency: string;
+	readonly description: string;
+	readonly total_reviews: number | null;
+	readonly average_rating: number | null;
+	readonly sold_out: boolean;
+	readonly delivery_fee_type: string;
+	readonly arrival_guarantee: boolean;
+	readonly category_name: string;
+	readonly tags: readonly string[];
+	readonly breadcrumbs: readonly string[];
+	readonly images: readonly string[];
+	readonly sellers: readonly { readonly seller_name: string; readonly final_price: number | null; readonly currency: string; readonly seller_link: string }[];
+	readonly product_information: readonly { readonly label: string; readonly value: string }[];
+}
+
+export interface LinkedinProfile {
+	readonly linkedin_id: string;
+	readonly name: string;
+	readonly first_name: string;
+	readonly last_name: string;
+	readonly position: string;
+	readonly about: string;
+	readonly location: string;
+	readonly country_code: string;
+	readonly followers: number | null;
+	readonly connections: number | null;
+	readonly current_company_name: string;
+	readonly avatar: string;
+	readonly banner_image: string;
+	readonly url: string;
+	readonly is_influencer: boolean;
+	readonly experience: readonly { readonly company: string; readonly title: string; readonly start: string; readonly end: string; readonly location: string }[];
+	readonly education: readonly { readonly school: string; readonly degree: string; readonly start: string; readonly end: string }[];
+	readonly certifications: readonly string[];
+	readonly languages: readonly string[];
+	readonly posts: readonly { readonly title: string; readonly link: string; readonly created_at: string; readonly interaction: string }[];
+}
+
+export interface LinkedinCompany {
+	readonly company_id: string;
+	readonly name: string;
+	readonly about: string;
+	readonly description: string;
+	readonly slogan: string;
+	readonly website: string;
+	readonly industries: string;
+	readonly company_size: string;
+	readonly organization_type: string;
+	readonly founded: number | null;
+	readonly followers: number | null;
+	readonly employees_on_linkedin: number | null;
+	readonly headquarters: string;
+	readonly locations: readonly string[];
+	readonly specialties: string;
+	readonly logo: string;
+	readonly image: string;
+	readonly url: string;
+	readonly funding: Readonly<Record<string, unknown>> | null;
+	readonly updates: readonly { readonly title: string; readonly link: string; readonly date: string; readonly text: string }[];
+}
+
+export interface LinkedinJob {
+	readonly job_posting_id: string;
+	readonly title: string;
+	readonly company_name: string;
+	readonly company_id: string;
+	readonly company_url: string;
+	readonly company_logo: string;
+	readonly location: string;
+	readonly employment_type: string;
+	readonly seniority_level: string;
+	readonly industries: string;
+	readonly summary: string;
+	readonly description_html: string;
+	readonly posted_time: string;
+	readonly posted_date: string;
+	readonly applicants: number | null;
+	readonly apply_link: string;
+	readonly is_easy_apply: boolean;
+	readonly base_salary: Readonly<Record<string, unknown>> | null;
+	readonly salary_standards: string;
+	readonly url: string;
+}
+
 export interface TiktokVideo {
 	readonly video_id: string;
 	readonly url: string;
@@ -633,6 +749,11 @@ export class ApickClient {
 	amazonProduct(urlOrAsin: string): Promise<ApickResult<AmazonProduct>>;
 	xProfile(usernameOrUrl: string): Promise<ApickResult<XProfile>>;
 	xPost(url: string): Promise<ApickResult<XPost>>;
+	coupangProduct(urlOrProductId: string): Promise<ApickResult<CoupangProduct>>;
+	naverShoppingProduct(url: string): Promise<ApickResult<NaverShoppingProduct>>;
+	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>>>;