Register specials targets

Idempotent, up to 200 sites per call. Each site is matched by exact normalized host; an unknown host becomes a new site. Creates the (site, kind) collection target if it does not exist and never changes an existing one. New targets start in shadow (collected and diffed, not published) until the site passes parity and is promoted. Records the agency's entitlement, so the credential can read the site's specials, history and runs. seed_urls (known specials pages, on the site's host) and group_hosts (sister-store hosts whose images count as dealer-owned) are merged with earlier registrations. Kinds media, site_pages and ad_library are planned (400 kind_not_available). Needs scope v2:write. Returns 201 when anything was created.

Plan and price

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

Request body

Example request

curl -X POST "https://api.motorsdynamic.com/api/v2/targets" \
  -H "x-api-key: $MD_API_KEY" \
  -H "content-type: application/json" \
  -d '{"domains":[{"url":"https://www.newkiastore.com/","seed_urls":["https://www.newkiastore.com/new-specials/"],"group_hosts":["sisterkia.com"]}]}'

const res = await fetch("https://api.motorsdynamic.com/api/v2/targets", {
  method: "POST",
  headers: { "x-api-key": process.env.MD_API_KEY, "content-type": "application/json" },
  body: JSON.stringify({"domains":[{"url":"https://www.newkiastore.com/","seed_urls":["https://www.newkiastore.com/new-specials/"],"group_hosts":["sisterkia.com"]}]}),
});
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.post(
    "https://api.motorsdynamic.com/api/v2/targets",
    headers={"x-api-key": os.environ["MD_API_KEY"]},
    json={"domains":[{"url":"https://www.newkiastore.com/","seed_urls":["https://www.newkiastore.com/new-specials/"],"group_hosts":["sisterkia.com"]}]},
    timeout=10,
)
res.raise_for_status()
print(res.json())

Example response

{
  "data": [
    {
      "domain_id": 1000000123,
      "host": "newkiastore.com",
      "created": {
        "site": true,
        "targets": [
          "specials"
        ],
        "entitlement": true
      },
      "targets": [
        {
          "kind": "specials",
          "mode": "shadow",
          "next_crawl_at": "2026-09-24T10:00:00.000000Z",
          "last_complete_at": null
        }
      ]
    }
  ],
  "meta": {
    "agency_id": 2
  }
}

Response fields

Errors

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