Energy Drink Ratings

Text search over energy drink names and brands. Returns up to 10 matching drinks with caffeine, sugar and a link to each drink page, or no results when EnergyDrinkRatings has no entry for the name.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Drink name or brand to search for, e.g. 'Bang Purple Haze' or 'Celsius'"
    },
    "limit": {
      "default": 10,
      "description": "Maximum results to return (max 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full label facts for one drink identified by its EDR slug: caffeine, sugar, calories, serving size, sweetener and flavor info, availability, the community rating with its count and, when there are enough written reviews, a one-line summary of what raters say. Also returns links to the drink page, to rate the drink and to a free caffeine tracker.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "The drink's EDR slug, e.g. 'bang-purple-haze'"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Side-by-side facts for 2-4 drinks by slug. Slugs not found in the catalog are reported, not silently dropped.

{
  "type": "object",
  "properties": {
    "slugs": {
      "minItems": 2,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "2-4 EDR drink slugs to compare"
    }
  },
  "required": [
    "slugs"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Filters the catalog by caffeine, sugar, sweetener type, flavor family, carbonation and extras, with the same filters as energydrinkratings.com/find. Returns only available drinks, ranked by real community rating where rated, then by name, along with the total number of matches.

{
  "type": "object",
  "properties": {
    "caffeine": {
      "description": "Caffeine bands (OR'd together): le100 (≤100 mg), 100-199 (101–199 mg), 200-299 (200–299 mg), 300plus (300+ mg)",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "le100",
          "100-199",
          "200-299",
          "300plus"
        ]
      }
    },
    "sugar": {
      "description": "'zero' = 0g, 'low' = <=5g",
      "type": "string",
      "enum": [
        "any",
        "zero",
        "low"
      ]
    },
    "sweetener": {
      "description": "'no-artificial' excludes artificial sweeteners; 'natural' requires a plant-based one (Plant-based sweeteners). Sweetener categories: sugar=Sugar, artificial=Artificial sweeteners, natural=Plant-based sweeteners",
      "type": "string",
      "enum": [
        "any",
        "no-artificial",
        "natural"
      ]
    },
    "flavors": {
      "description": "Flavor families (OR'd together): citrus (Citrus), berry (Berry), tropical (Tropical), stone_fruit (Stone Fruit), cherry (Cherry), grape (Grape), melon (Melon), apple_pear (Apple & Pear), fruit_punch (Fruit Punch), candy_dessert (Candy & Dessert), cola (Cola), root_beer_cream_soda (Root Beer & Cream Soda), coffee_tea (Coffee & Tea), original (Original)",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "citrus",
          "berry",
          "tropical",
          "stone_fruit",
          "cherry",
          "grape",
          "melon",
          "apple_pear",
          "fruit_punch",
          "candy_dessert",
          "cola",
          "root_beer_cream_soda",
          "coffee_tea",
          "original"
        ]
      }
    },
    "fizz": {
      "type": "string",
      "enum": [
        "any",
        "sparkling",
        "still"
      ]
    },
    "extras": {
      "description": "Required ingredient tags (AND'd together): preworkout (Pre-workout), focus (Focus)",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "preworkout",
          "focus"
        ]
      }
    },
    "limit": {
      "default": 10,
      "description": "Maximum results to return (max 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}