Open structured data
Humanoid robot data API v1
Public JSON snapshots generated at build time. No API key is needed. GET responses allow cross-origin reads with CORS *.
| Endpoint | Contents | JSON Schema |
|---|---|---|
| /api/v1/robots.json | Key specs with units in field names, price, sources and record/API/feed URLs. | robots schema |
| /api/v1/companies.json | Full company records, sources, canonical URLs and entity feeds. | companies schema |
| /api/v1/models.json | Full policy/model records, release dates, licences, links and sources. | models schema |
| /api/v1/datasets.json | Full dataset records, sizes, permissions, links and sources. | datasets schema |
| /api/v1/deployments.json | Full deployment evidence, quantity basis, stages and sources. | deployments schema |
| /api/v1/market.json | Full publisher observations; estimates, forecasts and capacity remain separate. | market schema |
| /api/v1/robots/<slug>.json | Full robot record and sources, plus nullable robot-details sidecar with its own sources.Example → | robot schema |
Fields and provenance
Every response has apiVersion, license, attribution, lastModified and data. Lists put records in data; a robot endpoint puts one full record in data. lastModified is the latest input verification date, not an observation or publication timestamp. Empty collections return data: [] and lastModified: null.
Specs are null or objects with value, sources, confidence and an optional note. Source IDs resolve within that record’s sources array; details.sources is a separate namespace. Numeric units are encoded in spec keys: cm, kg, mps (m/s), kwh, h and nm (N·m). Boolean false and numeric zero are real values. Null means unknown in the checked sources. Preserve price kind and confidence; targets and subscriptions are not purchase prices.
Dates may be YYYY, YYYY-MM or YYYY-MM-DD; news dates retain timezone precision. Generated JSON Schemas describe the Zod output shapes. Build validation additionally checks calendar dates, source IDs and cross-record references. Data can change on rebuild; v1 names the API contract, not an immutable historical release.
Licence and required attribution
The normalized factual records are licensed under CC BY 4.0. Attribute “Data: humanoidversus.com,” link to the canonical record or dataset page, retain source references and verification dates, and indicate your changes. Photographs, quoted source material, linked code, model weights and underlying datasets keep their own licences.
const response = await fetch("https://humanoidversus.com/api/v1/robots.json");
const { data, license, attribution, lastModified } = await response.json();Browse CSV exports, the disclosure index and data changelog. Report a missing source or correction.