API contract

Use ?preview=true for no-key 3-row exploration. For deeper testing, request a seller pilot key and send Authorization: Bearer <api_key>. High-intent sellers can request a custom data feed from /concierge. The seller-ready signal pack is available at /seller-signals and /api/seller/signals. Compliance Scout source-map samples are available at /compliance-scout and /api/compliance-scout/sample. Buyer discovery queues are available at /buyer-discovery and /api/buyer-discovery/queue. The buyer-facing brief is available at /briefs/sourcing, the draft quote is available at /proposals/concierge, paid intent can be recorded at /orders/concierge, product bundles can be reviewed at /cart and submitted through /checkout or /api/orders/cart, the operator close packet is available at /deal-desk, the draft invoice packet is available at /invoice-draft, the paid delivery scope pack is available at /delivery-pack, and the fixed-scope platform listing pack is available at /freelance-listings. The commercial operator playbook is available at /operator-playbook, the overseas MCP benchmark pack is available at /mcp-benchmark and /api/mcp-benchmark, the launch packet is available at /launch, and the submission desk is available at /submission-desk. Paddle/card checkout is intentionally deferred; cart checkout records operator-confirmed manual-payment orders without collecting money.

/v1/products

Korean commerce search APIs

q, category, sort, source
/v1/kbeauty/ingredients

MFDS cosmetics ingredient information

ingredient, q, cas, claim, country, limit
/v1/realestate

Korea Ministry of Land (MOLIT)

region, yyyymm, min_price_usd, max_price_usd
/v1/companies

OpenDART

corp, report, year
/v1/stocks

Korean equity market overview bundle

ticker, market, sector
/v1/stocks/prices

KRX/FSC daily and intraday stock price feeds

ticker, market, date_from, date_to, adjusted
/v1/stocks/fundamentals

OpenDART financial statements and derived valuation metrics

ticker, corp, year, quarter, metric
/v1/stocks/disclosures

OpenDART disclosure filings

ticker, corp, report, date_from, date_to
/v1/stocks/flows

KRX investor flow, program trading, short selling, and lending balance feeds

ticker, market, investor, date_from, date_to
/v1/stocks/screeners

K-Data Gate derived Korean equity screening signals

preset, market, sector, min_volume
/v1/fx-macro

Bank of Korea ECOS

indicator, period
/v1/trends

Naver DataLab

keyword, category, period
/v1/tourism

Korea Tourism Organization TourAPI

area, type, lang
/v1/weather

Korea Meteorological Administration

city, type

Equity product groups

/v1/stocks/prices: daily and intraday-ready OHLCV, traded value, market filters.

/v1/stocks/fundamentals: revenue, income, EPS, PER, PBR, ROE, debt ratio.

/v1/stocks/disclosures: DART filings, categories, summaries, receipt URLs.

/v1/stocks/flows: foreign, institution, retail, program, short, lending balance. This remains fixture-backed until a commercial redistribution license is approved.

/v1/stocks/screeners: derived live signals from validated price data and optional OpenDART fundamentals.

K-beauty source mapping

/v1/kbeauty/ingredients: MFDS cosmetics ingredient source mapping for seller catalogs, sourcing briefs, and importer review.

This is official-source mapping only. It is not legal advice, import clearance, destination-country compliance approval, or a private marketplace/Olive Young bypass.

Cash sprint operator packet

/cash-sprint: 20M KRW target math, deal-count ladder, buyer segment queue, close scripts, proof links, and approval boundaries.

/api/cash-sprint: JSON/Markdown/CSV exports for operator use. It does not send messages, create invoices, collect payment, deploy, or post publicly.

Compliance Scout sample

/compliance-scout: buyer-ready K-beauty MFDS ingredient source-map sample for a $3,000 reference Compliance Scout offer.

/api/compliance-scout/sample: JSON/Markdown/CSV exports with official source rows, risk prompts, blocked claims, and next-step links. It is not legal advice, import clearance, or payment collection.

Buyer discovery queue

/buyer-discovery: approval-gated queue of public search links, qualification criteria, proof assets, and first questions for sellers, importers, and agent builders.

/api/buyer-discovery/queue: JSON/Markdown/CSV exports. It does not scrape private data, send messages, submit forms, invoice, or collect payment.

Invoice draft packet

/invoice-draft: pro-forma draft invoice packet with line items, buyer wording, deposit mode, proof links, and operator checks.

