cashbackpro

Search the AliExpress catalogue and return compact product cards with price, rating, sales volume and the affiliate commission rate — the data needed to judge what a product actually costs. Low-quality listings are filtered out automatically (blocked categories, minimum price). Product URLs in the result are CashbackPro affiliate links.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "Search keywords, e.g. \"wireless earbuds\""
    },
    "limit": {
      "default": 5,
      "description": "Max results (1-10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "max_price_usd": {
      "description": "Optional price ceiling in USD",
      "type": "number",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Look up one AliExpress product by its numeric ID: authoritative price, rating, sales volume, commission rate and category, plus what the cashback would come to at each CashbackPro level.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric AliExpress product ID"
    }
  },
  "required": [
    "product_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Work out the cashback on a purchase: commission = price × commission rate, of which the buyer receives a share set by their CashbackPro level (Bronze 30%, Silver 45%, Gold 60%, Platinum 80%). Returns the figure for every level. Pure calculation — nothing is looked up.

{
  "type": "object",
  "properties": {
    "price_usd": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Product price in USD"
    },
    "commission_rate_percent": {
      "type": "number",
      "minimum": 0,
      "maximum": 50,
      "description": "AliExpress commission rate, percent (e.g. 7 for 7%)"
    }
  },
  "required": [
    "price_usd",
    "commission_rate_percent"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

AliExpress promo codes currently active on the global (USD) site: platform-wide codes and product-specific ones, with minimum spend, remaining quantity and expiry. Expired codes are excluded and the set refreshes daily. Codes stack with cashback, so a code and a CashbackPro link apply to the same purchase.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the CashbackPro purchase link for an AliExpress product. These are affiliate links: with a connected CashbackPro account (extension token in the Authorization Bearer header, obtained at https://cashbackpro.org/connect-extension?utm_source=mcp) part of the commission goes back to the buyer as cashback; without one the link still works but pays none. Which case applies is stated in the response, along with the disclosure text to pass on to the user.

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "AliExpress product URL or numeric product ID"
    }
  },
  "required": [
    "product"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}