A1 Synthetic Oil (independent AMSOIL dealer)

Search the AMSOIL catalog by product name, product code, viscosity grade (for example 5W-30), product type, or category, with the same ranking and typo tolerance as the a1syntheticoil.com catalog search. Returns product codes, the A1 product page, the AMSOIL shopping link with dealer referral zo=30734402, matching categories, and related A1 guides. Does not return prices or stock.

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Optional category name from list_categories, for example \"Diesel oil\".",
      "maxLength": 100,
      "type": "string"
    },
    "country": {
      "default": "US",
      "description": "Storefront country: US (amsoil.com) or CA (amsoil.ca).",
      "enum": [
        "US",
        "CA"
      ],
      "type": "string"
    },
    "limit": {
      "default": 8,
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "What to look for, for example \"0W-20 motor oil\", \"diesel 15W-40\", \"ATF\", or \"EA15K13\".",
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Full A1 guidance for one product: description, fitment notes, a common question, the U.S. and Canadian product codes, and the AMSOIL shopping link with dealer referral zo=30734402.

{
  "type": "object",
  "properties": {
    "code": {
      "description": "U.S. or Canadian product code, for example ASLQT-EA or ASLQTC-EA.",
      "maxLength": 40,
      "minLength": 2,
      "type": "string"
    },
    "country": {
      "default": "US",
      "description": "Storefront country: US (amsoil.com) or CA (amsoil.ca).",
      "enum": [
        "US",
        "CA"
      ],
      "type": "string"
    }
  },
  "required": [
    "code"
  ],
  "additionalProperties": false
}

Every product category with its product count and A1 catalog page.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Who each AMSOIL account type is for, how it differs from the others, and the enrollment link with dealer referral zo=30734402: shopping without an account, Preferred Customer membership, commercial, retail, installer, and independent dealer.

{
  "type": "object",
  "properties": {
    "country": {
      "default": "US",
      "description": "Storefront country: US (amsoil.com) or CA (amsoil.ca).",
      "enum": [
        "US",
        "CA"
      ],
      "type": "string"
    },
    "type": {
      "description": "Optional. Omit to compare all account types.",
      "enum": [
        "shop_without_account",
        "preferred_customer",
        "commercial",
        "retail",
        "installer",
        "dealer"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

AMSOIL product links with dealer referral zo=30734402 for up to 25 product codes, plus the storefront link. The user opens each link, chooses the package size, and checks out on AMSOIL.

{
  "type": "object",
  "properties": {
    "codes": {
      "description": "U.S. or Canadian product codes.",
      "items": {
        "maxLength": 40,
        "type": "string"
      },
      "maxItems": 25,
      "minItems": 1,
      "type": "array"
    },
    "country": {
      "default": "US",
      "description": "Storefront country: US (amsoil.com) or CA (amsoil.ca).",
      "enum": [
        "US",
        "CA"
      ],
      "type": "string"
    }
  },
  "required": [
    "codes"
  ],
  "additionalProperties": false
}

The three closest AMSOIL distribution centers in the same country as a U.S. ZIP code or Canadian postal code, by straight-line distance. These are AMSOIL facilities, not A1 locations, and the nearest one may not fulfill an order.

{
  "type": "object",
  "properties": {
    "postal_code": {
      "description": "U.S. ZIP code (for example 99156) or Canadian postal code (for example T5L 2T2).",
      "maxLength": 10,
      "minLength": 3,
      "type": "string"
    }
  },
  "required": [
    "postal_code"
  ],
  "additionalProperties": false
}

How to reach Jeff Pittman, the independent AMSOIL dealer behind A1 Synthetic Oil, and what to include when asking for help choosing a product or account.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Matches the viscosity grade and specification a vehicle's owner's manual lists to AMSOIL products, with shopping links carrying dealer referral zo=30734402 and the official AMSOIL lookup link for confirming the exact fit. It does not look up vehicles: give the requirements from the manual. Without them it returns questions to ask (needs) instead of guessing.

{
  "type": "object",
  "properties": {
    "component": {
      "default": "engine",
      "description": "What is being serviced.",
      "enum": [
        "engine",
        "transmission",
        "differential"
      ],
      "type": "string"
    },
    "country": {
      "default": "US",
      "description": "Storefront country: US (amsoil.com) or CA (amsoil.ca).",
      "enum": [
        "US",
        "CA"
      ],
      "type": "string"
    },
    "description": {
      "description": "The vehicle or machine, for example \"2020 Chevy Silverado 5.3L\" or \"Polaris RZR 1000 transmission\". Viscosity and specification may be included here.",
      "maxLength": 400,
      "minLength": 1,
      "type": "string"
    },
    "from_owners_manual": {
      "default": false,
      "description": "True only when the user read the viscosity and specification from the owner's manual.",
      "type": "boolean"
    },
    "specifications": {
      "description": "Specifications from the owner's manual, for example \"API SP, dexos1 Gen 3\" or \"Dexron VI\".",
      "maxLength": 200,
      "type": "string"
    },
    "vehicle_type": {
      "description": "Optional; detected from the description when omitted (car = car, SUV, or gasoline light truck).",
      "enum": [
        "car",
        "diesel",
        "motorcycle",
        "powersports",
        "marine",
        "small_engine",
        "tractor"
      ],
      "type": "string"
    },
    "viscosity": {
      "description": "Viscosity grade from the owner's manual, for example 0W-20.",
      "maxLength": 40,
      "type": "string"
    }
  },
  "required": [
    "description"
  ],
  "additionalProperties": false
}