keepitcorrect.org
ExplorerAPI manifest

API reference

Use the maintenance truth layer from other services.

This page documents the current API surface with real examples pulled from the live dataset, so integrations can start from stable paths instead of reverse engineering the app.

Current platform surface

9

documented endpoints

310

parsed interval records

64

parser targets

Discovery

Start with the manifest, then move into the domain endpoints.

The manifest is the lightweight machine-readable starting point. The domain endpoints below expose brands, vehicles, items, sources, and coverage state.

Open manifest JSONOpen coverage JSONOpen ingestion snapshot JSONOpen Hyundai discovery JSONOpen Kia discovery JSON

Endpoints

Current reference surface.

GET

Coverage API

/api/coverage

Platform health across brands, vehicles, items, and sources.

{
  "totals": {
    "records": 310,
    "parsedTargets": 64
  }
}
Open endpoint

GET

Brand API

/api/brands

Coverage and review pressure summarized per brand.

{
  "brand": "Mazda",
  "parsedRecordCount": 15
}
Open endpoint

GET

Vehicle API

/api/vehicles/Mazda/Mazda3

Vehicle-level schedule and parsed maintenance coverage.

{
  "brand": "Mazda",
  "model": "Mazda3",
  "year": 2021,
  "item": "Engine oil and filter"
}
Open endpoint

GET

Maintenance Items API

/api/maintenance/items

Service item catalog plus parsed item coverage.

{
  "itemId": "engine-oil-filter",
  "category": "Fluids",
  "name": "Engine oil and filter"
}
Open endpoint

GET

Sources API

/api/sources

Official source catalog with parsed record counts and QA load.

{
  "targetId": "2021-mazda3-scheduled-maintenance",
  "recordCount": 6,
  "warningCount": 0
}
Open endpoint

GET

Manifest API

/api/manifest

Machine-readable discovery endpoint for the platform API surface.

{
  "docsPath": "/explorer/api",
  "service": "keepitcorrect.org"
}
Open endpoint

POST

Ingestion Run API

/api/ingestion/run

Triggers a fresh OEM ingestion run and persists updated parser runs and raw documents.

{
  "ok": true,
  "targetCount": 64,
  "recordCount": 310
}
Open endpoint

GET

Hyundai Source Discovery API

/api/source-discovery/hyundai?model=tucson

Discovers official Hyundai owner-manual PDFs, with optional filtering by model.

{
  "source": "Hyundai manuals feed",
  "model": "tucson"
}
Open endpoint

GET

Kia Source Discovery API

/api/source-discovery/kia?model=SPORTAGE&year=2024

Discovers Kia model-year coverage first, then resolves official manuals for a specific model and year.

{
  "source": "Kia manuals gateway",
  "model": "SPORTAGE",
  "year": 2024
}
Open endpoint