Cited specifications API
Build-time exports of the same validated data used by the HTML pages. No authentication, client JavaScript or live server is required.
- /api/specs.json: the complete dataset, currently 714 records.
- /spec/<id>.json: one record, wrapped in
{ schema_version, spec }. - /llms.txt: overview and discovery links. /llms-full.txt: every complete record with citations.
- /specs.json: compact search index. It omits sources and procedures; use the full API before relying on a value.
Version 1 envelope
schema_version is 1. The bulk response has site, license, units, systems, jobs, sources (document catalog) and specs. Optional record fields are omitted when absent.
| Record field | Meaning |
|---|---|
id, name, aliases | Stable identifier, display name and search synonyms. |
system, component, componentName, jobs | System/component ids, component display name and job ids. |
url | Absolute canonical HTML URL to cite. |
applies_to | Array of rules joined by OR. Within a rule all restrictions must match: gen, inclusive years, engines, trans, diff, abs, built_from/built_to (YYYY-MM) and explanatory note. A missing restriction does not limit that dimension. |
kind, torque, value_text | Torque records have printed-unit ranges; non-torque records use value_text. Every range is [min, max], including [x, x] for a single value. |
stages | Ordered steps with step number, optional torque, angle_deg and note. Perform the whole sequence; the last torque is not a substitute for the procedure. |
fastener, procedure | Thread, socket and quantity; threadlocker, sealant, lubrication, replacement, sequence and notes. Preserve these with the value. |
confidence | fsm, consensus, single-source or disputed. A disputed record requires review of every source claim; do not automatically resolve it. |
sources[] | Each claim retains source id, printed page, as_printed, torque/stages and note. Its document contains id, title, tier, part_number, covers, URL and note. Optional fields may be absent. covers describes the cited manual’s coverage, which can be narrower than applicability. |
Units and safe use
nm = N·m, kgfm = kgf·m, kgfcm = kgf·cm, ftlb = ft·lb, inlb = in·lb. JSON includes only units the source printed; HTML marks conversions with ≈. Inch-pounds and foot-pounds differ by a factor of 12. Never fill missing units by assuming a number’s meaning.
Landing pages include possible equipment variants. Match all restrictions for the actual car, review confidence and document coverage, follow every stage and procedure, and confirm against the factory manual before working on a car.
Stability and citation
Version 1 field meanings will remain stable. Additive optional fields and factual corrections can appear without a version bump; breaking changes will increment schema_version. Spec ids are intended to remain stable; corrections may retire or split records. Consumers should tolerate absent optional fields, unknown future fields and removed ids, and refresh data rather than treating cached values as permanent.
Cite “Miata Torque DB, A/C pipe bracket bolt (to radiator),” link to its canonical spec page, and include the source document title, printed page, printed text and retrieval date. Preserve warnings, applicability and procedures when quoting.
Dataset license: https://creativecommons.org/licenses/by/4.0/. Source manuals and illustrations are not included or relicensed. Source methodology.