Dealer specials

id is stable for the life of an offer on its site (same platform offer id, same creative, or same make/model/year/type/amount): a changed payment keeps the id and is recorded in the history; an offer that disappears and returns keeps its id. source=published (default) is what v2 publishes; source=shadow is what it would publish for sites still in shadow. For incremental sync pass since (rows changed or removed since then) with status=all.

Plan and price

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

Parameters

Example request

curl "https://api.motorsdynamic.com/api/v2/specials?domain_id=201&status=all&limit=1" \
  -H "x-api-key: $MD_API_KEY"

const res = await fetch("https://api.motorsdynamic.com/api/v2/specials?domain_id=201&status=all&limit=1", {
  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/specials?domain_id=201&status=all&limit=1",
    headers={"x-api-key": os.environ["MD_API_KEY"]},
    timeout=10,
)
res.raise_for_status()
print(res.json())

Example response

{
  "data": [
    {
      "id": 9001,
      "domain_id": 201,
      "source": "published",
      "status": "active",
      "offer_key": "id:tel-1",
      "make": "Kia",
      "model": "Telluride",
      "model_year": 2026,
      "trim": null,
      "vin": null,
      "stock_number": null,
      "offer_type": "Lease",
      "offer_amount": "$499/mo",
      "monthly_payment": 499,
      "term": 36,
      "due_at_signing": 3999,
      "msrp": 38000,
      "selling_price": null,
      "offer_details": null,
      "disclaimer": "Lease for well-qualified lessees.",
      "raw_ocr_text": null,
      "expires_at": "2026-09-30",
      "offers": null,
      "image_url": null,
      "image_hash": null,
      "source_type": "html",
      "source_url": "https://www.kiaofexample.com/specials",
      "source_page_type": "specials",
      "strategy": "tv_api",
      "first_seen_at": "2026-09-20T10:00:00.000000Z",
      "last_seen_at": "2026-09-24T10:00:00.000000Z",
      "removed_at": null,
      "freshness": {
        "last_seen_at": "2026-09-24T10:00:00.000000Z",
        "last_complete_run_at": "2026-09-24T10:00:00.000000Z",
        "stale": false
      },
      "provenance": {
        "source": "v2_specials",
        "mode": "publish",
        "strategy": "tv_api",
        "run_id": 77,
        "first_run_id": 70
      }
    }
  ],
  "page": {
    "limit": 1,
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "source": "published",
    "target": {
      "mode": "publish",
      "last_complete_at": "2026-09-24T10:00:00.000000Z",
      "next_crawl_at": "2026-09-24T10:00:00.000000Z",
      "last_outcome": "RECIPE_HIT",
      "alert": false,
      "alert_reason": null,
      "consecutive_failures": 0
    }
  }
}

Response fields

Errors

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