{"openapi":"3.1.0","info":{"title":"Morty API","version":"1.0.0","summary":"Launch data, attention, verified funding and startup post-mortems in one index.","description":"Every endpoint is a public read except the two admin writes and the refresh trigger, which need the admin cookie from `POST /api/session`.\n\nAn idea is a technology and industry pair, with id `technology/industry`. Counts describe what is being launched publicly on the sources Morty reads, not the whole market: launch sites over-represent developer tools and indie products.\n\nFunding counts only deals verified against a source article that states the amount, so undefined rounds are counted but not summed. Post-mortem causes are AI-tagged from the Startups.RIP report and are evidence to investigate, not settled fact.\n\nEvery read response carries the window it was computed over plus source coverage, so a null or zero can be told apart from data that was never collected."},"servers":[{"url":"https://morty.jayasaisrikar.xyz","description":"Current origin"}],"tags":[{"name":"brief","description":"The whole index in one document."},{"name":"index","description":"Technology by industry grid, and one cell in detail."},{"name":"products","description":"Individual launches, their tags, metrics and funding."},{"name":"taxonomy","description":"The controlled vocabulary every tag comes from."},{"name":"sources","description":"What Morty reads and how far back each source covers."},{"name":"admin","description":"Writes. Requires the admin cookie."}],"paths":{"/api/brief":{"get":{"tags":["brief"],"operationId":"getBrief","summary":"The full brief: rankings, ideas, fields, funding, failures and coverage.","description":"One read with the whole picture. Around 130 KB of JSON, so request a smaller endpoint when you only need one section.","responses":{"200":{"description":"The complete brief.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Brief"}}}},"500":{"description":"The database read failed. The server log has the cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/brief/schema":{"get":{"tags":["brief"],"operationId":"getBriefSchema","summary":"JSON Schema (draft 2020-12) of the brief response.","responses":{"200":{"description":"A JSON Schema document.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/index":{"get":{"tags":["index"],"operationId":"getIndexMap","summary":"Technology by industry cells for one metric and window.","parameters":[{"$ref":"#/components/parameters/Metric"},{"$ref":"#/components/parameters/Range"},{"$ref":"#/components/parameters/Basis"},{"$ref":"#/components/parameters/Technology"},{"$ref":"#/components/parameters/Industry"},{"$ref":"#/components/parameters/UseCase"},{"$ref":"#/components/parameters/Source"}],"responses":{"200":{"description":"The grid, its totals and the coverage behind it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexMap"}}}},"400":{"description":"The query or body failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The database read failed. The server log has the cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/index/cell":{"get":{"tags":["index"],"operationId":"getIndexCell","summary":"One technology/industry selection: totals, time series and newest launches.","parameters":[{"$ref":"#/components/parameters/Metric"},{"$ref":"#/components/parameters/Range"},{"$ref":"#/components/parameters/Basis"},{"$ref":"#/components/parameters/Technology"},{"$ref":"#/components/parameters/Industry"},{"$ref":"#/components/parameters/UseCase"},{"$ref":"#/components/parameters/Source"},{"$ref":"#/components/parameters/Compare"},{"$ref":"#/components/parameters/Rank"}],"responses":{"200":{"description":"The selection summary, its activity series and the launches inside it.","content":{"application/json":{"schema":{"type":"object","required":["selection","series","products","window"],"properties":{"selection":{"$ref":"#/components/schemas/Selection"},"series":{"$ref":"#/components/schemas/Series"},"products":{"$ref":"#/components/schemas/ProductList"},"window":{"type":"object","required":["start","end"],"properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}}}}}}}},"400":{"description":"The query or body failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The database read failed. The server log has the cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/insights":{"get":{"tags":["index"],"operationId":"listInsights","summary":"The latest written insights for a scope.","parameters":[{"$ref":"#/components/parameters/InsightScope"}],"responses":{"200":{"description":"Insight rows and the scope they were read for.","content":{"application/json":{"schema":{"type":"object","required":["scope","insights"],"properties":{"scope":{"type":"string","enum":["overview"]},"insights":{"type":"array","items":{"$ref":"#/components/schemas/Insight"}}}}}}},"400":{"description":"The query or body failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The database read failed. The server log has the cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/products":{"get":{"tags":["products"],"operationId":"listProducts","summary":"Paginated product cards, filterable by tag, source, window and text.","parameters":[{"$ref":"#/components/parameters/Metric"},{"$ref":"#/components/parameters/Range"},{"$ref":"#/components/parameters/Basis"},{"$ref":"#/components/parameters/Technology"},{"$ref":"#/components/parameters/Industry"},{"$ref":"#/components/parameters/UseCase"},{"$ref":"#/components/parameters/Source"},{"$ref":"#/components/parameters/Search"},{"$ref":"#/components/parameters/Sort"},{"$ref":"#/components/parameters/Page"},{"$ref":"#/components/parameters/PageSize"},{"$ref":"#/components/parameters/ProductScope"}],"responses":{"200":{"description":"A page of cards plus the total that matched.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductList"}}}},"400":{"description":"The query or body failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The database read failed. The server log has the cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/products/{id}":{"get":{"tags":["products"],"operationId":"getProduct","summary":"One product with its tag provenance, metric timeline, funding and audit trail.","parameters":[{"$ref":"#/components/parameters/ProductId"}],"responses":{"200":{"description":"The product detail.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductDetail"}}}},"400":{"description":"The query or body failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The requested record does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The database read failed. The server log has the cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/products/{id}/categories":{"patch":{"tags":["admin"],"operationId":"updateProductCategories","summary":"Replace tags on one axis. Human edits are locked against the classifier.","parameters":[{"$ref":"#/components/parameters/ProductId"}],"security":[{"adminSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"technology":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"maxItems":8},"industry":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"maxItems":8,"minItems":1},"use_case":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"maxItems":8},"reason":{"type":"string","maxLength":300}},"description":"Provide at least one axis. Each array replaces that axis outright."}}}},"responses":{"200":{"description":"The edit was saved and snapshots were rebuilt.","content":{"application/json":{"schema":{"type":"object","required":["ok","productId"],"properties":{"ok":{"const":true},"productId":{"type":"integer"}}}}}},"400":{"description":"The query or body failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Admin mode is not unlocked. POST the token to /api/session first.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"The requested record does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The database read failed. The server log has the cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/sectors":{"get":{"tags":["taxonomy"],"operationId":"listSectors","summary":"Every active and suggested tag, grouped by axis, with its product count.","responses":{"200":{"description":"The taxonomy in use.","content":{"application/json":{"schema":{"type":"object","required":["version","technology","industry","useCase"],"properties":{"version":{"type":"string"},"technology":{"type":"array","items":{"$ref":"#/components/schemas/TaxonomyEntry"}},"industry":{"type":"array","items":{"$ref":"#/components/schemas/TaxonomyEntry"}},"useCase":{"type":"array","items":{"$ref":"#/components/schemas/TaxonomyEntry"}}}}}}},"500":{"description":"The database read failed. The server log has the cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/sources/status":{"get":{"tags":["sources"],"operationId":"listSourceStatus","summary":"Each source with its access status, coverage notes and last five runs.","responses":{"200":{"description":"Source rows, oldest first.","content":{"application/json":{"schema":{"type":"object","required":["sources"],"properties":{"sources":{"type":"array","items":{"$ref":"#/components/schemas/SourceRow"}}}}}}},"500":{"description":"The database read failed. The server log has the cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/session":{"get":{"tags":["admin"],"operationId":"getSession","summary":"Whether this client currently holds admin mode.","responses":{"200":{"description":"Admin flag for the caller.","content":{"application/json":{"schema":{"type":"object","required":["admin"],"properties":{"admin":{"type":"boolean"}}}}}}}},"post":{"tags":["admin"],"operationId":"createSession","summary":"Exchange the admin token for the admin cookie.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string","minLength":1,"maxLength":200}}}}}},"responses":{"200":{"description":"The cookie is set on this response.","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"const":true}}}}}},"400":{"description":"The query or body failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"The token does not match ADMIN_TOKEN.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["admin"],"operationId":"deleteSession","summary":"Clear the admin cookie.","responses":{"200":{"description":"The cookie is gone.","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"const":true}}}}}}}}},"/api/internal/refresh":{"post":{"tags":["admin"],"operationId":"triggerRefresh","summary":"Queue a pipeline pass. Returns before it runs.","security":[{"adminSession":[]}],"responses":{"202":{"description":"The pass is queued and starts after this response.","content":{"application/json":{"schema":{"type":"object","required":["ok","message"],"properties":{"ok":{"const":true},"message":{"type":"string"}}}}}},"401":{"description":"Admin mode is not unlocked. POST the token to /api/session first.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"A pipeline run already holds the lock.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Sources were fetched less than ten minutes ago.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The database read failed. The server log has the cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/admin/health":{"get":{"tags":["admin"],"operationId":"getHealth","summary":"AI run outcomes, possible duplicates, quarantined classifications.","security":[{"adminSession":[]}],"responses":{"200":{"description":"Pipeline health.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}},"401":{"description":"Admin mode is not unlocked. POST the token to /api/session first.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"The database read failed. The server log has the cause.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"adminSession":{"type":"apiKey","in":"cookie","name":"bi_admin","description":"Set by `POST /api/session`. Production cookies are `Secure`, so this only works over HTTPS."}},"parameters":{"Metric":{"name":"metric","in":"query","required":false,"description":"Which score the cells carry.","schema":{"type":"string","enum":["activity","attention","funding"],"default":"activity"}},"Range":{"name":"range","in":"query","required":false,"description":"Window the counts are taken over.","schema":{"type":"string","enum":["1d","7d","30d","180d"],"default":"30d"}},"Basis":{"name":"basis","in":"query","required":false,"description":"Date a product is placed on: its launch date or the day Morty first saw it.","schema":{"type":"string","enum":["launched","discovered"],"default":"launched"}},"Technology":{"name":"technology","in":"query","required":false,"description":"Technology slug from /api/sectors.","schema":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"}},"Industry":{"name":"industry","in":"query","required":false,"description":"Industry slug from /api/sectors.","schema":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"}},"UseCase":{"name":"useCase","in":"query","required":false,"description":"Use-case slug from /api/sectors.","schema":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"}},"Source":{"name":"source","in":"query","required":false,"description":"Restrict to one source slug.","schema":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"}},"Compare":{"name":"compare","in":"query","required":false,"description":"A second technology|industry selection to draw alongside the first.","schema":{"type":"string","pattern":"^[a-z0-9-]*\\|[a-z0-9-]*$"}},"Rank":{"name":"rank","in":"query","required":false,"description":"How the launches inside the cell are ordered.","schema":{"type":"string","enum":["attention","newest"],"default":"attention"}},"Search":{"name":"search","in":"query","required":false,"description":"Case-insensitive match on name or domain.","schema":{"type":"string","maxLength":80}},"Sort":{"name":"sort","in":"query","required":false,"schema":{"type":"string","enum":["newest","attention","uneed_votes","hn_points","github_stars"],"default":"newest"}},"Page":{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":1}},"PageSize":{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":5,"maximum":100,"default":25}},"ProductScope":{"name":"scope","in":"query","required":false,"description":"`index` keeps products that passed classification; `all` includes every ingested row.","schema":{"type":"string","enum":["index","all"],"default":"index"}},"InsightScope":{"name":"scope","in":"query","required":false,"schema":{"type":"string","enum":["overview"],"default":"overview"}},"ProductId":{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1}}},"schemas":{"Brief":{"type":"object","properties":{"version":{"type":"string","const":"morty-brief-v1"},"generatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"about":{"type":"object","properties":{"summary":{"type":"string"},"howToRead":{"type":"array","items":{"type":"string"}},"caveats":{"type":"array","items":{"type":"string"}}},"required":["summary","howToRead","caveats"],"additionalProperties":false},"windows":{"type":"object","properties":{"recent":{"type":"object","properties":{"start":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"end":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["start","end"],"additionalProperties":false},"funding":{"type":"object","properties":{"start":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"end":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["start","end"],"additionalProperties":false}},"required":["recent","funding"],"additionalProperties":false},"coverage":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"label":{"type":"string"},"coveredFrom":{"type":["string","null"]},"lastSuccessAt":{"type":["string","null"]}},"required":["slug","label","coveredFrom","lastSuccessAt"],"additionalProperties":false}},"products":{"type":"object","properties":{"classified":{"type":"integer","minimum":0,"maximum":9007199254740991},"pending":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["classified","pending"],"additionalProperties":false},"previousPeriodComparable":{"type":"boolean"},"verifiedDeals":{"type":"integer","minimum":0,"maximum":9007199254740991},"postmortems":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["sources","products","previousPeriodComparable","verifiedDeals","postmortems"],"additionalProperties":false},"rankings":{"type":"object","properties":{"mostBuilt":{"type":"array","items":{"type":"string"}},"fastestGrowing":{"type":"array","items":{"type":"string"}},"mostAttention":{"type":"array","items":{"type":"string"}},"mostFunded":{"type":"array","items":{"type":"string"}}},"required":["mostBuilt","fastestGrowing","mostAttention","mostFunded"],"additionalProperties":false},"ideas":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"technology":{"type":"object","properties":{"slug":{"type":"string"},"label":{"type":"string"}},"required":["slug","label"],"additionalProperties":false},"industry":{"type":"object","properties":{"slug":{"type":"string"},"label":{"type":"string"}},"required":["slug","label"],"additionalProperties":false},"products":{"type":"object","properties":{"last30d":{"type":"integer","minimum":0,"maximum":9007199254740991},"changePct":{"type":["number","null"]},"last180d":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["last30d","changePct","last180d"],"additionalProperties":false},"attention":{"type":"object","properties":{"percentile":{"type":["number","null"],"minimum":0,"maximum":100},"sample":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["percentile","sample"],"additionalProperties":false},"funding":{"type":"object","properties":{"deals":{"type":"integer","minimum":0,"maximum":9007199254740991},"disclosedUsd":{"type":["number","null"],"minimum":0},"undisclosed":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["deals","disclosedUsd","undisclosed"],"additionalProperties":false}},"required":["id","technology","industry","products","attention","funding"],"additionalProperties":false}},"fields":{"type":"array","items":{"type":"object","properties":{"axis":{"type":"string","enum":["technology","industry","use_case"]},"slug":{"type":"string"},"label":{"type":"string"},"products":{"type":"object","properties":{"last30d":{"type":"integer","minimum":0,"maximum":9007199254740991},"previous30d":{"type":"integer","minimum":0,"maximum":9007199254740991},"changePct":{"type":["number","null"]},"last180d":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["last30d","previous30d","changePct","last180d"],"additionalProperties":false},"funding":{"type":"object","properties":{"deals":{"type":"integer","minimum":0,"maximum":9007199254740991},"disclosedUsd":{"type":["number","null"],"minimum":0},"undisclosed":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["deals","disclosedUsd","undisclosed"],"additionalProperties":false}},"required":["axis","slug","label","products","funding"],"additionalProperties":false}},"funding":{"type":"object","properties":{"totals":{"type":"object","properties":{"deals":{"type":"integer","minimum":0,"maximum":9007199254740991},"disclosedUsd":{"type":["number","null"],"minimum":0},"undisclosed":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["deals","disclosedUsd","undisclosed"],"additionalProperties":false},"recentDeals":{"type":"array","items":{"type":"object","properties":{"company":{"type":"string"},"date":{"type":"string"},"amountUsd":{"type":["number","null"],"minimum":0},"round":{"type":["string","null"]},"technologies":{"type":"array","items":{"type":"string"}},"industries":{"type":"array","items":{"type":"string"}},"source":{"type":"string"}},"required":["company","date","amountUsd","round","technologies","industries","source"],"additionalProperties":false}}},"required":["totals","recentDeals"],"additionalProperties":false},"failures":{"type":"object","properties":{"companies":{"type":"integer","minimum":0,"maximum":9007199254740991},"shutDown":{"type":"integer","minimum":0,"maximum":9007199254740991},"acquired":{"type":"integer","minimum":0,"maximum":9007199254740991},"causes":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string","enum":["product_market_fit","distribution","monetization","retention","competition","technology","timing","team","capital","regulation","other"]},"label":{"type":"string"},"companies":{"type":"integer","minimum":0,"maximum":9007199254740991},"share":{"type":"number","minimum":0,"maximum":1}},"required":["category","label","companies","share"],"additionalProperties":false}},"examples":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"batch":{"type":["string","null"]},"outcome":{"type":"string","enum":["shut_down","acquired"]},"causes":{"type":"array","items":{"type":"string","enum":["product_market_fit","distribution","monetization","retention","competition","technology","timing","team","capital","regulation","other"]}},"whyItEnded":{"type":"string"},"differentToday":{"type":"array","items":{"type":"string"}},"url":{"type":"string"}},"required":["name","batch","outcome","causes","whyItEnded","differentToday","url"],"additionalProperties":false}}},"required":["companies","shutDown","acquired","causes","examples"],"additionalProperties":false},"insights":{"type":"array","items":{"type":"object","properties":{"headline":{"type":"string"},"body":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}},"generatedAt":{"type":"string"}},"required":["headline","body","caveats","generatedAt"],"additionalProperties":false}},"gaps":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"status":{"type":"string","enum":["unavailable","partial"]},"reason":{"type":"string"}},"required":["question","status","reason"],"additionalProperties":false}}},"required":["version","generatedAt","about","windows","coverage","rankings","ideas","fields","funding","failures","insights","gaps"],"additionalProperties":false},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Change":{"type":"object","required":["status"],"description":"Comparison against the previous period. `status` decides which other fields are present: `change` carries pct, previous and current; `new` carries current; `not_comparable` and `insufficient_history` carry a reason.","properties":{"status":{"type":"string","enum":["change","new","not_comparable","insufficient_history"]},"pct":{"type":"number"},"previous":{"type":"integer","minimum":0},"current":{"type":"integer","minimum":0},"reason":{"type":"string"}}},"Tag":{"type":"object","required":["slug","label"],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"label":{"type":"string"}}},"IndexCell":{"type":"object","required":["technology","industry","value","state","sampleSize","sources","change"],"properties":{"technology":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"industry":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"value":{"type":["number","null"]},"state":{"type":"string","enum":["value","zero","no_data","sparse"]},"sampleSize":{"type":"integer","minimum":0},"sources":{"type":"array","items":{"type":"string"}},"change":{"type":"object","required":["status"],"description":"Comparison against the previous period. `status` decides which other fields are present: `change` carries pct, previous and current; `new` carries current; `not_comparable` and `insufficient_history` carry a reason.","properties":{"status":{"type":"string","enum":["change","new","not_comparable","insufficient_history"]},"pct":{"type":"number"},"previous":{"type":"integer","minimum":0},"current":{"type":"integer","minimum":0},"reason":{"type":"string"}}},"disclosedUsd":{"type":["number","null"],"minimum":0},"undisclosed":{"type":"integer","minimum":0}}},"IndexMap":{"type":"object","required":["metric","label","unit","range","rangeLabel","basis","window","technologies","industries","hiddenIndustries","cells","totals","coverage","classification","verifiedDeals","generatedAt"],"properties":{"metric":{"type":"string","enum":["activity","attention","funding"]},"label":{"type":"string"},"unit":{"type":"string"},"range":{"type":"string","enum":["1d","7d","30d","180d"]},"rangeLabel":{"type":"string"},"basis":{"type":"string","enum":["launched","discovered"]},"window":{"type":"object","required":["start","end"],"properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}}},"technologies":{"type":"array","items":{"type":"object","required":["slug","label"],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"label":{"type":"string"}}}},"industries":{"type":"array","items":{"type":"object","required":["slug","label"],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"label":{"type":"string"}}}},"hiddenIndustries":{"type":"integer","minimum":0},"cells":{"type":"array","items":{"$ref":"#/components/schemas/IndexCell"}},"totals":{"type":"object","required":["uniqueProducts","change"],"properties":{"uniqueProducts":{"type":"integer","minimum":0},"change":{"type":["object","null"],"required":["status"],"description":"A period comparison, or null when the window has no coverage behind it.","properties":{"status":{"type":"string","enum":["change","new","not_comparable","insufficient_history"]},"pct":{"type":"number"},"previous":{"type":"integer","minimum":0},"current":{"type":"integer","minimum":0},"reason":{"type":"string"}}}}},"coverage":{"type":"object","required":["sources","covering","earliest","windowCovered"],"properties":{"sources":{"type":"array","items":{"$ref":"#/components/schemas/SourceCoverage"}},"covering":{"type":"array","items":{"type":"string"}},"earliest":{"type":["string","null"],"format":"date-time"},"windowCovered":{"type":"boolean"}}},"classification":{"type":"object","required":["classified","pending","quarantined"],"properties":{"classified":{"type":"integer","minimum":0},"pending":{"type":"integer","minimum":0},"quarantined":{"type":"integer","minimum":0}}},"verifiedDeals":{"type":"integer","minimum":0},"calculationVersion":{"type":"string"},"taxonomyVersion":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}}},"SourceCoverage":{"type":"object","required":["slug","label","enabled","coveredFrom","coveredTo","lastSuccessAt","lastError"],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"label":{"type":"string"},"enabled":{"type":"boolean"},"coveredFrom":{"type":["string","null"],"format":"date-time"},"coveredTo":{"type":["string","null"],"format":"date-time"},"lastSuccessAt":{"type":["string","null"],"format":"date-time"},"lastError":{"type":["string","null"]}}},"BreakdownRow":{"type":"object","required":["slug","label","status","count"],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"label":{"type":"string"},"status":{"type":"string"},"count":{"type":"integer","minimum":0}}},"Series":{"type":"object","required":["bucket","points"],"properties":{"bucket":{"type":"string","enum":["hour","day","week"]},"points":{"type":"array","items":{"type":"object","required":["at","count","covered"],"properties":{"at":{"type":"string","format":"date-time"},"count":{"type":["integer","null"],"minimum":0},"covered":{"type":"boolean","description":"False when no source was collecting during this bucket, which is why `count` is null."}}}}}},"ProductCard":{"type":"object","required":["id","name","domain","website","summary","description","launchAt","launchBasis","firstSeenAt","classificationStatus","tags","listings","metrics"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"domain":{"type":["string","null"]},"website":{"type":["string","null"]},"summary":{"type":["string","null"]},"description":{"type":["string","null"]},"launchAt":{"type":["string","null"],"format":"date-time"},"launchBasis":{"type":["string","null"]},"firstSeenAt":{"type":"string","format":"date-time"},"classificationStatus":{"type":"string"},"attention":{"type":["object","null"],"additionalProperties":true,"description":"Present on list responses that sort by attention; null for a product with too few readings."},"tags":{"type":"array","items":{"type":"object","required":["slug","label","axis","origin","confidence","status"],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"label":{"type":"string"},"axis":{"type":"string","enum":["technology","industry","use_case"]},"origin":{"type":"string","enum":["ai","human"]},"confidence":{"type":["number","null"]},"status":{"type":"string"}}}},"listings":{"type":"array","items":{"type":"object","required":["source","sourceLabel","url","publishedAt"],"properties":{"source":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"sourceLabel":{"type":"string"},"url":{"type":"string"},"publishedAt":{"type":["string","null"],"format":"date-time"}}}},"metrics":{"type":"array","items":{"type":"object","required":["source","key","unit","value","observedAt"],"properties":{"source":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"key":{"type":"string"},"unit":{"type":"string"},"value":{"type":["number","null"]},"observedAt":{"type":"string","format":"date-time"}}}}}},"ProductList":{"type":"object","required":["total","page","pageSize","sort","items"],"properties":{"total":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":1},"pageSize":{"type":"integer","minimum":5,"maximum":100},"sort":{"type":"string","enum":["newest","attention","uneed_votes","hn_points","github_stars"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/ProductCard"}}}},"ProductDetail":{"type":"object","required":["id","name","domain","website","summary","description","launchAt","launchBasis","firstSeenAt","classificationStatus","tags","listings","metrics","repository","uncertainties","tagDetails","timeline","funding","records","audit","signals"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"domain":{"type":["string","null"]},"website":{"type":["string","null"]},"summary":{"type":["string","null"]},"description":{"type":["string","null"]},"launchAt":{"type":["string","null"],"format":"date-time"},"launchBasis":{"type":["string","null"]},"firstSeenAt":{"type":"string","format":"date-time"},"classificationStatus":{"type":"string"},"attention":{"type":["object","null"],"additionalProperties":true,"description":"Present on list responses that sort by attention; null for a product with too few readings."},"tags":{"type":"array","items":{"type":"object","required":["slug","label","axis","origin","confidence","status"],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"label":{"type":"string"},"axis":{"type":"string","enum":["technology","industry","use_case"]},"origin":{"type":"string","enum":["ai","human"]},"confidence":{"type":["number","null"]},"status":{"type":"string"}}}},"listings":{"type":"array","items":{"type":"object","required":["source","sourceLabel","url","publishedAt"],"properties":{"source":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"sourceLabel":{"type":"string"},"url":{"type":"string"},"publishedAt":{"type":["string","null"],"format":"date-time"}}}},"metrics":{"type":"array","items":{"type":"object","required":["source","key","unit","value","observedAt"],"properties":{"source":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"key":{"type":"string"},"unit":{"type":"string"},"value":{"type":["number","null"]},"observedAt":{"type":"string","format":"date-time"}}}},"repository":{"type":["string","null"]},"uncertainties":{"type":"array","items":{"type":"string"}},"tagDetails":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"label":{"type":"string"},"axis":{"type":"string","enum":["technology","industry","use_case"]},"status":{"type":"string"},"origin":{"type":"string","enum":["ai","human"]},"confidence":{"type":["number","null"]},"reason":{"type":["string","null"]},"modelVersion":{"type":["string","null"]},"locked":{"type":"boolean"},"evidenceUrl":{"type":["string","null"]}}}},"timeline":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"key":{"type":"string"},"unit":{"type":"string"},"value":{"type":["number","null"]},"day":{"type":"string","format":"date"},"methodology":{"type":"string"}}}},"funding":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"date":{"type":"string","format":"date"},"status":{"type":"string"},"amount":{"type":["number","null"]},"currency":{"type":["string","null"]},"round":{"type":["string","null"]},"url":{"type":"string"}}}},"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"source":{"type":"string"},"externalId":{"type":"string"},"url":{"type":"string"},"publishedAt":{"type":["string","null"],"format":"date-time"},"lastSeenAt":{"type":"string","format":"date-time"},"matchMethod":{"type":"string"}}}},"audit":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"after":{"type":"array","items":{"type":"string"}},"reason":{"type":["string","null"]},"editedAt":{"type":"string","format":"date-time"}}}},"signals":{"type":"array","items":{"type":"object","required":["at","kind","title","detail","url"],"properties":{"at":{"type":"string","format":"date-time"},"kind":{"type":"string","enum":["launch","metric","funding","edit"]},"title":{"type":"string"},"detail":{"type":["string","null"]},"url":{"type":["string","null"]}}}}}},"Selection":{"type":"object","required":["technology","industry","products","attention","change","useCases","spread"],"properties":{"technology":{"type":["string","null"]},"industry":{"type":["string","null"]},"products":{"type":"integer","minimum":0},"attention":{"type":"object","required":["value","scored"],"properties":{"value":{"type":["integer","null"],"minimum":0},"scored":{"type":"integer","minimum":0}}},"change":{"type":["object","null"],"required":["status"],"description":"A period comparison, or null when the window has no coverage behind it.","properties":{"status":{"type":"string","enum":["change","new","not_comparable","insufficient_history"]},"pct":{"type":"number"},"previous":{"type":"integer","minimum":0},"current":{"type":"integer","minimum":0},"reason":{"type":"string"}}},"useCases":{"type":"array","items":{"$ref":"#/components/schemas/BreakdownRow"}},"spread":{"type":"object","required":["axis","mode","rows"],"properties":{"axis":{"type":"string","enum":["technology","industry"]},"mode":{"type":"string","enum":["split","also"]},"rows":{"type":"array","items":{"$ref":"#/components/schemas/BreakdownRow"}}}}}},"TaxonomyEntry":{"type":"object","required":["slug","label","axis","status","products"],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"label":{"type":"string"},"axis":{"type":"string","enum":["technology","industry","use_case"]},"status":{"type":"string"},"products":{"type":"integer","minimum":0}}},"Insight":{"type":"object","required":["id","headline","body","caveats","refs","model","generatedAt"],"properties":{"id":{"type":"integer"},"headline":{"type":"string"},"body":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}},"refs":{"type":"array","items":{"type":"object","additionalProperties":true}},"model":{"type":"string"},"generatedAt":{"type":"string"}}},"IngestionRun":{"type":"object","properties":{"id":{"type":"integer"},"startedAt":{"type":"string","format":"date-time"},"endedAt":{"type":["string","null"],"format":"date-time"},"status":{"type":"string"},"fetched":{"type":"integer","minimum":0},"inserted":{"type":"integer","minimum":0},"updated":{"type":"integer","minimum":0},"requests":{"type":"integer","minimum":0},"errorCount":{"type":"integer","minimum":0},"firstError":{"type":["string","null"]},"windowStart":{"type":"string","format":"date-time"},"windowEnd":{"type":"string","format":"date-time"}}},"SourceRow":{"type":"object","required":["slug","label","url","accessMethod","enabled","accessStatus","rateLimitPolicy","usageNotes","coverageNotes","lastSuccessAt","lastError","records","candidates","products"],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{1,60}$"},"label":{"type":"string"},"url":{"type":"string"},"accessMethod":{"type":"string"},"enabled":{"type":"boolean"},"accessStatus":{"type":"string"},"rateLimitPolicy":{"type":"string"},"usageNotes":{"type":"string"},"coverageNotes":{"type":"string"},"lastSuccessAt":{"type":["string","null"],"format":"date-time"},"lastError":{"type":["string","null"]},"records":{"type":"integer","minimum":0},"candidates":{"type":"integer","minimum":0},"products":{"type":"integer","minimum":0},"runs":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":"integer"},"startedAt":{"type":"string","format":"date-time"},"endedAt":{"type":["string","null"],"format":"date-time"},"status":{"type":"string"},"fetched":{"type":"integer","minimum":0},"inserted":{"type":"integer","minimum":0},"updated":{"type":"integer","minimum":0},"requests":{"type":"integer","minimum":0},"errorCount":{"type":"integer","minimum":0},"firstError":{"type":["string","null"]},"windowStart":{"type":"string","format":"date-time"},"windowEnd":{"type":"string","format":"date-time"}}}}}},"Health":{"type":"object","required":["ai","possibleDuplicates","quarantined","classification"],"properties":{"ai":{"type":"array","items":{"type":"object","properties":{"task":{"type":"string"},"status":{"type":"string"},"count":{"type":"integer","minimum":0},"promptTokens":{"type":["integer","null"],"minimum":0},"completionTokens":{"type":["integer","null"],"minimum":0},"avgLatencyMs":{"type":["integer","null"],"minimum":0}}}},"possibleDuplicates":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"products":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"domain":{"type":["string","null"]},"repository":{"type":["string","null"]}}}}}}},"quarantined":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"errors":{"type":["array","null"],"items":{"type":"string"}}}}},"classification":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string"},"count":{"type":"integer","minimum":0}}}}}}}}}