# Social Fetch API - Naver endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 20 documented Naver operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/naver/search/blogs Search Naver blogs Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/search/blogs/get.mdx SDK: client.naver.searchBlogs({ query: "손흥민" }) Parameters: - query (required, string) - Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed. - page (optional, integer) - Page number, from 1. Naver serves at most 30 pages of a search. - sort (optional, string, enum: relevance | date) - `relevance` (Naver's default order) or `date` (newest first). Pagination: send query `page` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. curl "https://api.socialfetch.dev/v1/naver/search/blogs?query=손흥민" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/search/news Search Naver News Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/search/news/get.mdx SDK: client.naver.searchNews({ query: "손흥민" }) Parameters: - query (required, string) - Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed. - page (optional, integer) - Page number, from 1. Naver serves at most 30 pages of a search. - sort (optional, string, enum: relevance | date) - `relevance` (Naver's default order) or `date` (newest first). Pagination: send query `page` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. curl "https://api.socialfetch.dev/v1/naver/search/news?query=손흥민" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/search/cafes Search Naver cafe articles Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/search/cafes/get.mdx SDK: client.naver.searchCafes({ query: "손흥민" }) Parameters: - query (required, string) - Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed. - page (optional, integer) - Page number, from 1. Naver serves at most 30 pages of a search. - sort (optional, string, enum: relevance | date) - `relevance` (Naver's default order) or `date` (newest first). Pagination: send query `page` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. curl "https://api.socialfetch.dev/v1/naver/search/cafes?query=손흥민" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/search/kin Search Naver KnowledgeiN Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/search/kin/get.mdx SDK: client.naver.searchKin({ query: "손흥민" }) Parameters: - query (required, string) - Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed. - page (optional, integer) - Page number, from 1. Naver serves at most 30 pages of a search. - sort (optional, string, enum: relevance | date) - `relevance` (Naver's default order) or `date` (newest first). Pagination: send query `page` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. curl "https://api.socialfetch.dev/v1/naver/search/kin?query=손흥민" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/search/images Search Naver images Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/search/images/get.mdx SDK: client.naver.searchImages({ query: "손흥민" }) Parameters: - query (required, string) - Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed. - page (optional, integer) - Page number, from 1. Naver serves at most 30 pages of a search. Pagination: send query `page` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. curl "https://api.socialfetch.dev/v1/naver/search/images?query=손흥민" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/search/web Search Naver web documents Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/search/web/get.mdx SDK: client.naver.searchWeb({ query: "손흥민" }) Parameters: - query (required, string) - Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed. curl "https://api.socialfetch.dev/v1/naver/search/web?query=손흥민" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/search/encyclopedia Search the Naver encyclopedia Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/search/encyclopedia/get.mdx SDK: client.naver.searchEncyclopedia({ query: "손흥민" }) Parameters: - query (required, string) - Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed. curl "https://api.socialfetch.dev/v1/naver/search/encyclopedia?query=손흥민" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/search/places Search Naver Map places Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/search/places/get.mdx SDK: client.naver.searchPlaces({ query: "강남역 맛집" }) Parameters: - query (required, string) - Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed. - page (optional, integer) - Page number, from 1. - limit (optional, integer) - Places per page, 1 to 50. - latitude (optional, number) - Latitude of the map centre the search is run from, inside South Korea. Default: Seoul City Hall (37.5666103). Naver Map ranks places partly by distance from it. - longitude (optional, number) - Longitude of the map centre, inside South Korea. Default: Seoul City Hall (126.9783882). Pagination: send query `page` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. curl "https://api.socialfetch.dev/v1/naver/search/places?query=강남역%20맛집" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/search/brief Get Naver search brief Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/search/brief/get.mdx SDK: client.naver.getSearchBrief({ query: "손흥민" }) Parameters: - query (required, string) - Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed. - limit (optional, integer) - Results to keep from each source, 1 to 10. curl "https://api.socialfetch.dev/v1/naver/search/brief?query=손흥민" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/search/typo Check Naver search typo Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/search/typo/get.mdx SDK: client.naver.checkTypo({ query: "dkdlvhs" }) Parameters: - query (required, string) - Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed. curl "https://api.socialfetch.dev/v1/naver/search/typo?query=dkdlvhs" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/search/adult Check Naver adult search term Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/search/adult/get.mdx SDK: client.naver.checkAdultTerm({ query: "김치찌개 레시피" }) Parameters: - query (required, string) - Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed. curl "https://api.socialfetch.dev/v1/naver/search/adult?query=김치찌개%20레시피" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/places/{placeId} Get Naver place Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/places/placeid/get.mdx SDK: client.naver.getPlace({ placeId: "1195271893" }) Parameters: - placeId (required, string) - The place id, as in `map.naver.com/p/entry/place/` or `m.place.naver.com/restaurant/`, e.g. `1195271893`. A place URL is accepted too. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/naver/places/1195271893" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/places/{placeId}/reviews List Naver place reviews Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/places/placeid/reviews/get.mdx SDK: client.naver.listPlaceReviews({ placeId: "1195271893" }) Parameters: - placeId (required, string) - The place id, as in `map.naver.com/p/entry/place/` or `m.place.naver.com/restaurant/`, e.g. `1195271893`. A place URL is accepted too. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Keep the same `sort`. - limit (optional, integer) - Reviews per page, 1 to 50. - sort (optional, string, enum: recent | relevance) - `recent` (newest first, the default) or `relevance` (Naver's order). Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/naver/places/1195271893/reviews" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/places/{placeId}/rank Get Naver place rank Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/places/placeid/rank/get.mdx SDK: client.naver.getPlaceRank({ placeId: "1195271893", query: "제주 족발" }) Parameters: - placeId (required, string) - The place id, as in `map.naver.com/p/entry/place/` or `m.place.naver.com/restaurant/`, e.g. `1195271893`. A place URL is accepted too. - query (required, array) - Keywords to check, comma-separated, up to 5, e.g. `제주 족발,연동 맛집`. - depth (optional, integer) - How far down each list to look, 50 to 300 places. - latitude (optional, number) - Latitude of the map centre the search is run from, inside South Korea. Default: Seoul City Hall (37.5666103). Naver Map ranks places partly by distance from it. - longitude (optional, number) - Longitude of the map centre, inside South Korea. Default: Seoul City Hall (126.9783882). curl "https://api.socialfetch.dev/v1/naver/places/1195271893/rank?query=제주%20족발" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/blogs/{blogId} Get Naver blog Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/blogs/blogid/get.mdx SDK: client.naver.getBlog({ blogId: "bit024" }) Parameters: - blogId (required, string) - The blog id, as in `blog.naver.com/`, e.g. `bit024`. A blog URL is accepted too. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/naver/blogs/bit024" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/blogs/{blogId}/posts List Naver blog posts Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/blogs/blogid/posts/get.mdx SDK: client.naver.listBlogPosts({ blogId: "bit024" }) Parameters: - blogId (required, string) - The blog id, as in `blog.naver.com/`, e.g. `bit024`. A blog URL is accepted too. - page (optional, integer) - Page number, from 1. - limit (optional, integer) - Posts per page, 5 to 30. - categoryId (optional, integer) - Only posts in this blog category (the `categoryNo` in the blog's links); 0, the default, is every category. Pagination: send query `page` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/naver/blogs/bit024/posts" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/trends/search Get Naver search trend Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/trends/search/get.mdx SDK: client.naver.getSearchTrend({ query: "아이폰,갤럭시" }) Parameters: - query (required, array) - Search terms to compare, comma-separated, up to 5, e.g. `아이폰,갤럭시`. - startDate (optional, string) - First day, `YYYY-MM-DD`. Default: one year before `endDate`. - endDate (optional, string) - Last day, `YYYY-MM-DD`. Default: yesterday in Korea. - timeUnit (optional, string, enum: date | week | month) - One point per `date` (day), `week` or `month`. - device (optional, string, enum: pc | mobile) - Only searches or clicks from this device. Default: both. - gender (optional, string, enum: female | male) - Only this gender. Default: both. - ages (optional, array) - Only these age groups, comma-separated: `0-12`, `13-18`, `19-24`, `25-29`, `30-34`, `35-39`, `40-44`, `45-49`, `50-54`, `55-59`, `60+`. Default: every age. Outcome field: `data.lookupStatus` in `found`, `no_data` curl "https://api.socialfetch.dev/v1/naver/trends/search?query=아이폰,갤럭시" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/trends/shopping-category Get Naver Shopping category trend Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/trends/shopping-category/get.mdx SDK: client.naver.getShoppingCategoryTrend({ category: "50000000" }) Parameters: - category (required, string) - Naver Shopping category id, e.g. `50000000` (패션의류). List them with the shopping categories endpoint. - startDate (optional, string) - First day, `YYYY-MM-DD`. Default: one year before `endDate`. - endDate (optional, string) - Last day, `YYYY-MM-DD`. Default: yesterday in Korea. - timeUnit (optional, string, enum: date | week | month) - One point per `date` (day), `week` or `month`. - device (optional, string, enum: pc | mobile) - Only searches or clicks from this device. Default: both. - gender (optional, string, enum: female | male) - Only this gender. Default: both. - ages (optional, array) - Only these age groups, comma-separated: `10s`, `20s`, `30s`, `40s`, `50s`, `60s`. Default: every age. Outcome field: `data.lookupStatus` in `found`, `not_found`, `no_data` curl "https://api.socialfetch.dev/v1/naver/trends/shopping-category?category=50000000" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/trends/shopping-keywords Get Naver Shopping keyword trend Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/trends/shopping-keywords/get.mdx SDK: client.naver.getShoppingKeywordTrend({ category: "50000000", query: "원피스,코트" }) Parameters: - category (required, string) - Naver Shopping category id, e.g. `50000000` (패션의류). List them with the shopping categories endpoint. - startDate (optional, string) - First day, `YYYY-MM-DD`. Default: one year before `endDate`. - endDate (optional, string) - Last day, `YYYY-MM-DD`. Default: yesterday in Korea. - timeUnit (optional, string, enum: date | week | month) - One point per `date` (day), `week` or `month`. - device (optional, string, enum: pc | mobile) - Only searches or clicks from this device. Default: both. - gender (optional, string, enum: female | male) - Only this gender. Default: both. - ages (optional, array) - Only these age groups, comma-separated: `10s`, `20s`, `30s`, `40s`, `50s`, `60s`. Default: every age. - query (required, array) - Shopping keywords to compare inside the category, comma-separated, up to 5, e.g. `원피스,코트`. Outcome field: `data.lookupStatus` in `found`, `not_found`, `no_data` curl "https://api.socialfetch.dev/v1/naver/trends/shopping-keywords?category=50000000&query=원피스,코트" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/naver/trends/shopping-categories List Naver Shopping categories Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/naver/trends/shopping-categories/get.mdx SDK: client.naver.listShoppingCategories({ parent: "50000000" }) Parameters: - parent (optional, string) - List the subcategories of this category; `0`, the default, lists the top level. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/naver/trends/shopping-categories?parent=50000000" \ -H "x-api-key: YOUR_API_KEY"