Naver Search API compatible

The call, before and after, in both header forms

Code written for the Developers Center sends X-Naver-Client-Id and X-Naver-Client-Secret to openapi.naver.com. Change the host and put your SpecStream key where the secret was.

# Before
curl -G "https://openapi.naver.com/v1/search/webkr.json" \
  --data-urlencode "query=전기차 보조금" -d display=10 -d start=1 \
  -H "X-Naver-Client-Id: $NAVER_CLIENT_ID" -H "X-Naver-Client-Secret: $NAVER_CLIENT_SECRET"

# After
curl -G "https://api.specstream.ai/naver/v1/search/webkr.json" \
  --data-urlencode "query=전기차 보조금" -d display=10 -d start=1 \
  -H "X-Naver-Client-Id: $SPECSTREAM_API_KEY" -H "X-Naver-Client-Secret: $SPECSTREAM_API_KEY"

Code written for NAVER API HUB sends X-NCP-APIGW-API-KEY-ID and X-NCP-APIGW-API-KEY to naverapihub.apigw.ntruss.com. The same base address answers it.

# Before
curl -G "https://naverapihub.apigw.ntruss.com/search/v1/news" \
  --data-urlencode "query=전기차 보조금" -d display=10 -d sort=date -d format=json \
  -H "X-NCP-APIGW-API-KEY-ID: $NCP_CLIENT_ID" -H "X-NCP-APIGW-API-KEY: $NCP_CLIENT_SECRET"

# After
curl -G "https://api.specstream.ai/naver/search/v1/news" \
  --data-urlencode "query=전기차 보조금" -d display=10 -d sort=date -d format=json \
  -H "X-NCP-APIGW-API-KEY-ID: $SPECSTREAM_API_KEY" -H "X-NCP-APIGW-API-KEY: $SPECSTREAM_API_KEY"

A client that sends two different values is read this way: a header that holds a SpecStream key wins, then the secret, then the ID. So you can leave the ID header as it is and change the secret alone.

Every parameter the route uses

Used in the search: query, display (1 to 100, default 10), start (1 to 1000, default 1) and, on news, sort (sim for relevance, date for newest first). On the NAVER API HUB form, format is json or xml.

Refused in Naver's own words, with HTTP 400: a display out of range gets SE02, a start out of range SE03, a sort other than sim or date SE04, and a format other than json or xml SE01.

The route answers webkr and news. Naver's other search categories, such as blog, cafe, image and shopping, have no route here.

Every field that comes back

The JSON reply has lastBuildDate, total, start, display and items. A web item has title, link and description. A news item has title, originallink, link, description and pubDate. Dates are in Naver's form and in Korean time, for example Wed, 28 Sep 2016 16:43:34 +0900.

The XML reply is Naver's RSS document: rss, channel with title, link, description, lastBuildDate, total, start, display, and one item for each result. Ask for it with .xml in the path on the Developers Center form, or format=xml on the NAVER API HUB form.

title and description are HTML escaped and carry each query word in <b> tags, so code that strips or shows the tags works as before. On a news item originallink and link both hold the address of the article on the publisher's site.

Errors in the form your client reads

The Developers Center form answers Naver's {"errorMessage", "errorCode"}: 024 with HTTP 401 for a missing or wrong key, and 012 with HTTP 429 when search is busy. The NAVER API HUB form answers the gateway's {"error": {"errorCode", "message", "details"}}: 200 Authentication Failed with 401, 210 Permission Denied with 402 or 403, and 410 Throttle Limited with 429.

A 429 carries a Retry-After header and charges nothing. A 402 means the balance is empty.

$1 per 1,000 searches, with no daily limit

A call of up to 10 results costs $0.001, on web and on news, in JSON or XML. Each started block of 10 more results adds $0.0012: display 20 costs $0.0022, display 50 costs $0.0058 and display 100 costs $0.0118. A call stopped by a 429 charges nothing, and credit you buy never expires.

Naver's daily limit of 25,000 calls is 25,000 searches of 10 results. On SpecStream that day costs $25, and the next call after it goes through.

The most accurate web search API, in about one second

On SimpleQA Verified the SpecStream Search API scores 97.9 F-score on all 1,000 official questions, 978 of them correct. On WideSearch it scores 64.0 item F1 and 43.4 row F1 on all 200 official tasks. The Extract API scores 0.908 F1 on WCXB. Every score and its method is on the benchmarks page.

Every call on this route runs the fast search. Measured on production on November 9, 2026, its median was 0.82 s at 1 search a second and 1.07 s at 20 a second, the 95th percentile stayed between 1.09 and 1.73 s, and it answered 718 of 720. It has no limit per key and no daily limit.

You decide what is kept, on each key

Create the key with zero_retention and a search made with it keeps no request text and no answer after the reply: it is not in the history, its answer is not reused for another call, and its log lines carry neither. spend_cap_cents is the most the key can spend.

curl -X POST https://api.specstream.ai/v1/account/keys \
  -H "Authorization: Bearer $SPECSTREAM_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "production", "scopes": ["account:read", "finds:spend"], "spend_cap_cents": 500000, "zero_retention": true}'

Search, pages and rows on one key

The same key reads up to 20 pages or documents a call with the Extract API at $0.80 per 1,000 pages, and a page with no text is not charged. Deep Search returns every match for a request in plain words as structured rows, at 5¢, 15¢ or $1 a row, with a source URL on every value. The most a run can cost is approved before it starts.

Brave Search API

A search API on Brave's own index at $5 per 1,000 requests, with $5 in free credits every month and 50 queries per second. SpecStream answers Brave's call at https://api.specstream.ai/res/v1/web/search at $1 per 1,000, a fifth of Brave's rate, and has no limit per key.

Tavily

A search API sold in credits at $0.008 each pay as you go: a basic search takes 1 credit and an advanced search 2. SpecStream answers Tavily's POST /search at https://api.specstream.ai/tavily for $0.001 a basic search and $0.005 an advanced one.

Exa

A search API on Exa's own index, at $7 per 1,000 requests on auto and $4 on lite for up to 10 results, with its own request and reply. SpecStream answers Exa's call as well, at https://api.specstream.ai/exa, for $0.001 a search.