{"externalDocs":{"description":"LLM-oriented text discovery file","url":"https://ai.motherk.co.kr/llms.txt"},"info":{"description":"Public, read-only API for official MOTHER-K product knowledge, topic pages, guide answers, and retrieval results optimized for AI crawlers and answer engines.","title":"MOTHER-K AI Knowledge API","version":"2026-06-11"},"openapi":"3.1.0","paths":{"/ai-manifest.json":{"get":{"operationId":"getMotherkAiManifest","responses":{"200":{"description":"AI discovery manifest."}},"summary":"Describe the full AI-readable MOTHER-K knowledge hub.","tags":["Discovery"]}},"/ai-status.json":{"get":{"operationId":"getMotherkAiStatus","responses":{"200":{"description":"AI collection status."}},"summary":"Return public AI collection readiness, coverage, bot visit, citation, and endpoint status.","tags":["Discovery"]}},"/ai.txt":{"get":{"operationId":"getMotherkAiTextEntry","responses":{"200":{"description":"Plain-text AI entry point."}},"summary":"Return a short plain-text AI entry point with the most important crawl and retrieval URLs.","tags":["Discovery"]}},"/answers.json":{"get":{"operationId":"searchMotherkAnswers","parameters":[{"in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Answer search results."}},"summary":"Search public guide answers.","tags":["Retrieval"]}},"/catalog.jsonld":{"get":{"operationId":"getMotherkDatasetCatalog","responses":{"200":{"description":"JSON-LD DataCatalog."}},"summary":"Return the schema.org DataCatalog for official MOTHER-K AI-readable datasets.","tags":["Discovery"]}},"/checksums.json":{"get":{"operationId":"getMotherkChecksums","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":10000,"maximum":20000,"minimum":100,"type":"integer"}}],"responses":{"200":{"description":"Public URL checksum list."}},"summary":"Return public URL checksums for fast crawler-side change detection.","tags":["Discovery"]}},"/citation-map.json":{"get":{"operationId":"getMotherkCitationMap","responses":{"200":{"description":"AI citation map."}},"summary":"List citation relationships between target questions, answer URLs, official source URLs, and product candidates.","tags":["Indexes"]}},"/citation-map.jsonl":{"get":{"operationId":"streamMotherkCitationMapJsonl","responses":{"200":{"description":"Citation map JSONL feed."}},"summary":"Stream citation relationships as line-delimited JSON.","tags":["Indexes"]}},"/crawl-queue.json":{"get":{"operationId":"getMotherkCrawlQueue","parameters":[{"in":"query","name":"limit","required":false,"schema":{"default":200,"maximum":1000,"minimum":20,"type":"integer"}}],"responses":{"200":{"description":"Prioritized crawl queue."}},"summary":"List prioritized URLs for AI and search crawlers, including recent updates and repaired failure targets.","tags":["Discovery"]}},"/datasets/index.json":{"get":{"operationId":"getMotherkDatasetFileIndex","responses":{"200":{"description":"Dataset file index."}},"summary":"List bulk AI-readable dataset files and chunks.","tags":["Discovery"]}},"/feed.json":{"get":{"operationId":"getMotherkJsonFeed","responses":{"200":{"description":"JSON Feed with recent public updates."}},"summary":"Return the latest public MOTHER-K knowledge updates as JSON Feed 1.1.","tags":["Discovery"]}},"/guides.json":{"get":{"operationId":"listMotherkGuides","parameters":[{"in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"type":"integer"}},{"in":"query","name":"per_page","required":false,"schema":{"default":100,"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Paginated guide index."}},"summary":"List public guide answer pages.","tags":["Indexes"]}},"/linkset.json":{"get":{"operationId":"getMotherkLinkset","responses":{"200":{"description":"Linkset JSON."}},"summary":"Return a machine-readable linkset for AI and search discovery relations.","tags":["Discovery"]}},"/products.json":{"get":{"operationId":"listMotherkProducts","parameters":[{"in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"type":"integer"}},{"in":"query","name":"per_page","required":false,"schema":{"default":100,"maximum":200,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Paginated product index."}},"summary":"List official product knowledge records without internal identifiers.","tags":["Indexes"]}},"/products.jsonl":{"get":{"operationId":"streamMotherkProductsJsonl","responses":{"200":{"description":"Product knowledge JSONL feed."}},"summary":"Stream official product knowledge records as line-delimited JSON.","tags":["Indexes"]}},"/query-index.json":{"get":{"operationId":"getMotherkQueryIndex","responses":{"200":{"description":"Question-shaped query index."}},"summary":"List natural-language query prompts linked to retrieval, answer, topic, and citation endpoints.","tags":["Indexes"]}},"/query-index.jsonl":{"get":{"operationId":"streamMotherkQueryIndexJsonl","responses":{"200":{"description":"Query index JSONL feed."}},"summary":"Stream natural-language query prompts as line-delimited JSON.","tags":["Indexes"]}},"/questions.jsonl":{"get":{"operationId":"streamMotherkQuestionPackagesJsonl","responses":{"200":{"description":"Question package JSONL feed."}},"summary":"Stream active measurement and answer-target questions as line-delimited JSON packages.","tags":["Indexes"]}},"/resourcesync-changelist.xml":{"get":{"operationId":"getMotherkResourceSyncChangelist","responses":{"200":{"description":"ResourceSync changelist."}},"summary":"Return recently updated public knowledge URLs as a ResourceSync changelist.","tags":["Discovery"]}},"/resourcesync.xml":{"get":{"operationId":"getMotherkResourceSyncCapability","responses":{"200":{"description":"ResourceSync capability list."}},"summary":"Return ResourceSync capability list for update discovery.","tags":["Discovery"]}},"/retrieve.json":{"get":{"operationId":"retrieveMotherkKnowledge","parameters":[{"description":"User question or topic phrase.","example":"\ucd9c\uc0b0 \uc900\ube44\ubb3c \ucd94\ucc9c\ud574\uc918","in":"query","name":"q","required":true,"schema":{"type":"string"}},{"in":"query","name":"answer_limit","required":false,"schema":{"default":6,"maximum":20,"minimum":1,"type":"integer"}},{"in":"query","name":"product_limit","required":false,"schema":{"default":6,"maximum":20,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"$schema":{"type":"string"},"answers":{"items":{"type":"object"},"type":"array"},"citation_urls":{"items":{"type":"string"},"type":"array"},"domain":{"type":"string"},"products":{"items":{"type":"object"},"type":"array"},"query":{"type":"string"},"topics":{"items":{"type":"object"},"type":"array"}},"type":"object"}}},"description":"Ranked answers, products, topics, and citation URLs."}},"summary":"Retrieve official MOTHER-K answer and product candidates for a question.","tags":["Retrieval"]}},"/schemas.json":{"get":{"operationId":"getMotherkSchemas","responses":{"200":{"description":"Schema index."}},"summary":"List public JSON schemas used by the knowledge hub.","tags":["Discovery"]}},"/topics.json":{"get":{"operationId":"listMotherkTopics","responses":{"200":{"description":"Topic index."}},"summary":"List public topic pages for AI collection.","tags":["Indexes"]}},"/topics.jsonl":{"get":{"operationId":"streamMotherkTopicPackagesJsonl","responses":{"200":{"description":"Topic package JSONL feed."}},"summary":"Stream public topic packages as line-delimited JSON.","tags":["Indexes"]}},"/topics/{slug}.jsonl":{"get":{"operationId":"streamMotherkTopicAnswerCardsJsonl","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Topic-specific answer card JSONL feed."}},"summary":"Stream answer cards for one topic as line-delimited JSON.","tags":["Indexes"]}},"/url-map.json":{"get":{"operationId":"getMotherkUrlMap","responses":{"200":{"description":"Public URL map."}},"summary":"List crawlable public URLs and their machine-readable alternates.","tags":["Discovery"]}}},"servers":[{"url":"https://ai.motherk.co.kr"}],"tags":[{"description":"Question-based answer and product retrieval.","name":"Retrieval"},{"description":"Bulk indexes for crawlers and answer engines.","name":"Indexes"},{"description":"Manifest and schema discovery files.","name":"Discovery"}]}