# K-Data Gate

> Korean market data in English JSON for AI agents and e-commerce sellers. Product search (K-beauty, K-food, K-pop merch), Naver search trends, Korean equities and DART disclosures, apartment transactions, tourism, and weather — one API, one key. Free pilot: no payment required.

Base URL: https://kdata-gate.vercel.app

## Who this is for

- Agents helping sellers source products from Korea (what is trending, local prices, new releases)
- Agents answering K-beauty/K-food questions (bestsellers, brands, categories)
- Agents researching Korean stocks (prices, fundamentals, DART disclosures, investor flows)
- Agents planning Korea travel (places, weather, FX)

## Get a key (self-serve, free pilot)

POST /api/keys with JSON {"email":"you@example.com","plan":"free"} → returns api_key once. Free plan: 100 calls/month.
Then send Authorization: Bearer <api_key> on every call. Check balance: GET /api/credits.
No key needed for testing: add ?preview=true to any endpoint for 3 sample rows.

## Endpoints (reference price after pilot; free during pilot)

- GET /api/v1/products?q=sunscreen — Korean product search incl. K-beauty/K-food/K-pop categories, $0.010/call
- GET /api/v1/trends?keyword=buldak — Naver search trend indices, $0.010/call
- GET /api/v1/realestate?region=Seoul — apartment transactions (MOLIT), $0.010/call
- GET /api/v1/companies?corp=Samsung — company profiles and reports (DART), $0.010/call
- GET /api/v1/stocks?ticker=005930 — market overview, $0.008/call
- GET /api/v1/stocks/prices?ticker=005930 — OHLCV and traded value, $0.006/call
- GET /api/v1/stocks/fundamentals?ticker=005930 — revenue, EPS, PER, PBR, ROE, $0.012/call
- GET /api/v1/stocks/disclosures?ticker=005930 — DART disclosures summarized in English, $0.010/call
- GET /api/v1/stocks/flows?ticker=005930 — foreign/institution/retail net buying, shorts, $0.012/call
- GET /api/v1/stocks/screeners?preset=value — derived Korean equity screeners, $0.015/call
- GET /api/v1/fx-macro?indicator=usdkrw — FX and macro indicators, $0.005/call
- GET /api/v1/tourism?area=Seoul — places and attractions in English, $0.005/call
- GET /api/v1/weather?city=Seoul — current conditions and forecast, $0.002/call

## Machine-readable

- OpenAPI spec: https://kdata-gate.vercel.app/openapi.json
- Demand summary (what other agents are querying): https://kdata-gate.vercel.app/api/analytics/summary
- Docs for humans: https://kdata-gate.vercel.app/docs

## Status (honest)

Free pilot. LIVE data is served for products, trends, weather, tourism, stocks, stock-prices, and realestate (meta.mode: "live" — sourced from Naver, KMA, KTO, FSC, MOLIT). Remaining datasets (companies, stock fundamentals/disclosures/flows/screeners, fx-macro) still serve curated fixtures until their provider connections land; check meta.mode per response. Pricing above is the reference card for the paid launch — calls are free during the pilot. Product rows include coupang_url, a Coupang Partners affiliate link (disclosed in affiliate_disclosure).