/api/invoice-draft: JSON/Markdown/CSV exports. It does not issue an invoice, generate payment details, activate Paddle, send messages, or collect payment.

Delivery pack

/delivery-pack: paid delivery scope packet with deliverables, acceptance criteria, QA checklist, buyer wording, proof links, and restricted-source guardrails.

/api/delivery-pack: JSON/Markdown/CSV exports. It does not start delivery, send files, issue invoices, collect payment, or bypass private/restricted sources.

Freelance listing pack

/freelance-listings: approval-gated Upwork/Fiverr/Contra/LinkedIn/Reddit listing copy, price tiers, buyer requirements, proposal templates, proof links, and guardrails.

/api/freelance-listings: JSON/Markdown/CSV exports. It does not create accounts, post listings, submit proposals, DM, email, invoice, or collect payment.

Commercial operator playbook

/operator-playbook: one-screen commercial execution board for what to list, what to submit, what the operator must do, proof links, offer stack, and external-action guardrails.

/api/operator-playbook: JSON/Markdown/CSV exports for agents and operator handoff. It does not post, submit forms, DM, email, invoice, collect payment, change accounts, or activate Paddle.

MCP benchmark pack

/mcp-benchmark: overseas ecommerce and seller MCP benchmark board showing what to copy, what to avoid, and how K-Data Gate should own the Korea sourcing gap.

/api/mcp-benchmark: JSON/Markdown/CSV exports with public source notes, listing copy, proof links, and guardrails. It does not submit to hubs, scrape private sources, invoice, collect payment, or activate Paddle.

Examples

curl "http://localhost:3000/api/v1/stocks/prices?preview=true&ticker=005930" curl "http://localhost:3000/api/v1/kbeauty/ingredients?preview=true&ingredient=niacinamide" curl -X POST http://localhost:3000/api/pilot/leads \ -H "content-type: application/json" \ -d '{"email":"you@example.com","role":"amazon_fba","region":"US","use_case":"Test Korean sourcing data for one product category.","datasets":["products","trends"],"urgency":"this_week"}' curl "http://localhost:3000/api/v1/stocks/prices?ticker=005930" -H "Authorization: Bearer kg_test_..." curl "http://localhost:3000/api/briefs/sourcing?category=korean_sunscreen&format=md" curl "http://localhost:3000/api/seller/signals?category=korean_sunscreen&target_market=Amazon%20US&format=md" curl "http://localhost:3000/api/proposals/concierge?offer=signal_sprint&category=korean_sunscreen&format=md" curl -X POST http://localhost:3000/api/orders/concierge \ -H "content-type: application/json" \ -d '{"email":"buyer@example.com","offer":"signal_sprint","category":"korean_sunscreen","target_market":"Shopee Singapore","delivery_format":"csv_json","invoice_method":"manual_invoice","urgency":"this_week","accepted_scope":true}' curl "http://localhost:3000/api/deal-desk/packet?offer=signal_sprint&category=korean_sunscreen&format=md" curl "http://localhost:3000/api/invoice-draft?offer=signal_sprint&category=korean_sunscreen&format=md" curl "http://localhost:3000/api/delivery-pack?offer=signal_sprint&category=korean_sunscreen&format=md" curl "http://localhost:3000/api/freelance-listings?offer=signal_sprint&category=korean_sunscreen&format=md" curl "http://localhost:3000/api/operator-playbook?format=md" curl "http://localhost:3000/api/mcp-benchmark?target_market=Amazon%20US&format=md" curl "http://localhost:3000/api/launch-packet?format=md" curl "http://localhost:3000/api/submission-desk?format=md" curl "http://localhost:3000/api/cash-sprint?target_krw=20000000&format=md" curl "http://localhost:3000/api/compliance-scout/sample?category=korean_sunscreen&target_market=Amazon%20US&format=md" curl "http://localhost:3000/api/buyer-discovery/queue?target_market=US&format=md" curl "http://localhost:3000/api/concierge/sample-feed?category=korean_sunscreen&format=csv"

MCP registration

Direct /api/keys issuance is operator-only. Public evaluators should use /pilot or /api/pilot/leads so every free key is tied to buyer intent and abuse monitoring.

{ "mcpServers": { "kdata-gate": { "command": "npm", "args": ["run", "mcp"], "env": { "KDATA_API_KEY": "kg_test_...", "NEXT_PUBLIC_BASE_URL": "http://localhost:3000" } } } }