Naver Search Intelligence

TypeScript Apify Actor extracting normalized Naver search results for bulk queries. Supported verticals: integrated, web, news, blog-cafe, shopping, and knowledge.

Input

{
  "queries": ["Samsung", "인공지능"],
  "verticals": ["integrated", "news", "shopping"],
  "maxResultsPerQuery": 100,
  "maxPages": 10,
  "proxyConfiguration": { "useApifyProxy": true },
  "maxRetries": 3,
  "retryBaseDelayMs": 1000
}

maxResultsPerQuery caps combined output across selected verticals for each query. Results retain requested vertical and detected SERP section. Duplicate URL/title pairs are removed.

For deterministic local parsing, set fixtureHtmlPath. Fixture mode reads one local HTML file, performs no HTTP requests, and processes only first page for each query/vertical combination.

{
  "queries": ["인공지능"],
  "verticals": ["integrated"],
  "fixtureHtmlPath": "test/fixtures/naver-ai.html"
}

Output

Each default-dataset item always contains:

query, vertical, position, section, resultType, title, description, url, displayUrl, source, publishedAt, price, currency, isAd, scrapedAt.

Unavailable optional values use null; schema keys never disappear. price is numeric and captured Korean-won prices use KRW. publishedAt preserves Naver display text because SERPs can return relative times.

Run summary is stored in key-value-store record OUTPUT.

Local development

Requires Node.js 20+ and pnpm.

pnpm install --frozen-lockfile
pnpm test
pnpm build

Run through Apify CLI or provide APIFY_INPUT_KEY/local storage using standard Apify SDK conventions. pnpm start runs compiled dist/main.js.

Reliability and limitations

• Browser-like localized headers, Apify proxy support, bounded exponential retry/backoff, and visible blocked-page markers are included.
• Naver changes markup frequently. Parser uses semantic block metadata plus selector fallbacks, backed by immutable captured fixtures.
• SSR parsing cannot recover cards rendered only after client-side JavaScript or absent from response HTML.
• Public endpoint needs no login. Restricted/personalized results are outside scope.
• Respect Naver terms, robots rules, applicable law, and conservative request rates.