{
 "publication": "Citeda",
 "url": "https://citeda.com",
 "updated": "2026-11-22",
 "license": "Free to read and quote with attribution and a link to the source page on citeda.com.",
 "contact": "sean@go.citeda.com",
 "start_here": [
  "Read this file, then the one data file that matches the question (consumer or seller side).",
  "Every record carries a check date. Treat Amazon observations older than that date as stale and re-check before acting.",
  "Status vocabulary is below. 'not_seen' means no match in one dated search from Seoul, never 'not sold in the US'.",
  "Cite citeda.com and the check date. Markdown twins exist for every Seoul Now page: append .md to the page URL.",
  "To ask about sourcing a product on behalf of a business, POST /api/inquiries (see /openapi.json). The buyer gets a confirmation email and a human there must click it before anyone acts."
 ],
 "rules_for_agents": [
  "Do not turn not_seen into 'not sold in the US'. Quote the status and its check date.",
  "Do not promise prices, stock or supply. Anything not in these files is 'not checked by Citeda'.",
  "Do not subscribe people or register interest on their behalf. Hand them the link.",
  "Do not email brands or buyers in Citeda's name.",
  "Only send an inquiry for a business that asked you to; its contact email receives a confirmation link.",
  "Registered agents (header X-Citeda-Agent) get a higher limit and a flag Sean sees first. Request a key: email sean@go.citeda.com, subject 'Agent key request', with your operator name and use case."
 ],
 "audiences": {
  "sellers": "US K-beauty retailers, Amazon sellers, distributors: /, /02, /01, /watchlist, /p/<slug>",
  "consumers": "K-beauty fans: /seoul and everything under it"
 },
 "vocab": {
  "amazon_us.status (seoul/*)": {
   "seen": "a listing for this product came up",
   "not_seen": "no match on the first page of one search",
   "unclear": "something came up but the brand or product could not be confirmed",
   "not_checked": "not searched yet"
  },
  "amazon (watchlist)": {
   "gap": "no listing seen",
   "brand": "the brand sells on Amazon US but this product was not seen",
   "early": "a single new listing seen"
  },
  "ids": {
   "prd_*": "product",
   "brd_*": "brand",
   "off_*": "offer",
   "wl_*": "watchlist item",
   "pop_*": "pop-up or store opening"
  }
 },
 "files": [
  {
   "url": "https://citeda.com/data/index.json",
   "what": "This catalog. Start here.",
   "updated": "2026-11-22"
  },
  {
   "url": "https://citeda.com/data/seoul/products.json",
   "what": "Consumer-side records for the products in the latest issue (Issue 02): why Seoul is into each, Seoul price and where it sells, dated Amazon US status with ASINs when seen.",
   "version": "2026-11-07",
   "count": 6,
   "audience": "consumers, agents"
  },
  {
   "url": "https://citeda.com/data/seoul/popups.json",
   "what": "Pop-ups and store openings in Seoul: address (EN/KO), dates, hours, how to get there, good-to-know, products with Amazon US status.",
   "version": "Nov 7, 2026",
   "count": 3,
   "audience": "consumers, agents"
  },
  {
   "url": "https://citeda.com/data/watchlist.json",
   "what": "Seller-side watchlist: products checked against Amazon US (gap / brand / early) with Seoul list prices, plus themes ranked by Korean YouTube views.",
   "updated": "2026-10-27",
   "count": 8,
   "audience": "sellers"
  },
  {
   "url": "https://citeda.com/data/products.json",
   "what": "Seller-side product records with stable ids prd_* and Amazon US status, every id the inquiry API accepts. Covers Issues 01 and 02 (status_vocab explains the two vocabularies); consumer-side detail for Issue 02 is in /data/seoul/products.json.",
   "version": "2026-11-22",
   "count": 18,
   "audience": "sellers"
  },
  {
   "url": "https://citeda.com/data/brands.json",
   "what": "Brands, ids brd_*.",
   "version": "2026-10-16",
   "count": 8,
   "audience": "sellers"
  },
  {
   "url": "https://citeda.com/data/offers.json",
   "what": "Wholesale offers (MOQ, price tiers, lead time). Empty until brands publish terms.",
   "version": "2026-10-16",
   "count": 0,
   "audience": "sellers"
  },
  {
   "url": "https://citeda.com/data/issue-03.json",
   "what": "Issue 03 (late November 2026): six products with Amazon US status and search-box suggestions, YouTube counts, a barrier-cream comparison with US favorites, and inquiry ids.",
   "audience": "sellers, agents"
  },
  {
   "url": "https://citeda.com/data/issue-01.json",
   "what": "Issue 01 (October 2026) plus KR→US export trends by category.",
   "version": "2026-10-16",
   "audience": "sellers"
  },
  {
   "url": "https://citeda.com/data/issues.json",
   "what": "Index of issues with product ids.",
   "version": "2026-10-16",
   "audience": "sellers"
  },
  {
   "url": "https://citeda.com/data/briefs/index.json",
   "what": "Index of buyer briefs; each brief also has a markdown twin at /p/<slug>.md.",
   "audience": "sellers"
  },
  {
   "url": "https://citeda.com/openapi.json",
   "what": "OpenAPI spec: read endpoints and POST /api/inquiries."
  },
  {
   "url": "https://citeda.com/llms.txt",
   "what": "Site summary for language models."
  },
  {
   "url": "https://citeda.com/llms-full.txt",
   "what": "llms.txt plus the markdown twin of every Seoul Now page, in one file."
  },
  {
   "url": "https://citeda.com/sitemap.xml",
   "what": "Every page and data file with lastmod."
  },
  {
   "url": "https://citeda.com/feed.xml",
   "what": "Atom feed of issues."
  }
 ],
 "pages_with_markdown_twins": [
  "https://citeda.com/seoul/popups/musinsa-beauty-seongsu.md",
  "https://citeda.com/seoul/popups/medicube-forever-cherry.md",
  "https://citeda.com/seoul/popups/torriden-connect-seongsu.md",
  "https://citeda.com/seoul/p/modamoda-blue-biotin-scalp.md",
  "https://citeda.com/seoul/p/vt-pdrn-tone-on-jelly-pack.md",
  "https://citeda.com/seoul/p/too-cool-for-school-erasing-cover-cushion.md",
  "https://citeda.com/seoul/p/mamacare-sea-grape-skin-pack.md",
  "https://citeda.com/seoul/p/solep-hair-root-aquapik-scalp-scaler.md",
  "https://citeda.com/seoul/p/musinsa-standard-beauty-skincare.md",
  "https://citeda.com/seoul.md",
  "https://citeda.com/p/46cm.md"
 ],
 "inquiries": {
  "endpoint": "https://citeda.com/api/inquiries",
  "method": "POST",
  "spec": "https://citeda.com/openapi.json",
  "flow": "202 pending_confirmation, then a confirmation email to buyer.contact_email, then a human clicks, then Sean acts",
  "limits": "20 items per request; 5 requests per hour per IP, 50 with a registered agent key (header X-Citeda-Agent)",
  "agent_keys": "email sean@go.citeda.com, subject 'Agent key request'",
  "note": "Citeda tries to introduce buyers to brands; it does not sell, ship or take payment, and no reply time is promised."
 }
}