Collection runs

Newest first. Specials runs carry the never-blank outcome, OCR and LLM counts.

Plan and price

A call is billed when it answers 2xx. See pricing.

Parameters

Example request

curl "https://api.motorsdynamic.com/api/v2/runs?domain_id=201&kind=specials" \
  -H "x-api-key: $MD_API_KEY"

const res = await fetch("https://api.motorsdynamic.com/api/v2/runs?domain_id=201&kind=specials", {
  headers: { "x-api-key": process.env.MD_API_KEY },
});
if (!res.ok) throw new Error(`${res.status} ${(await res.json()).error}`);
const data = await res.json();
console.log(data);

import os, requests

res = requests.get(
    "https://api.motorsdynamic.com/api/v2/runs?domain_id=201&kind=specials",
    headers={"x-api-key": os.environ["MD_API_KEY"]},
    timeout=10,
)
res.raise_for_status()
print(res.json())

Example response

{
  "data": [
    {
      "run_id": 77,
      "domain_id": 201,
      "kind": "specials",
      "state": "complete",
      "mode": "publish",
      "started_at": "2026-09-24T10:00:00.000000Z",
      "finished_at": "2026-09-24T10:00:00.000000Z",
      "adapter_version": "specials-generic-1",
      "fetch_tier": "direct",
      "pages_fetched": 3,
      "requests": 4,
      "counts": {
        "added": 1,
        "changed": 1,
        "unchanged": 5,
        "removed": 0
      },
      "error": null,
      "specials": {
        "outcome": "RECIPE_HIT",
        "reason": "7 validated via proven recipe(s)",
        "cms": "teamvelocity",
        "observations": 7,
        "listed": 1,
        "changed": 1,
        "relisted": 0,
        "unchanged": 5,
        "removed": 0,
        "renders": 0,
        "ocr_read": 0,
        "ocr_skipped": {},
        "llm_calls": 0,
        "llm_capped": false,
        "strategies": {
          "tv_api": 7
        }
      }
    }
  ],
  "page": {
    "limit": 50,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {}
}

Response fields

Errors

Every error has the same body. Full list: errors.