{"openapi":"3.1.0","info":{"title":"ROBOTINSIGHT Korea Robotics Intel","version":"1.0.0","description":"Korean robotics industry intelligence, sold per query. Structured feed of Korea/Asia robot-sector news, analysis and KPIs - humanoids, physical AI, robot components (reducers, actuators, MEMS force-torque and tactile sensors), robot semiconductors, defense and logistics robots - written from Korean primary reporting and DART filings that English-language sources do not cover. Filter by date, region, category and keyword. Pay per query in USDC on Base or Polygon; empty results free."},"servers":[{"url":"https://robotinsight.kr"}],"x-discovery":{"protocols":["x402"]},"paths":{"/api/intel":{"get":{"operationId":"queryRobotIntel","summary":"Query the Korean robotics corpus and pay per result","description":"Korean robotics industry intelligence, sold per query. Structured feed of Korea/Asia robot-sector news, analysis and KPIs - humanoids, physical AI, robot components (reducers, actuators, MEMS force-torque and tactile sensors), robot semiconductors, defense and logistics robots - written from Korean primary reporting and DART filings that English-language sources do not cover. Filter by date, region, category and keyword. Pay per query in USDC on Base or Polygon; empty results free.","x-payment-info":{"protocols":["x402"],"price":{"mode":"dynamic","currency":"USD","min":"0.03","max":"10.01"}},"x-examples":["/api/intel?depth=brief&limit=10","/api/intel?depth=brief&limit=10&q=humanoid","/api/intel?depth=index&limit=20&region=korea&since=2026-08-16"],"x-vocabulary":{"facets":["humanoid","physical-ai","components","logistics","manufacturing","medical","defense","service","market","policy","industry"],"note":"Facets are derived from each post's Korean kicker; a post may carry more than one. `category` also still matches the raw kicker by substring."},"parameters":[{"name":"depth","in":"query","required":false,"description":"index = slug/date/category/title/facets (FREE, any limit), brief = +summary +KPIs +reviewed bilingual intelligence summary ($0.02/item), full = +body +sources +reviewed evidence-backed intelligence ($0.10/item). Paid queries add a $0.01 base fee, waived on cursor continuations. Empty results are free.","schema":{"type":"string","enum":["index","brief","full"],"default":"brief"}},{"name":"limit","in":"query","required":false,"description":"1-100, default 5","schema":{"type":"integer","minimum":1,"maximum":100,"default":5}},{"name":"region","in":"query","required":false,"description":"comma-separated: world, us, korea, company","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"comma-separated. Matches a raw Korean kicker by substring, OR a facet value from x-vocabulary. Facets are derived from each post's Korean kicker; a post may carry more than one. `category` also still matches the raw kicker by substring.","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"YYYY-MM-DD, inclusive; article publication date in Asia/Seoul, not event occurrence","schema":{"type":"string"}},{"name":"until","in":"query","required":false,"description":"YYYY-MM-DD, inclusive; article publication date in Asia/Seoul, not event occurrence","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"keyword, matched against title and summary. Content is Korean; common English terms (humanoid, battery, hyundai, supply chain, sensor ...) are mapped to their Korean equivalents automatically, and the response echoes the expansion as qTerms. See x-examples.","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"opaque id from a previous response's nextCursor","schema":{"type":"string"}},{"name":"entity","in":"query","required":false,"description":"Comma-separated stable entity IDs, OR within this filter. Structured filters search reviewed enrichment only. Filters combine with AND; comma-separated values within each combine with OR. All filters must match the same event and participant. Editorial inference is excluded. since/until filter article publication dates in Asia/Seoul, not event dates.","schema":{"type":"string"}},{"name":"component","in":"query","required":false,"description":"Comma-separated component IDs. Matches a supplier or developer participant, not an unrelated company. Structured filters search reviewed enrichment only. Filters combine with AND; comma-separated values within each combine with OR. All filters must match the same event and participant. Editorial inference is excluded. since/until filter article publication dates in Asia/Seoul, not event dates.","schema":{"type":"string"}},{"name":"eventType","in":"query","required":false,"description":"Comma-separated event types. A reported plan is not a completed delivery; inspect status and claimBasis. Structured filters search reviewed enrichment only. Filters combine with AND; comma-separated values within each combine with OR. All filters must match the same event and participant. Editorial inference is excluded. since/until filter article publication dates in Asia/Seoul, not event dates.","schema":{"type":"string"}},{"name":"entityCountry","in":"query","required":false,"description":"Comma-separated ISO alpha-2 countries, e.g. KR. Country and component must match the same participant. Structured filters search reviewed enrichment only. Filters combine with AND; comma-separated values within each combine with OR. All filters must match the same event and participant. Editorial inference is excluded. since/until filter article publication dates in Asia/Seoul, not event dates.","schema":{"type":"string"}}],"responses":{"200":{"description":"Matching items. Korean-language content, JSON envelope.","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object"},"count":{"type":"integer"},"freshness":{"type":"object","properties":{"newest":{"type":"string"},"generatedAt":{"type":"string"},"matchingNewest":{"type":["string","null"],"description":"Newest matching article on this page; newest remains corpus freshness."}}},"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"date":{"type":"string"},"region":{"type":"string"},"category":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"kpi":{"type":"array","items":{"type":"object"}},"sources":{"type":"array","items":{"type":"object"}},"body":{"type":"string"},"articleId":{"type":"string","description":"Immutable site:numeric-id, independent of slug."},"hasIntelligence":{"type":"boolean"},"entityIds":{"type":"array","items":{"type":"string"}},"components":{"type":"array","items":{"enum":["actuator","reducer","sensor","battery","controller","semiconductor","gripper","robot","software","material","camera","charging","display","motor","pcb","passive_component","wiring"]}},"intelligenceBrief":{"type":["object","null"],"description":"Adds bilingual summary, normalized entity names, event type, status and claim basis. Absent at index depth."},"intelligence":{"anyOf":[{"$ref":"#/components/schemas/Intelligence"},{"type":"null"}],"description":"Full depth only; null for unenriched legacy items."}}}},"nextCursor":{"type":["string","null"]},"hint":{"type":"object","description":"only on an empty (free) result: corpus facets and working examples"},"coverage":{"type":"object","description":"Actual reviewed article count, publication range, enrichment update timestamp and corpus total."}}}}},"headers":{"PAYMENT-RESPONSE":{"description":"Base64 JSON settlement result. Present after settlement only; both headers carry identical bytes.","schema":{"type":"string"}},"X-PAYMENT-RESPONSE":{"description":"Base64 JSON settlement result. Present after settlement only; both headers carry identical bytes.","schema":{"type":"string"}}}},"402":{"description":"Payment required. Default JSON body is x402 v1; PAYMENT-REQUIRED always carries a base64 v2 challenge. Request a v2 body with X-402-Version: 2, Accept: application/vnd.x402+json; version=2, x402Version=2, or PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64 JSON x402 v2 PaymentRequired","schema":{"type":"string"}},"PAYMENT-RESPONSE":{"description":"Base64 JSON settlement result. Present after settlement only; both headers carry identical bytes.","schema":{"type":"string"}},"X-PAYMENT-RESPONSE":{"description":"Base64 JSON settlement result. Present after settlement only; both headers carry identical bytes.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["x402Version","accepts"],"properties":{"x402Version":{"const":1},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object","required":["scheme","network","maxAmountRequired","payTo","asset"],"properties":{"scheme":{"type":"string"},"network":{"type":"string"},"maxAmountRequired":{"type":"string"},"payTo":{"type":"string"},"asset":{"type":"string"}}}}}},{"type":"object","required":["x402Version","resource","accepts"],"properties":{"x402Version":{"const":2},"error":{"type":"string"},"resource":{"type":"object"},"extensions":{"type":"object"},"accepts":{"type":"array","items":{"type":"object","required":["scheme","network","amount","payTo","asset"],"properties":{"scheme":{"type":"string"},"network":{"type":"string"},"amount":{"type":"string"},"payTo":{"type":"string"},"asset":{"type":"string"}}}}}}]}}}},"405":{"description":"Unsupported method; Allow: GET, OPTIONS. No payment attempted."}}},"options":{"summary":"Credential-free browser preflight; never charges","responses":{"204":{"description":"Empty response; allows GET, OPTIONS and payment/bearer headers."}}}},"/api/intel/sample":{"get":{"operationId":"getPublicIntelligenceSample","summary":"One fixed public full-depth reviewed sample; query parameters cannot change selection","responses":{"200":{"description":"Public sample with actual article and review dates; no payment required","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"object"},"count":{"type":"integer"},"freshness":{"type":"object","properties":{"newest":{"type":"string"},"generatedAt":{"type":"string"},"matchingNewest":{"type":["string","null"],"description":"Newest matching article on this page; newest remains corpus freshness."}}},"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"date":{"type":"string"},"region":{"type":"string"},"category":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"kpi":{"type":"array","items":{"type":"object"}},"sources":{"type":"array","items":{"type":"object"}},"body":{"type":"string"},"articleId":{"type":"string","description":"Immutable site:numeric-id, independent of slug."},"hasIntelligence":{"type":"boolean"},"entityIds":{"type":"array","items":{"type":"string"}},"components":{"type":"array","items":{"enum":["actuator","reducer","sensor","battery","controller","semiconductor","gripper","robot","software","material","camera","charging","display","motor","pcb","passive_component","wiring"]}},"intelligenceBrief":{"type":["object","null"],"description":"Adds bilingual summary, normalized entity names, event type, status and claim basis. Absent at index depth."},"intelligence":{"anyOf":[{"$ref":"#/components/schemas/Intelligence"},{"type":"null"}],"description":"Full depth only; null for unenriched legacy items."}}}},"nextCursor":{"type":["string","null"]},"hint":{"type":"object","description":"only on an empty (free) result: corpus facets and working examples"},"coverage":{"type":"object","description":"Actual reviewed article count, publication range, enrichment update timestamp and corpus total."}}}}}}}}}},"x-intelligence":{"coverage":{"schemaVersion":"1.0","totalArticles":425,"reviewedArticles":30,"oldest":"2026-10-02","newest":"2026-10-15","updatedAt":"2026-10-15T08:26:44Z","note":"Structured filters search reviewed articles only. Missing enrichment is unknown, not evidence of no events. Dates filter article publication in Asia/Seoul, not event occurrence."},"vocabulary":{"schemaVersion":"1.0","components":["actuator","reducer","sensor","battery","controller","semiconductor","gripper","robot","software","material","camera","charging","display","motor","pcb","passive_component","wiring"],"eventTypes":["product_announcement","contract","funding","capacity_change","deployment","policy","research_result","security_disclosure","business_update","market_report"],"claimBases":["official_announcement","company_claim","media_report","editorial_inference"]},"filterNote":"Structured filters search reviewed enrichment only. Filters combine with AND; comma-separated values within each combine with OR. All filters must match the same event and participant. Editorial inference is excluded. since/until filter article publication dates in Asia/Seoul, not event dates.","workedQuery":"https://robotinsight.kr/api/intel?depth=index&limit=10&component=actuator&entityCountry=KR&eventType=product_announcement%2Ccontract&since=2026-10-12&until=2026-10-16","workedQueryNote":"Current KST week. Zero matches are valid and free; this example does not claim full archive enrichment.","sample":"https://robotinsight.kr/api/intel/sample","documentation":"https://robotinsight.kr/developers","schema":"https://robotinsight.kr/schemas/intelligence-v1.json","tiers":{"index":"Free articleId, hasIntelligence, entityIds and components; no claim details.","brief":"Adds bilingual summary, normalized entity names, event type, status and claim basis.","full":"Adds reviewed events, relationships, metrics and evidence. Legacy records have intelligence: null."}},"components":{"schemas":{"Intelligence":{"$id":"https://robotinsight.kr/schemas/intelligence-v1.json","type":"object","additionalProperties":false,"required":["schemaVersion","reviewStatus","reviewedAt","updatedAt","summary","entities","components","events","relationships","metrics","evidence"],"properties":{"schemaVersion":{"const":"1.0"},"reviewStatus":{"const":"reviewed"},"reviewedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$"},"updatedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$"},"summary":{"type":"object","additionalProperties":false,"required":["ko","en"],"properties":{"ko":{"type":"string","minLength":1},"en":{"type":"string","minLength":1}}},"entities":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","nameKo","nameEn","country","aliases","ticker","exchange"],"properties":{"id":{"type":"string","minLength":1},"nameKo":{"type":"string","minLength":1},"nameEn":{"type":["string","null"]},"country":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"aliases":{"type":"array","items":{"type":"string","minLength":1}},"ticker":{"type":["string","null"]},"exchange":{"type":["string","null"]}}},"minItems":1},"components":{"type":"array","items":{"enum":["actuator","reducer","sensor","battery","controller","semiconductor","gripper","robot","software","material","camera","charging","display","motor","pcb","passive_component","wiring"]},"uniqueItems":true},"events":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","type","description","eventDate","claimBasis","status","participants","evidenceIds"],"properties":{"id":{"type":"string","minLength":1},"type":{"enum":["product_announcement","contract","funding","capacity_change","deployment","policy","research_result","security_disclosure","business_update","market_report"]},"description":{"type":"object","additionalProperties":false,"required":["ko","en"],"properties":{"ko":{"type":"string","minLength":1},"en":{"type":"string","minLength":1}}},"eventDate":{"type":["string","null"],"pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"claimBasis":{"enum":["official_announcement","company_claim","media_report","editorial_inference"]},"status":{"enum":["announced","planned","completed","reported","under_discussion"]},"participants":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["entityId","role","components"],"properties":{"entityId":{"type":"string","minLength":1},"role":{"enum":["supplier","customer","developer","investor","recipient","regulator","researcher","organizer","subject"]},"components":{"type":"array","items":{"enum":["actuator","reducer","sensor","battery","controller","semiconductor","gripper","robot","software","material","camera","charging","display","motor","pcb","passive_component","wiring"]},"uniqueItems":true}}},"minItems":1},"evidenceIds":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","minLength":1}}}},"minItems":1},"relationships":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["subjectId","predicate","objectId","component","status","claimBasis","evidenceIds"],"properties":{"subjectId":{"type":"string","minLength":1},"predicate":{"enum":["supplies_to","develops_with","invests_in","partners_with"]},"objectId":{"type":"string","minLength":1},"component":{"enum":["actuator","reducer","sensor","battery","controller","semiconductor","gripper","robot","software","material","camera","charging","display","motor","pcb","passive_component","wiring",null]},"status":{"enum":["confirmed","planned","under_discussion","inferred"]},"claimBasis":{"enum":["official_announcement","company_claim","media_report","editorial_inference"]},"evidenceIds":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","minLength":1}}}}},"metrics":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","value","unit","currency","period","qualifier","basis","claimBasis","evidenceIds"],"properties":{"name":{"type":"string","minLength":1},"value":{"type":"string","pattern":"^-?\\d+(?:\\.\\d+)?$"},"unit":{"type":"string","minLength":1},"currency":{"type":["string","null"]},"period":{"type":["string","null"]},"qualifier":{"enum":["exact","approximately","at_least","more_than","up_to"]},"basis":{"enum":["reported","target","forecast"]},"claimBasis":{"enum":["official_announcement","company_claim","media_report","editorial_inference"]},"evidenceIds":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","minLength":1}}}}},"evidence":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","url","publisher","publishedAt","sourceType","paraphrase","checkedAt","contentHash"],"properties":{"id":{"type":"string","minLength":1},"url":{"type":"string","pattern":"^https?://"},"publisher":{"type":"string","minLength":1},"publishedAt":{"type":["string","null"],"pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"sourceType":{"enum":["official","company","media","research"]},"paraphrase":{"type":"string","minLength":1},"checkedAt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?Z$"},"contentHash":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"minItems":1}}}}},"x-cors":{"origin":"*","credentials":false,"methods":["GET","OPTIONS"],"allowedHeaders":["PAYMENT-SIGNATURE","X-PAYMENT","X-402-Version","Authorization","Content-Type","Accept"],"exposedHeaders":["PAYMENT-REQUIRED","PAYMENT-RESPONSE","X-PAYMENT-RESPONSE","X-Day-Pass","X-Request-ID"]}}