Naver Search

Search Naver web, news, video and image results.

GET/api/v1/naver/search

Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.

Parameters

Search parameters

Search Naver web, news, video and image results.

Parameter	Type	Description
`query`required	string	Search query, including Naver search operators.Up to 4,096 characters.
`start`	integer	Result offset; takes precedence over page.Minimum: 0.
`page`	integer	Page number, starting at 1.Minimum: 1.
`num`	integer	Image result limit; defaults to 50 for images.Range: 1 to 100.
`where`	"nexearch" \| "web" \| "video" \| "news" \| "image"	Search type: nexearch (general search), web, video, news, or image.Default: nexearch.
`sort_by`	"r" \| "dd" \| "0" \| "1" \| "2"	News: 0 relevance (default), 1 latest, 2 oldest. Other types: r relevance (default), dd latest.
`period`	string	Time window: all, 1h, 1d, 1w, 1m, 3m, 6m, 1y, or fromYYYYMMDDtoYYYYMMDD. News also accepts 2h, 3h, 4h, 5h, and 6h.Default: all.

Response

A JSON object with search_metadata (request id, credits used and remaining) and the result data: organic_results. Groups and fields depend on the content of each page, so treat every field as optional.

Examples

cURL

curl "https://serpfast.com/api/v1/naver/search?query=coffee&where=nexearch" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

const params = new URLSearchParams({
  "query": "coffee",
  "where": "nexearch"
});
const res = await fetch(`https://serpfast.com/api/v1/naver/search?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);

Python

import os, requests

params = {
  "query": "coffee",
  "where": "nexearch"
}
res = requests.get(
    "https://serpfast.com/api/v1/naver/search",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())