# SocialCrawl API — naver endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/naver

## GET /v1/naver/blog/search
Search Naver Blog
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term (UTF-8). Required.
- display (optional, integer) — Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5).
- start (optional, integer) — 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1).
- sort (optional, string) — Sort order. Accepted values: sim|date. Defaults to `sim` (relevance) when the corpus supports sort.
curl "https://www.socialcrawl.dev/v1/naver/blog/search?query=소셜크롤" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/naver/news/search
Search Naver News
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term (UTF-8). Required.
- display (optional, integer) — Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5).
- start (optional, integer) — 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1).
- sort (optional, string) — Sort order. Accepted values: sim|date. Defaults to `sim` (relevance) when the corpus supports sort.
curl "https://www.socialcrawl.dev/v1/naver/news/search?query=삼성전자" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/naver/book/search
Search Naver Book
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term (UTF-8). Required.
- display (optional, integer) — Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5).
- start (optional, integer) — 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1).
- sort (optional, string) — Sort order. Accepted values: sim|date|asc|dsc (asc/dsc = price asc/desc). Defaults to `sim` (relevance) when the corpus supports sort.
curl "https://www.socialcrawl.dev/v1/naver/book/search?query=데미안" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/naver/encyc/search
Search Naver Encyclopedia
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term (UTF-8). Required.
- display (optional, integer) — Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5).
- start (optional, integer) — 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1).
- sort (optional, string) — Sort order. Accepted values: (sort ignored). Defaults to `sim` (relevance) when the corpus supports sort.
curl "https://www.socialcrawl.dev/v1/naver/encyc/search?query=양자역학" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/naver/cafearticle/search
Search Naver Cafe articles
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term (UTF-8). Required.
- display (optional, integer) — Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5).
- start (optional, integer) — 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1).
- sort (optional, string) — Sort order. Accepted values: sim|date. Defaults to `sim` (relevance) when the corpus supports sort.
curl "https://www.socialcrawl.dev/v1/naver/cafearticle/search?query=주식" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/naver/kin/search
Search Naver KnowledgeiN (지식iN)
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term (UTF-8). Required.
- display (optional, integer) — Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5).
- start (optional, integer) — 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1).
- sort (optional, string) — Sort order. Accepted values: sim|date|point. Defaults to `sim` (relevance) when the corpus supports sort.
curl "https://www.socialcrawl.dev/v1/naver/kin/search?query=코로나 증상" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/naver/local/search
Search Naver Local (장소 검색)
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term (UTF-8). Required.
- display (optional, integer) — Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5).
- start (optional, integer) — 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1).
- sort (optional, string) — Sort order. Accepted values: random|comment (display max 5, start max 1). Defaults to `sim` (relevance) when the corpus supports sort.
curl "https://www.socialcrawl.dev/v1/naver/local/search?query=강남역 카페" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/naver/shop/search
Search Naver Shopping
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term (UTF-8). Required.
- display (optional, integer) — Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5).
- start (optional, integer) — 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1).
- sort (optional, string) — Sort order. Accepted values: sim|date|asc|dsc (asc/dsc = price asc/desc). Defaults to `sim` (relevance) when the corpus supports sort.
curl "https://www.socialcrawl.dev/v1/naver/shop/search?query=노트북" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/naver/doc/search
Search Naver Academic Documents (전문자료)
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term (UTF-8). Required.
- display (optional, integer) — Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5).
- start (optional, integer) — 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1).
- sort (optional, string) — Sort order. Accepted values: (sort ignored). Defaults to `sim` (relevance) when the corpus supports sort.
curl "https://www.socialcrawl.dev/v1/naver/doc/search?query=딥러닝" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/naver/image/search
Search Naver Image
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term (UTF-8). Required.
- display (optional, integer) — Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5).
- start (optional, integer) — 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1).
- sort (optional, string) — Sort order. Accepted values: sim|date. Defaults to `sim` (relevance) when the corpus supports sort.
curl "https://www.socialcrawl.dev/v1/naver/image/search?query=한라산" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/naver/webkr/search
Search Naver Web (웹문서)
Credit cost: 1 (standard)
Parameters:
- query (required) — Free-text search term (UTF-8). Required.
- display (optional, integer) — Number of items to return per page. Defaults to 10. Standard cap 100 (local corpus caps at 5).
- start (optional, integer) — 1-indexed offset for pagination. Defaults to 1. Standard cap 1000 (local corpus caps at 1).
- sort (optional, string) — Sort order. Accepted values: (sort ignored). Defaults to `sim` (relevance) when the corpus supports sort.
curl "https://www.socialcrawl.dev/v1/naver/webkr/search?query=기후변화" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/naver/brief
One query across the Korean internet (6 Naver corpora) + optional digest.
Credit cost: 10 (override; tier advanced)
Parameters:
- query (required) — Search query (Korean or any language).
- corpora (optional, string) — CSV subset of news,blog,cafearticle,kin,shop,webkr (default all six).
- display (optional, integer) — Items per corpus (1–100, default 20).
- start (optional, integer) — 1-indexed offset per corpus (1–1000, default 1). Prefer `cursor` for paging.
- sort (optional, string) — sim (relevance, default) or date; shop also asc/dsc (price); kin also point.
- include (optional, string) — Set to `digest` for an LLM English digest with translated quotes.
- cursor (optional, string) — Opaque pagination token from a prior response's next_cursor.
curl "https://www.socialcrawl.dev/v1/naver/brief?query=삼성전자" \
  -H "x-api-key: sc_your_api_key_here"