{
  "openapi": "3.1.0",
  "info": {
    "title": "Emerging API",
    "version": "1.0.0",
    "summary": "Frontier technologies by field: stage with dated evidence, momentum from real counts, weekly snapshots, and the companies, researchers, labs, papers, patents, rounds and events behind each, every row sourced. It grows every day",
    "description": "Frontier technologies by field: stage with dated evidence, momentum from real counts, weekly snapshots, and the companies, researchers, labs, papers, patents, rounds and events behind each, every row sourced. It grows every day. Scanned daily at 05:50 UTC, recounted Tuesdays at 12:50 UTC. Free to read; please cite \"Emerging (emerging.fru.dev)\" with a link. Responses are cached at the edge; keep to about 60 requests a minute. Guide: https://emerging.fru.dev/agents",
    "contact": {
      "name": "fru.dev",
      "url": "https://fru.dev",
      "email": "fru.dev3@gmail.com"
    }
  },
  "externalDocs": {
    "description": "For AI agents",
    "url": "https://emerging.fru.dev/agents"
  },
  "servers": [
    {
      "url": "https://emerging.fru.dev"
    }
  ],
  "paths": {
    "/api/technologies": {
      "get": {
        "operationId": "list_technologies",
        "summary": "Every tracked technology with its stage, evidence, momentum and counts",
        "description": "Every tracked technology with its stage, evidence, momentum and counts. Returns technologies with slug, name, definition, sub-areas, stage (research, prototype, pilot, early-commercial) with evidence, date and source, metrics (papers in the last 3 months, paper growth, funding in the last 12 months, events in the last 90 days, momentum 0 to 100) and counts.",
        "parameters": [
          {
            "name": "stage",
            "in": "query",
            "required": false,
            "description": "Only this stage",
            "schema": {
              "type": "string",
              "enum": [
                "research",
                "prototype",
                "pilot",
                "early-commercial"
              ]
            },
            "example": "prototype"
          }
        ],
        "responses": {
          "200": {
            "description": "technologies with slug, name, definition, sub-areas, stage (research, prototype, pilot, early-commercial) with evidence, date and source, metrics (papers in the last 3 months, paper growth, funding in the last 12 months, events in the last 90 days, momentum 0 to 100) and counts",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "technologies": [
                    {
                      "slug": "fusion-energy",
                      "name": "Fusion energy",
                      "definition": "Making power by fusing light atoms like hydrogen isotopes, the process that fuels the sun, with no long-lived waste.",
                      "subareas": [
                        "Magnetic confinement tokamaks",
                        "Stellarators"
                      ],
                      "stage": "prototype",
                      "stage_evidence": "No machine has made net electricity yet; NIF has repeated ignition, with a record 8.6 MJ yield and target gain of 4.13 in 2025.",
                      "stage_date": "2026-06-20",
                      "stage_source": "https://lasers.llnl.gov/science/achieving-fusion-ignition",
                      "metrics": {
                        "papers3m": 486,
                        "papers12m": 1875,
                        "growth": 47.2,
                        "funding12m": 2302,
                        "rounds12m": 6,
                        "events90d": 11,
                        "ranks": {
                          "papers": 81,
                          "funding": 56,
                          "events": 81
                        },
                        "momentum": 73
                      },
                      "counts": {
                        "companies": 21,
                        "candidates": 0,
                        "researchers": 10,
                        "labs": 21,
                        "papers": 25,
                        "patents": 6,
                        "rounds": 9,
                        "events": 26
                      },
                      "latest_event": {
                        "date": "2026-09-22",
                        "title": "First Light Fusion M3 experiments show target-led fuel compression",
                        "url": "https://firstlightfusion.com/media/first-light-fusion-achieves-major-step-forward-for-flare-proving-key-low-cost-fusion-principle/",
                        "kind": "breakthrough"
                      },
                      "url": "https://emerging.fru.dev/tech/fusion-energy"
                    }
                  ],
                  "total": 1,
                  "built_at": "2026-09-25 01:55:04",
                  "note": "momentum: mean of three ranks across the tracked fields (paper growth, funding in the last 12 months, events in the last 90 days); see /m..."
                }
              }
            }
          }
        }
      }
    },
    "/api/technologies/{slug}": {
      "get": {
        "operationId": "get_technology",
        "summary": "One technology with its monthly paper counts and weekly snapshots",
        "description": "One technology with its monthly paper counts and weekly snapshots. Returns the technology with series (monthly paper counts, oldest first), weeks (weekly snapshots), metrics, counts and the latest event.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "Technology slug, as in /tech/<slug>",
            "schema": {
              "type": "string"
            },
            "example": "fusion-energy"
          }
        ],
        "responses": {
          "200": {
            "description": "the technology with series (monthly paper counts, oldest first), weeks (weekly snapshots), metrics, counts and the latest event",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "technology": {
                    "slug": "fusion-energy",
                    "name": "Fusion energy",
                    "definition": "Making power by fusing light atoms like hydrogen isotopes, the process that fuels the sun, with no long-lived waste.",
                    "subareas": [
                      "Magnetic confinement tokamaks",
                      "Stellarators"
                    ],
                    "stage": "prototype",
                    "stageEvidence": "No machine has made net electricity yet; NIF has repeated ignition, with a record 8.6 MJ yield and target gain of 4.13 in 2025.",
                    "stageDate": "2026-06-20",
                    "stageSource": "https://lasers.llnl.gov/science/achieving-fusion-ignition",
                    "note": "",
                    "noteAt": "",
                    "counts": {
                      "companies": 21,
                      "candidates": 0,
                      "researchers": 10,
                      "labs": 21,
                      "papers": 25,
                      "patents": 6,
                      "rounds": 9,
                      "events": 26
                    },
                    "series": [
                      {
                        "month": "2024-09",
                        "count": 74
                      },
                      {
                        "month": "2024-10",
                        "count": 87
                      }
                    ],
                    "metrics": {
                      "papers3m": 486,
                      "papers12m": 1875,
                      "growth": 47.2,
                      "funding12m": 2302,
                      "rounds12m": 6,
                      "events90d": 11,
                      "ranks": {
                        "papers": 81,
                        "funding": 56,
                        "events": 81
                      },
                      "momentum": 73
                    },
                    "latest": {
                      "date": "2026-09-22",
                      "title": "First Light Fusion M3 experiments show target-led fuel compression",
                      "url": "https://firstlightfusion.com/media/first-light-fusion-achieves-major-step-forward-for-flare-proving-key-low-cost-fusion-principle/",
                      "kind": "breakthrough"
                    }
                  },
                  "note": "Every row carries its source URL, source type, first and last seen dates and a verified flag. Rows the scan found are unverified until a ..."
                }
              }
            }
          },
          "404": {
            "description": "Not found"
          }
        }
      }
    },
    "/api/events": {
      "get": {
        "operationId": "list_events",
        "summary": "Dated milestones, breakthroughs, products, deals, policy and filings, newest first",
        "description": "Dated milestones, breakthroughs, products, deals, policy and filings, newest first. Returns events with date, kind, title, summary, source URL and type, technologies, company slugs, first seen and verified.",
        "parameters": [
          {
            "name": "tech",
            "in": "query",
            "required": false,
            "description": "Only this technology (slug; new fields are added over time, see /api/technologies)",
            "schema": {
              "type": "string"
            },
            "example": "fusion-energy"
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "description": "Only this kind",
            "schema": {
              "type": "string",
              "enum": [
                "breakthrough",
                "milestone",
                "product",
                "announcement",
                "policy",
                "deal",
                "funding",
                "filing"
              ]
            },
            "example": "breakthrough"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only events dated or first seen at or after this date (YYYY-MM-DD)",
            "schema": {
              "type": "string"
            },
            "example": "2026-09-01"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "events with date, kind, title, summary, source URL and type, technologies, company slugs, first seen and verified",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "events": [
                    {
                      "sourceUrl": "https://firstlightfusion.com/media/first-light-fusion-achieves-major-step-forward-for-flare-proving-key-low-cost-fusion-principle/",
                      "sourceType": "official",
                      "origin": "seed",
                      "firstSeen": "2026-09-25 01:35:28",
                      "lastSeen": "2026-09-25 01:55:03",
                      "verified": true,
                      "id": 161,
                      "date": "2026-09-22",
                      "kind": "breakthrough",
                      "title": "First Light Fusion M3 experiments show target-led fuel compression",
                      "summary": "Fuel was compressed using a simpler, lower power driver.",
                      "sourceName": "",
                      "techs": [
                        "fusion-energy"
                      ],
                      "companies": [
                        "first-light-fusion"
                      ]
                    },
                    {
                      "sourceUrl": "https://www.fusionindustryassociation.org/fia-gives-evidence-to-uk-parliament-on-national-policy-statement-for-fusion-energy-generation/?...",
                      "sourceType": "official",
                      "origin": "rss:fia",
                      "firstSeen": "2026-09-25 01:39:40",
                      "lastSeen": "2026-09-25 01:42:35",
                      "verified": false,
                      "id": 416,
                      "date": "2026-09-10",
                      "kind": "policy",
                      "title": "FIA Gives Evidence to UK Parliament on National Policy Statement for Fusion Energy Generation",
                      "summary": "On 9 September, Fusion Industry Association UK Director Tris Denton gave evidence to Parliament’s Energy Security and Net Zero (ESNZ) Sel...",
                      "sourceName": "Fusion Industry Association",
                      "techs": [
                        "fusion-energy"
                      ],
                      "companies": []
                    }
                  ],
                  "total": 26,
                  "limit": 3,
                  "offset": 0,
                  "next": "/api/events?tech=fusion-energy&limit=3&offset=3",
                  "note": "Every row carries its source URL, source type, first and last seen dates and a verified flag. Rows the scan found are unverified until a ..."
                }
              }
            }
          }
        }
      }
    },
    "/api/companies": {
      "get": {
        "operationId": "list_companies",
        "summary": "Every company shown, with its role per technology and dated items (the companies.fru.dev registry feed)",
        "description": "Every company shown, with its role per technology and dated items (the companies.fru.dev registry feed). Returns companies with slug (companies.fru.dev slug rule), name, domain, in_registry, status (tracked or candidate), the page here, technologies with role and source, first seen, and items (events and funding) each with type, date, title, URL and source.",
        "parameters": [
          {
            "name": "tech",
            "in": "query",
            "required": false,
            "description": "Only this technology (slug; new fields are added over time, see /api/technologies)",
            "schema": {
              "type": "string"
            },
            "example": "fusion-energy"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only companies first seen, updated or with an item at or after this date (YYYY-MM-DD)",
            "schema": {
              "type": "string"
            },
            "example": "2026-09-01"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "companies with slug (companies.fru.dev slug rule), name, domain, in_registry, status (tracked or candidate), the page here, technologies with role and source, first seen, and items (events and funding) each with type, date, title, URL and source",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "companies": [
                    {
                      "slug": "avalanche-energy",
                      "name": "Avalanche Energy",
                      "domain": "avalanche.energy",
                      "in_registry": false,
                      "status": "tracked",
                      "url": "https://emerging.fru.dev/companies/avalanche-energy",
                      "technologies": [
                        {
                          "slug": "fusion-energy",
                          "name": "Fusion energy",
                          "role": "Builds compact Orbitron fusion devices and a neutron test facility.",
                          "source": "https://avalanche.energy/"
                        }
                      ],
                      "first_seen": "2026-09-25 01:35:28",
                      "source_url": "https://avalanche.energy/",
                      "verified": true,
                      "items": [
                        {
                          "type": "funding",
                          "date": "2026-02-03",
                          "title": "Avalanche Energy: Venture $29M",
                          "url": "https://emerging.fru.dev/companies/avalanche-energy",
                          "source": "https://avalanche.energy/news-release/avalanche-energy-raises-29-million-following-plasma-physics-breakthroughs",
                          "verified": true
                        }
                      ],
                      "updated": "2026-09-25"
                    },
                    {
                      "slug": "commonwealth-fusion-systems",
                      "name": "Commonwealth Fusion Systems",
                      "domain": "cfs.energy",
                      "in_registry": false,
                      "status": "tracked",
                      "url": "https://emerging.fru.dev/companies/commonwealth-fusion-systems",
                      "technologies": [
                        {
                          "slug": "advanced-materials",
                          "name": "Advanced materials",
                          "role": "Manufactures high-temperature superconducting magnets for compact fusion tokamaks.",
                          "source": "https://www.cfs.energy/"
                        },
                        {
                          "slug": "fusion-energy",
                          "name": "Fusion energy",
                          "role": "Builds the SPARC tokamak and ARC power plant using high-temperature superconducting magnets.",
                          "source": "https://cfs.energy/"
                        }
                      ],
                      "first_seen": "2026-09-25 01:35:27",
                      "source_url": "https://www.cfs.energy/",
                      "verified": true,
                      "items": [
                        {
                          "type": "funding",
                          "date": "2026-07-30",
                          "title": "Commonwealth Fusion Systems: Equity financing $1000M",
                          "url": "https://emerging.fru.dev/companies/commonwealth-fusion-systems",
                          "source": "https://cfs.energy/news-and-media/commonwealth-fusion-systems-raises-another-1-billion-bringing-total-capital-raised-to-4-billion/",
                          "verified": true
                        },
                        {
                          "type": "event_milestone",
                          "date": "2026-04-28",
                          "title": "CFS applies to connect ARC to the PJM grid",
                          "url": "https://emerging.fru.dev/companies/commonwealth-fusion-systems",
                          "source": "https://cfs.energy/news-and-media/commonwealth-fusion-systems-becomes-first-fusion-company-to-apply-to-pjm-interconnection-the-largest-u....",
                          "verified": true
                        }
                      ],
                      "updated": "2026-09-25"
                    }
                  ],
                  "total": 21,
                  "limit": 2,
                  "offset": 0,
                  "next": "/api/companies?tech=fusion-energy&limit=2&offset=2"
                }
              }
            }
          }
        }
      }
    },
    "/api/rounds": {
      "get": {
        "operationId": "list_rounds",
        "summary": "Funding rounds of companies in these fields",
        "description": "Funding rounds of companies in these fields. Returns rounds with company, date, round, amount and valuation in millions of USD as reported, lead investors, technologies, source and verified.",
        "parameters": [
          {
            "name": "tech",
            "in": "query",
            "required": false,
            "description": "Only this technology (slug; new fields are added over time, see /api/technologies)",
            "schema": {
              "type": "string"
            },
            "example": "fusion-energy"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only rounds dated at or after this date",
            "schema": {
              "type": "string"
            },
            "example": "2026-01-01"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "rounds with company, date, round, amount and valuation in millions of USD as reported, lead investors, technologies, source and verified",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "rounds": [
                    {
                      "sourceUrl": "https://www.xpeng.com/pressroom/news/01a03797fccda01e0de68a02a256006a",
                      "sourceType": "sibling",
                      "origin": "funding.fru.dev",
                      "firstSeen": "2026-09-25 01:39:26",
                      "lastSeen": "2026-09-25 01:39:26",
                      "verified": true,
                      "id": "xpeng-robotics-2026-08-24-series-a",
                      "company": "xpeng-robotics",
                      "companyName": "XPENG Robotics",
                      "domain": "xpeng.com",
                      "date": "2026-08-24",
                      "round": "Series A",
                      "amountUsd": 900,
                      "amountOriginal": ""
                    },
                    {
                      "sourceUrl": "https://law.asia/unitree-star-market-debut/",
                      "sourceType": "press",
                      "origin": "seed",
                      "firstSeen": "2026-09-25 01:35:28",
                      "lastSeen": "2026-09-25 01:55:03",
                      "verified": true,
                      "id": "unitree-robotics-2026-08-19-ipo-shanghai-star-market",
                      "company": "unitree-robotics",
                      "companyName": "Unitree Robotics",
                      "domain": "unitree.com",
                      "date": "2026-08-19",
                      "round": "IPO (Shanghai STAR Market)",
                      "amountUsd": 906,
                      "amountOriginal": "RMB 6.1 billion"
                    }
                  ],
                  "total": 11,
                  "limit": 3,
                  "offset": 0,
                  "next": "/api/rounds?tech=humanoid-robots&limit=3&offset=3",
                  "note": "amountUsd and valuationUsd are millions of USD as reported by the source; not investment advice."
                }
              }
            }
          }
        }
      }
    },
    "/api/papers": {
      "get": {
        "operationId": "list_papers",
        "summary": "Papers per technology, newest first: OpenAlex most-cited and arXiv new submissions",
        "description": "Papers per technology, newest first: OpenAlex most-cited and arXiv new submissions. Returns papers with title, date, venue, authors, DOI, arXiv id, citations, link, technologies and first seen.",
        "parameters": [
          {
            "name": "tech",
            "in": "query",
            "required": false,
            "description": "Only this technology (slug; new fields are added over time, see /api/technologies)",
            "schema": {
              "type": "string"
            },
            "example": "fusion-energy"
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only papers first seen at or after this date",
            "schema": {
              "type": "string"
            },
            "example": "2026-09-01"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "papers with title, date, venue, authors, DOI, arXiv id, citations, link, technologies and first seen",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "papers": [
                    {
                      "id": "arxiv:2609.26880",
                      "title": "Bosonic Error Correction with Fluxonium",
                      "published": "2026-09-24",
                      "venue": "arXiv quant-ph",
                      "authors": [
                        "Shantanu R. Jha",
                        "Shoumik D. Chowdhury"
                      ],
                      "doi": "",
                      "arxiv": "2609.26880",
                      "cited": 0,
                      "url": "https://arxiv.org/abs/2609.26880",
                      "papers_fru": "",
                      "origin": "arxiv",
                      "first_seen": "2026-09-25 01:40:11",
                      "techs": [
                        "quantum-computing"
                      ]
                    },
                    {
                      "id": "arxiv:2609.26898",
                      "title": "The logical set of Gaussian states under the stabilizer subsystem decomposition",
                      "published": "2026-09-24",
                      "venue": "arXiv quant-ph",
                      "authors": [
                        "Santiago Zamora",
                        "Kaustav Chatterjee"
                      ],
                      "doi": "",
                      "arxiv": "2609.26898",
                      "cited": 0,
                      "url": "https://arxiv.org/abs/2609.26898",
                      "papers_fru": "",
                      "origin": "arxiv",
                      "first_seen": "2026-09-25 01:40:11",
                      "techs": [
                        "quantum-computing"
                      ]
                    }
                  ],
                  "limit": 3,
                  "offset": 0,
                  "next": "/api/papers?tech=quantum-computing&limit=3&offset=3"
                }
              }
            }
          }
        }
      }
    },
    "/api/researchers": {
      "get": {
        "operationId": "list_researchers",
        "summary": "The researchers publishing most in each field over the last 24 months (OpenAlex)",
        "description": "The researchers publishing most in each field over the last 24 months (OpenAlex). Returns researchers with OpenAlex id, name, ORCID, institution, country, works and citations, h-index, and works per technology.",
        "parameters": [
          {
            "name": "tech",
            "in": "query",
            "required": false,
            "description": "Only this technology (slug; new fields are added over time, see /api/technologies)",
            "schema": {
              "type": "string"
            },
            "example": "fusion-energy"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "researchers with OpenAlex id, name, ORCID, institution, country, works and citations, h-index, and works per technology",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "researchers": [
                    {
                      "sourceUrl": "https://openalex.org/A5018676117",
                      "sourceType": "paper",
                      "origin": "openalex",
                      "firstSeen": "2026-09-25 01:38:11",
                      "lastSeen": "2026-09-25 01:38:11",
                      "verified": false,
                      "id": "A5018676117",
                      "name": "Andrzej S Cichocki",
                      "orcid": "0000-0002-8364-7226",
                      "institution": "Warsaw University of Technology",
                      "country": "PL",
                      "worksTotal": 1259,
                      "cited": 52270,
                      "hIndex": 108
                    },
                    {
                      "sourceUrl": "https://openalex.org/A5032110460",
                      "sourceType": "paper",
                      "origin": "openalex",
                      "firstSeen": "2026-09-25 01:38:11",
                      "lastSeen": "2026-09-25 01:38:11",
                      "verified": false,
                      "id": "A5032110460",
                      "name": "Leigh R. Hochberg",
                      "orcid": "0000-0003-0261-2273",
                      "institution": "Allen Institute for Brain Science",
                      "country": "US",
                      "worksTotal": 269,
                      "cited": 21911,
                      "hIndex": 62
                    }
                  ],
                  "total": 15,
                  "limit": 3,
                  "offset": 0,
                  "next": "/api/researchers?tech=brain-computer-interfaces&limit=3&offset=3",
                  "note": "Ranked by works in the field in the last 24 months (OpenAlex)."
                }
              }
            }
          }
        }
      }
    },
    "/api/snapshots": {
      "get": {
        "operationId": "list_snapshots",
        "summary": "The compounding history: weekly snapshots and monthly paper counts per technology",
        "description": "The compounding history: weekly snapshots and monthly paper counts per technology. Returns per technology: weeks (momentum, papers, funding, events, companies per week) and months (paper counts).",
        "parameters": [
          {
            "name": "tech",
            "in": "query",
            "required": false,
            "description": "Only this technology (slug; new fields are added over time, see /api/technologies)",
            "schema": {
              "type": "string"
            },
            "example": "fusion-energy"
          }
        ],
        "responses": {
          "200": {
            "description": "per technology: weeks (momentum, papers, funding, events, companies per week) and months (paper counts)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "snapshots": [
                    {
                      "tech": "6g",
                      "name": "6G wireless",
                      "weeks": [],
                      "months": [
                        {
                          "month": "2024-09",
                          "count": 153
                        },
                        {
                          "month": "2024-10",
                          "count": 190
                        }
                      ]
                    }
                  ],
                  "note": "weeks: one row per field per week, append-only. months: monthly paper counts (OpenAlex, Crossref-indexed journal and conference papers)."
                }
              }
            }
          }
        }
      }
    },
    "/api/changes": {
      "get": {
        "operationId": "list_changes",
        "summary": "The append-only history: companies, rounds and fields added, stages and roles that changed, events verified",
        "description": "The append-only history: companies, rounds and fields added, stages and roles that changed, events verified. Returns changes with time, item type, item, technology, field, old and new value, source URL and who made it (seed, scan, weekly, admin).",
        "parameters": [
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Only changes at or after this date (YYYY-MM-DD)",
            "schema": {
              "type": "string"
            },
            "example": "2026-09-01"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Items per page, 1 to 200",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 200
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Items to skip, for the next page",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "changes with time, item type, item, technology, field, old and new value, source URL and who made it (seed, scan, weekly, admin)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "changes": [
                    {
                      "at": "2026-09-25 01:46:59",
                      "type": "technology",
                      "item": "solid-state-batteries",
                      "tech": "solid-state-batteries",
                      "field": "name",
                      "old": "Solid-state and next-generation batteries",
                      "new": "Next-gen batteries",
                      "source": "https://factorialenergy.com/press-releases/stellantis-and-factorial-integrate-advanced-solid-state-battery-into-stellantis-development-ve...",
                      "by": "seed"
                    },
                    {
                      "at": "2026-09-25 01:46:59",
                      "type": "technology",
                      "item": "quantum-sensing",
                      "tech": "quantum-sensing",
                      "field": "name",
                      "old": "Quantum sensing and networking",
                      "new": "Quantum sensing",
                      "source": "https://investors.ionq.com/news/news-details/2026/UPDATED-DARPA-Selects-IonQ-to-Produce-Next-Generation-Atomic-Clocks/default.aspx",
                      "by": "seed"
                    }
                  ],
                  "total": 600,
                  "limit": 3,
                  "offset": 0,
                  "next": "/api/changes?since=2026-09-01&limit=3&offset=3",
                  "note": "Newest 600 changes; the history is append-only."
                }
              }
            }
          }
        }
      }
    },
    "/api/search": {
      "get": {
        "operationId": "search",
        "summary": "Search technologies, companies, researchers, events and pages",
        "description": "Search technologies, companies, researchers, events and pages. Returns up to 20 ranked results with title, link and one line.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Technology, company, person or event",
            "schema": {
              "type": "string"
            },
            "example": "tokamak"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Results, 1 to 20",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 20
            }
          }
        ],
        "responses": {
          "200": {
            "description": "up to 20 ranked results with title, link and one line",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "q": "fusion",
                  "results": [
                    {
                      "id": "tech:fusion-energy",
                      "group": "items",
                      "title": "Fusion energy",
                      "subtitle": "Prototype · Making power by fusing light atoms like hydrogen isotopes, the process that fuels the sun, with no long-lived waste.",
                      "href": "/tech/fusion-energy",
                      "keywords": [
                        "fusion energy",
                        "Magnetic confinement tokamaks"
                      ],
                      "icon": "layers",
                      "boost": 60,
                      "score": 878
                    },
                    {
                      "id": "co:marvel-fusion",
                      "group": "companies",
                      "title": "Marvel Fusion",
                      "subtitle": "Fusion energy",
                      "href": "/companies/marvel-fusion",
                      "keywords": [
                        "marvel fusion",
                        "marvelfusion.com"
                      ],
                      "logo": "https://img.logo.dev/marvelfusion.com?token=...&size=64&format=png&theme=light&retina=true&fallback=404",
                      "boost": 10,
                      "score": 660
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}