Developer API v1

https://www.amalgadon.com/api/v1

GET /api/v1/card?q=Brann HTTP/1.1
Host: www.amalgadon.com
Authorization: Bearer amgd_your_api_key_here

# latest comparison
curl https://www.amalgadon.com/api/v1/patch-notes \
  -H "Authorization: Bearer amgd_your_key"

# a specific comparison
curl "https://www.amalgadon.com/api/v1/patch-notes?comparison=247416-to-248348" \
  -H "Authorization: Bearer amgd_your_key"

# every available comparison slug
curl "https://www.amalgadon.com/api/v1/patch-notes?list=true" \
  -H "Authorization: Bearer amgd_your_key"

{
  "version": "31.2.3",
  "comparison": "31.2.2-to-31.2.3",
  "summary": {
    "total": 12,
    "minions":  { "added": 2, "removed": 1, "changed": 4 },
    "heroes":   { "added": 0, "removed": 0, "changed": 3 },
    "trinkets": { "added": 1, "removed": 0, "changed": 1 },
    "spells":   { "added": 0, "removed": 0, "changed": 0 }
  },
  "cards": {
    "added":   [{ "id": "BG_NEW_001", "name": "New Minion" }],
    "removed": [{ "id": "BG_OLD_001", "name": "Old Minion" }],
    "changed": [{ "id": "BG21_002", "name": "Murloc Tidecaller" }]
  },
  "detailUrl": "https://www.amalgadon.com/patch-notes/31.2.2-to-31.2.3",
  "availableComparisons": 78
}

curl "https://www.amalgadon.com/api/v1/minions?tribe=BEAST&tier=4&limit=2" \
  -H "Authorization: Bearer amgd_your_key"

{
  "total": 17,
  "limit": 2,
  "offset": 0,
  "results": [
    {
      "id": "BG_EX1_531",
      "dbfId": 38739,
      "name": "Cave Hydra",
      "text": "Also damages the minions next to whomever this attacks.",
      "attack": 2,
      "health": 4,
      "techLevel": 4,
      "races": ["BEAST"],
      "detailUrl": "https://www.amalgadon.com/minion/cave-hydra"
    }
  ]
}

curl "https://www.amalgadon.com/api/v1/card?q=Murloc+Tidecaller" \
  -H "Authorization: Bearer amgd_your_key"

curl "https://www.amalgadon.com/api/v1/card?q=Brann&type=minion" \
  -H "Authorization: Bearer amgd_your_key"

{
  "results": [
    {
      "id":          "BG21_002",
      "name":        "Murloc Tidecaller",
      "type":        "minion",
      "fuzzy":       false,
      "text":        "Whenever a friendly Murloc is summoned, gain +1 Attack.",
      "attack":      1,
      "health":      2,
      "techLevel":   1,
      "races":       ["MURLOC"],
      "goldenCardId": "BG21_002_G",
      "detailUrl":   "https://www.amalgadon.com/minion/murloc-tidecaller"
    }
  ]
}

curl https://www.amalgadon.com/api/v1/cards \
  -H "Authorization: Bearer amgd_your_key"

{
  "minions":  [ /* BGMinion[] — see object examples below */ ],
  "heroes":   [ /* BGHero[] */ ],
  "trinkets": [ /* BGTrinket[] */ ],
  "spells":   [ /* BGSpell[] */ ]
}

curl https://www.amalgadon.com/api/v1/build/abc123 \
  -H "Authorization: Bearer amgd_your_key"

{
  "id":        "abc123",
  "code":      "pABCDEFGHIJKL...",
  "createdAt": "2024-04-18T12:00:00.000Z",
  "stats": { "views": 42, "upvotes": 7, "downvotes": 1 },
  "build": {
    "title":   "Murloc Tempo",
    "heroes":  [{ "id": "BG_HERO_01", "name": "Patches the Pirate", "type": "hero" }],
    "slots": [
      { "id": "BG21_002", "name": "Murloc Tidecaller", "type": "minion", "golden": false },
      { "id": "BG20_204", "name": "Sellemental",       "type": "minion", "golden": true },
      null, null, null, null, null
    ],
    "lesserTrinket": { "id": "BG30_MagicItem_901", "name": "Rock Buddy", "type": "trinket" }
  },
  "remixUrl": "https://www.amalgadon.com/board-builder?remix=pABCDEFGHIJKL...",
  "embedUrl": "https://www.amalgadon.com/embed/abc123"
}

curl https://www.amalgadon.com/api/v1/build \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer amgd_your_key" \
  -d '{
    "hero": "Patches the Pirate",
    "slots": [
      { "name": "Murloc Tidecaller" },
      { "name": "Sellemental", "golden": true },
      null, null, null, null, null
    ],
    "lesserTrinket": "Rock Buddy",
    "title": "Murloc Tempo"
  }'

{
  "code": "pABCDEFGHIJKL...",
  "remixUrl": "https://www.amalgadon.com/board-builder?remix=pABCDEFGHIJKL...",
  "shareUrl": "https://www.amalgadon.com/build/abc123",
  "embedUrl": "https://www.amalgadon.com/embed/abc123",
  "resolved": {
    "hero": { "name": "Patches the Pirate", "id": "BG_HERO_01", "fuzzy": false },
    "slots": [
      { "name": "Murloc Tidecaller", "id": "BG21_002", "fuzzy": false },
      { "name": "Sellemental", "id": "BG20_204", "fuzzy": false },
      // "archived": true marks a card that has rotated out of the pool.
      { "name": "Annoy-o-Tron", "id": "BG_GVG_085", "fuzzy": false, "archived": true },
      null, null, null, null
    ],
    "lesserTrinket": { "name": "Rock Buddy", "id": "BG30_MagicItem_901", "fuzzy": false, "tier": "lesser" },
    "greaterTrinket": null
  }
}

curl https://www.amalgadon.com/api/v1/key/me \
  -H "Authorization: Bearer amgd_your_key"

{
  "appName":    "My Discord Bot",
  "createdAt":  "2024-04-18T12:00:00.000Z",
  "lastUsedAt": "2024-04-20T08:30:00.000Z"
}

curl https://www.amalgadon.com/api/v1/key \
  -X DELETE \
  -H "Authorization: Bearer amgd_your_key"

{ "revoked": true }

{
  "h":  "BG_HERO_01",
  "s":  ["BG21_002", "BG20_204:g", "BG_CFM_312:t", null, null, null, null],
  "lt": "BG30_MagicItem_901",
  "t":  "Murloc Tempo",
  "d":  "Early curve into Murlocs with Brann for value."
}

<iframe
  src="https://www.amalgadon.com/embed/abc123"
  width="700"
  height="220"
  style="border: none; border-radius: 8px;"
  title="Hearthstone Battlegrounds board"
></iframe>

{
  "error": "Human-readable message",
  // Optional — present on 422 responses only:
  "unresolved": [{ "field": "...", "input": "..." }]
}