{"openapi":"3.1.0","info":{"title":"Naver Datalab (BYOK) API","version":"0.1.0","description":"Naver Datalab (BYOK) lets an AI assistant read your own Naver Datalab data through the Naver Datalab API with a key you supply (client ID). Read-only: 9 tools (get_search_trend, get_shopping_category_trend, get_category_device_split, get_category_gender_split, get_category_age_split, get_shopping_keyword_trend, get_keyword_device_split, get_keyword_gender_split, get_keyword_age_split). The BYOK...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-naver-datalab.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-naver-datalab/docs"},"termsOfService":"https://connectorbay.com/byok-naver-datalab/terms"},"servers":[{"url":"https://byok-naver-datalab.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-naver-datalab/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_search_trend":{"post":{"operationId":"get_search_trend","summary":"Naver search interest over time for one keyword group (a name and up to two keywords). Values are relative: the busiest ","description":"Naver search interest over time for one keyword group (a name and up to two keywords). Values are relative: the busiest step in the period is 100. Data starts 2016-01-01. Use for \"How did searches for 'AI' and 'artificial intelligence' trend on Naver in the first half of 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_date":{"description":"First day of the period, yyyy-mm-dd.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, yyyy-mm-dd.","maxLength":10,"title":"End Date","type":"string"},"time_unit":{"description":"Size of each step: date (daily), week or month.","enum":["date","week","month"],"title":"Time Unit","type":"string"},"group_name":{"description":"Name for this keyword group.","maxLength":100,"title":"Group Name","type":"string"},"keyword1":{"description":"First search keyword in the group.","maxLength":100,"title":"Keyword1","type":"string"},"keyword2":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Second search keyword in the group (optional).","title":"Keyword2"},"device":{"anyOf":[{"enum":["pc","mo"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count searches or clicks from this device: pc or mo (mobile). Leave empty for all devices.","title":"Device"},"gender":{"anyOf":[{"enum":["m","f"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count this gender: m (male) or f (female). Leave empty for all.","title":"Gender"}},"required":["start_date","end_date","time_unit","group_name","keyword1"],"title":"get_search_trendArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_shopping_category_trend":{"post":{"operationId":"get_shopping_category_trend","summary":"Naver Shopping click interest over time for one shopping category. Values are relative (peak step is 100). Data starts 2","description":"Naver Shopping click interest over time for one shopping category. Values are relative (peak step is 100). Data starts 2017-08-01. Use for \"How did clicks in the fashion clothing category on Naver Shopping move in 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_date":{"description":"First day of the period, yyyy-mm-dd.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, yyyy-mm-dd.","maxLength":10,"title":"End Date","type":"string"},"time_unit":{"description":"Size of each step: date (daily), week or month.","enum":["date","week","month"],"title":"Time Unit","type":"string"},"category_name":{"description":"Name for the category in the result.","maxLength":100,"title":"Category Name","type":"string"},"category_code":{"description":"Naver Shopping category code (cat_id).","maxLength":20,"title":"Category Code","type":"string"},"device":{"anyOf":[{"enum":["pc","mo"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count searches or clicks from this device: pc or mo (mobile). Leave empty for all devices.","title":"Device"},"gender":{"anyOf":[{"enum":["m","f"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count this gender: m (male) or f (female). Leave empty for all.","title":"Gender"}},"required":["start_date","end_date","time_unit","category_name","category_code"],"title":"get_shopping_category_trendArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_category_device_split":{"post":{"operationId":"get_category_device_split","summary":"Naver Shopping clicks in one category split by PC and mobile over time (relative ratios). Use for \"Is fashion clothing b","description":"Naver Shopping clicks in one category split by PC and mobile over time (relative ratios). Use for \"Is fashion clothing browsed more on mobile or PC on Naver Shopping\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_date":{"description":"First day of the period, yyyy-mm-dd.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, yyyy-mm-dd.","maxLength":10,"title":"End Date","type":"string"},"time_unit":{"description":"Size of each step: date (daily), week or month.","enum":["date","week","month"],"title":"Time Unit","type":"string"},"category":{"description":"Naver Shopping category code (the cat_id value in the shopping.naver.com category URL), for example 50000000 for fashion clothing.","maxLength":20,"title":"Category","type":"string"},"gender":{"anyOf":[{"enum":["m","f"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count this gender: m (male) or f (female). Leave empty for all.","title":"Gender"}},"required":["start_date","end_date","time_unit","category"],"title":"get_category_device_splitArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_category_gender_split":{"post":{"operationId":"get_category_gender_split","summary":"Naver Shopping clicks in one category split by female and male over time (relative ratios). Use for \"Do women or men cli","description":"Naver Shopping clicks in one category split by female and male over time (relative ratios). Use for \"Do women or men click fashion clothing more on Naver Shopping\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_date":{"description":"First day of the period, yyyy-mm-dd.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, yyyy-mm-dd.","maxLength":10,"title":"End Date","type":"string"},"time_unit":{"description":"Size of each step: date (daily), week or month.","enum":["date","week","month"],"title":"Time Unit","type":"string"},"category":{"description":"Naver Shopping category code (the cat_id value in the shopping.naver.com category URL), for example 50000000 for fashion clothing.","maxLength":20,"title":"Category","type":"string"},"device":{"anyOf":[{"enum":["pc","mo"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count searches or clicks from this device: pc or mo (mobile). Leave empty for all devices.","title":"Device"}},"required":["start_date","end_date","time_unit","category"],"title":"get_category_gender_splitArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_category_age_split":{"post":{"operationId":"get_category_age_split","summary":"Naver Shopping clicks in one category split by age band (10, 20, 30, 40, 50, 60 and over) over time (relative ratios). U","description":"Naver Shopping clicks in one category split by age band (10, 20, 30, 40, 50, 60 and over) over time (relative ratios). Use for \"Which age group clicks fashion clothing most on Naver Shopping\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_date":{"description":"First day of the period, yyyy-mm-dd.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, yyyy-mm-dd.","maxLength":10,"title":"End Date","type":"string"},"time_unit":{"description":"Size of each step: date (daily), week or month.","enum":["date","week","month"],"title":"Time Unit","type":"string"},"category":{"description":"Naver Shopping category code (the cat_id value in the shopping.naver.com category URL), for example 50000000 for fashion clothing.","maxLength":20,"title":"Category","type":"string"},"device":{"anyOf":[{"enum":["pc","mo"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count searches or clicks from this device: pc or mo (mobile). Leave empty for all devices.","title":"Device"},"gender":{"anyOf":[{"enum":["m","f"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count this gender: m (male) or f (female). Leave empty for all.","title":"Gender"}},"required":["start_date","end_date","time_unit","category"],"title":"get_category_age_splitArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_shopping_keyword_trend":{"post":{"operationId":"get_shopping_keyword_trend","summary":"Naver Shopping click interest over time for one search keyword inside a category (relative, peak step is 100). Use for \"","description":"Naver Shopping click interest over time for one search keyword inside a category (relative, peak step is 100). Use for \"How did the keyword 정장 trend inside fashion clothing on Naver Shopping\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_date":{"description":"First day of the period, yyyy-mm-dd.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, yyyy-mm-dd.","maxLength":10,"title":"End Date","type":"string"},"time_unit":{"description":"Size of each step: date (daily), week or month.","enum":["date","week","month"],"title":"Time Unit","type":"string"},"category":{"description":"Naver Shopping category code (the cat_id value in the shopping.naver.com category URL), for example 50000000 for fashion clothing.","maxLength":20,"title":"Category","type":"string"},"keyword":{"description":"One search keyword inside the category.","maxLength":100,"title":"Keyword","type":"string"},"device":{"anyOf":[{"enum":["pc","mo"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count searches or clicks from this device: pc or mo (mobile). Leave empty for all devices.","title":"Device"},"gender":{"anyOf":[{"enum":["m","f"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count this gender: m (male) or f (female). Leave empty for all.","title":"Gender"}},"required":["start_date","end_date","time_unit","category","keyword"],"title":"get_shopping_keyword_trendArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_keyword_device_split":{"post":{"operationId":"get_keyword_device_split","summary":"Naver Shopping clicks for one keyword inside a category, split by PC and mobile over time. Use for \"Is the keyword 정장 se","description":"Naver Shopping clicks for one keyword inside a category, split by PC and mobile over time. Use for \"Is the keyword 정장 searched more on mobile or PC\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_date":{"description":"First day of the period, yyyy-mm-dd.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, yyyy-mm-dd.","maxLength":10,"title":"End Date","type":"string"},"time_unit":{"description":"Size of each step: date (daily), week or month.","enum":["date","week","month"],"title":"Time Unit","type":"string"},"category":{"description":"Naver Shopping category code (the cat_id value in the shopping.naver.com category URL), for example 50000000 for fashion clothing.","maxLength":20,"title":"Category","type":"string"},"keyword":{"description":"One search keyword inside the category.","maxLength":100,"title":"Keyword","type":"string"},"gender":{"anyOf":[{"enum":["m","f"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count this gender: m (male) or f (female). Leave empty for all.","title":"Gender"}},"required":["start_date","end_date","time_unit","category","keyword"],"title":"get_keyword_device_splitArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_keyword_gender_split":{"post":{"operationId":"get_keyword_gender_split","summary":"Naver Shopping clicks for one keyword inside a category, split by female and male over time. Use for \"Do women or men cl","description":"Naver Shopping clicks for one keyword inside a category, split by female and male over time. Use for \"Do women or men click on the keyword 정장 more\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_date":{"description":"First day of the period, yyyy-mm-dd.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, yyyy-mm-dd.","maxLength":10,"title":"End Date","type":"string"},"time_unit":{"description":"Size of each step: date (daily), week or month.","enum":["date","week","month"],"title":"Time Unit","type":"string"},"category":{"description":"Naver Shopping category code (the cat_id value in the shopping.naver.com category URL), for example 50000000 for fashion clothing.","maxLength":20,"title":"Category","type":"string"},"keyword":{"description":"One search keyword inside the category.","maxLength":100,"title":"Keyword","type":"string"},"device":{"anyOf":[{"enum":["pc","mo"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count searches or clicks from this device: pc or mo (mobile). Leave empty for all devices.","title":"Device"}},"required":["start_date","end_date","time_unit","category","keyword"],"title":"get_keyword_gender_splitArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_keyword_age_split":{"post":{"operationId":"get_keyword_age_split","summary":"Naver Shopping clicks for one keyword inside a category, split by age band over time. Use for \"Which age group clicks on","description":"Naver Shopping clicks for one keyword inside a category, split by age band over time. Use for \"Which age group clicks on the keyword 정장 most\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_date":{"description":"First day of the period, yyyy-mm-dd.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Last day of the period, yyyy-mm-dd.","maxLength":10,"title":"End Date","type":"string"},"time_unit":{"description":"Size of each step: date (daily), week or month.","enum":["date","week","month"],"title":"Time Unit","type":"string"},"category":{"description":"Naver Shopping category code (the cat_id value in the shopping.naver.com category URL), for example 50000000 for fashion clothing.","maxLength":20,"title":"Category","type":"string"},"keyword":{"description":"One search keyword inside the category.","maxLength":100,"title":"Keyword","type":"string"},"device":{"anyOf":[{"enum":["pc","mo"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count searches or clicks from this device: pc or mo (mobile). Leave empty for all devices.","title":"Device"},"gender":{"anyOf":[{"enum":["m","f"],"type":"string"},{"type":"null"}],"default":null,"description":"Only count this gender: m (male) or f (female). Leave empty for all.","title":"Gender"}},"required":["start_date","end_date","time_unit","category","keyword"],"title":"get_keyword_age_splitArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}