--- title: "Search" description: "Get one Daum results page, with every block in page order." --- > Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt) ```http GET | POST /v1/daum/search ``` Send parameters as a query string with `GET`, or as a JSON body with `POST`. Both are equivalent. ## Request ```bash tab="cURL" curl -G "https://gateway.apinoa.com/v1/daum/search" \ --data-urlencode "q=제주도 여행" \ -H "x-api-key: $APINOA_API_KEY" ``` ```js tab="JavaScript" const params = new URLSearchParams({ q: "제주도 여행" }); const res = await fetch(`https://gateway.apinoa.com/v1/daum/search?${params}`, { headers: { "x-api-key": process.env.APINOA_API_KEY }, }); const { success, data, error } = await res.json(); ``` ```python tab="Python" import os import requests res = requests.get( "https://gateway.apinoa.com/v1/daum/search", params={"q": "제주도 여행"}, headers={"x-api-key": os.environ["APINOA_API_KEY"]}, ) body = res.json() ``` ## Parameters | Parameter | Type | Required | Notes | |---|---|---|---| | `country` | enum | | The market, as an ISO 3166 country code. `KR` | | `cursor` | string | | The previous page's `cursor`. Pass it alone for the next page. | | `device` | enum | | Which page to read: the desktop (default) or the mobile one. `desktop` `mobile` | | `limit` | integer 1–240 | | Results wanted (default 10, at most 240). More than one page is charged per page. | | `q` | string | | The query, search operators included. | | `timeRange` | enum | | Only results from this past period. `hour` `day` `week` `month` `year` | | `type` | enum | | What to search: web results (default), news, images or videos. `web` `news` `images` `videos` | The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json ## Response Returns [`ResultsPage`](/docs/api-reference/serp/response-schema#resultspage) in `data`. A real response, shortened: arrays keep their first entries and long text is cut. ```json { "success": true, "data": { "engine": "daum", "query": "제주도 여행", "type": "web", "country": "KR", "device": "desktop", "fetchedAt": "2026-10-30T00:57:47.292Z", "outcome": "results", "page": 1, "items": [ {"type": "relatedSearches", "rank": 1, "queries": ["제주도 여행코스 3박4일", "제주도 여행코스 2박3일"]}, { "type": "other", "rank": 2, "kind": "n0dl", "title": "바로가기", "links": [ {"url": "https://www.visitjeju.net/", "title": "VISIT JEJU"}, {"url": "https://www.visitjeju.net/", "title": "www.visitjeju.net/"} ], "ext": { "items": [{"text": "공식 제주관광 페이지. 제주특별자치도 제주시 선덕로 위치. 비짓제주, 제주관광공사 운영, 관광정보, 테마여행, 관광지도, 축제, 이벤트 안내."}] } }, { "type": "ad", "rank": 3, "block": "top", "url": "http://jejugotour.com/", "title": "제주여행 특가, 제주고투어", "snippet": "제주로 떠나는 여행의 첫걸음! 제주여행의 모든상품을 회원가입없이 간편하게 예약~", "advertiser": "제주고투어", "displayUrl": "jejugotour.com", "ext": {"highlights": ["즐거운제주여행 제주고투어"]}, "thumbnail": "https://search1.daumcdn.net/thumb/R174x174/?fname=https%3A%2F%2Fsearchad-phinf.pstatic.net%2FMjAyNDExMDFfODcg%…" }, { "type": "organic", "rank": 20, "position": 1, "url": "https://search.daum.net/search?w=tot&q=%EB%A7%88%EB%9D%BC%EB%8F%84&ency=sq%3D%EC%A0%9C%EC%A3%BC%EB%8F%84%20%EA…", "title": "마라도", "thumbnail": "thumb_noimg" }, { "type": "videoCarousel", "rank": 27, "title": "동영상", "items": [ { "url": "http://www.youtube.com/watch?v=iB9YgNvjJKY", "title": "제주도 여행 중 갑자기 \"해병대\" 연락이 왔습니다", "source": "Youtube", "channel": "무적권", "date": "2026-10-03", "durationSec": 1089, "thumbnail": "https://search1.kakaocdn.net/thumb/C400x226.q80/?fname=https%3A%2F%2Fsearch3.kakaocdn.net%2Fargon%2F656x0_80_w…", "ext": { "id": "youtb-iB9YgNvjJKY", "channelUrl": "http://www.youtube.com/channel/UCf5CAIf1sxxHFmzkX1mBFkA", "channelLogo": "https://search4.kakaocdn.net/argon/100x100_85_c/2SWQg2pxPt1" } }, { "url": "http://www.youtube.com/watch?v=z7gp570hIjg", "title": "자율주행차로 운전없이 편하게 제주도 여행해보기🚘", "source": "Youtube", "channel": "독고독채널", "date": "2026-10-08", "durationSec": 85, "thumbnail": "https://search1.kakaocdn.net/thumb/C400x226.q80/?fname=https%3A%2F%2Fsearch4.kakaocdn.net%2Fargon%2F656x0_80_w…", "ext": { "id": "youtb-z7gp570hIjg", "channelUrl": "http://www.youtube.com/channel/UCEUSANZNPXY1JsBoqhQIgxQ", "channelLogo": "https://search3.kakaocdn.net/argon/100x100_85_c/C4U7oN550Yb" } } ] } ], "cursor": "ybYbhVVm79YKJx6vHiX_c-G3tqmV4jASE6HrzroTVkS29MShQC00J7Rjt-IrN882dFRLeRXlWbid13Go4WJ_vSojZDGPGjThbn2CsWatigEFO1…" } } ``` ## Errors | Status | Code | Meaning | |---|---|---| | 400 | `INVALID_CURSOR` | The `cursor` is not one this operation returned. Start again without it. | | 400 | `INVALID_PARAMS` | A parameter is missing, unknown or out of range, or the engine does not take it. The message names it. | | 401 | `UNAUTHORIZED` | The `x-api-key` header is missing, or the key is revoked or unknown. | | 402 | `INSUFFICIENT_BALANCE` | The balance does not cover this call. Top up in the dashboard. | | 429 | `MARKETPLACE_SATURATED` | Too many concurrent calls. Retry after the `Retry-After` seconds. | | 502 | `UPSTREAM_ERROR` | The engine answered with something unusable. Retry with backoff. | | 503 | `SERVICE_UNAVAILABLE` | A temporary failure. Retry with backoff. | Every code is listed in [Errors](/docs/errors). Failed calls are not billed. ## Pricing **Price** $0.0012 per call, plus $0.0012 for each extra call it makes — at most 4 more, so $0.006 in total. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day.