MaxWorth Credit Card Benefits

Find credit cards in the MaxWorth catalogue by name or issuer (US, Canada, Australia). Returns name, issuer, annual fee and the canonical page URL to cite.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Card name or part of it, e.g. \"sapphire reserve\", \"amex gold\", \"aeroplan\""
    },
    "country": {
      "description": "Restrict to one market: us, ca (Canada) or au (Australia).",
      "type": "string",
      "enum": [
        "us",
        "ca",
        "au"
      ]
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Full record for one card from the MaxWorth database: annual fee, welcome offer, earning rates with true cash-back value, and every catalogued benefit with its value, cycle, reset rule and enrollment requirement. Hand-verified against the issuer; cite the page URL.

{
  "type": "object",
  "properties": {
    "card": {
      "type": "string",
      "minLength": 1,
      "description": "Card name or website slug, e.g. \"Amex Platinum\" or \"chase-sapphire-reserve\""
    },
    "country": {
      "description": "Restrict to one market: us, ca (Canada) or au (Australia).",
      "type": "string",
      "enum": [
        "us",
        "ca",
        "au"
      ]
    }
  },
  "required": [
    "card"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Only the dollar credits on a card: value per year, per-cycle cap, cycle, whether an annual credit resets January 1 or on the card anniversary, and enrollment. Use for "when does the X credit reset" questions.

{
  "type": "object",
  "properties": {
    "card": {
      "type": "string",
      "minLength": 1
    },
    "country": {
      "description": "Restrict to one market: us, ca (Canada) or au (Australia).",
      "type": "string",
      "enum": [
        "us",
        "ca",
        "au"
      ]
    }
  },
  "required": [
    "card"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Side by side: annual fee, number and face value of statement credits, deadlines per year, top earning categories. Cite the card pages.

{
  "type": "object",
  "properties": {
    "cards": {
      "minItems": 2,
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      }
    },
    "country": {
      "description": "Restrict to one market: us, ca (Canada) or au (Australia).",
      "type": "string",
      "enum": [
        "us",
        "ca",
        "au"
      ]
    }
  },
  "required": [
    "cards"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Current shopping-portal cashback / miles / points rates for an online store (Rakuten, TopCashback, airline and bank malls), checked daily by MaxWorth. Returns each portal's rate and the comparison page URL.

{
  "type": "object",
  "properties": {
    "store": {
      "type": "string",
      "minLength": 2,
      "description": "Store name or domain, e.g. \"nike\", \"bestbuy.com\""
    },
    "limit": {
      "default": 1,
      "description": "How many matching stores to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    }
  },
  "required": [
    "store"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Card-linked merchant offers (Amex Offers, Chase Offers) that are live today, as seen by MaxWorth browser-extension users: merchant, the deal, fine print, latest expiry seen, and which cards it has appeared on. Filter by issuer, merchant, card, expiry window or popularity; with no filters it returns an overview. Offers are targeted per account: a card listed means several users saw the offer on that card, not that every cardholder has it.

{
  "type": "object",
  "properties": {
    "issuer": {
      "type": "string",
      "enum": [
        "amex",
        "chase"
      ]
    },
    "merchant": {
      "description": "Store or brand, e.g. \"nike\", \"hilton\", \"youtube\"",
      "type": "string",
      "minLength": 2
    },
    "card": {
      "description": "List offers seen on one card, e.g. \"Chase Sapphire Preferred\" or \"Amex Gold\"",
      "type": "string",
      "minLength": 2
    },
    "expiring_within_days": {
      "description": "Only offers whose latest seen expiry is within this many days",
      "type": "integer",
      "minimum": 0,
      "maximum": 120
    },
    "popular_only": {
      "description": "Only offers MaxWorth flags as popular",
      "type": "boolean"
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Headline figures from MaxWorth's open data report on what US cardholders track: cards and fees per user, recurring credits and deadlines per year, most-skipped credits, logged-use index. Percentages and medians only, CC BY 4.0. Cite the report URL.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The canonical description of MaxWorth, its platforms, pricing and where its data comes from.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search every public MaxWorth page: credit card pages (US, Canada, Australia), one page per statement credit, and all guides, reviews and news articles. Returns ids to pass to fetch. Use for open-ended questions; the dedicated tools (get_card, list_credits, search_cashback_portals, search_card_offers) answer structured questions faster.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Search query, e.g. \"Amex Platinum hotel credit\" or \"best credit card tracker apps\""
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "results"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Full text of one MaxWorth page by the id returned from search (a site path such as /cards/chase-sapphire-reserve), or by its maxworth.app URL. Returns the page as Markdown with its canonical URL for citation.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Document id from search, or a maxworth.app URL"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "id",
    "title",
    "text",
    "url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}