divux

Find a product the user has already chosen, by exact name, model number or barcode (UPC/EAN), and get its id for compare_prices. Use this when the user is ready to buy: they ask where to buy it, for the best price now, whether a price is a good deal, or for a link. For a parts or shopping list, search each item. Not for researching what to buy (e.g. 'best headphones under $200'): decide that yourself, then search for the chosen model. Do not use for recall or safety questions (use check_recalls).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "The chosen product's name, model number or UPC/EAN, e.g. 'Sony WH-1000XM6' or '045496884963'; not a category"
    },
    "limit": {
      "default": 5,
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "min_price": {
      "description": "Lowest price in USD, when the user gives a budget floor",
      "type": "number",
      "minimum": 0
    },
    "max_price": {
      "description": "Highest price in USD, e.g. 100 for 'under $100'",
      "type": "number",
      "minimum": 0
    },
    "in_stock_only": {
      "default": false,
      "description": "Only products with at least one in-stock offer",
      "type": "boolean"
    },
    "brand": {
      "description": "Only this brand, e.g. 'Dyson', when the user names one",
      "type": "string",
      "maxLength": 60
    },
    "condition": {
      "default": "new",
      "description": "new unless the user asks for used, open-box or refurbished; 'used' covers all of those",
      "type": "string",
      "enum": [
        "new",
        "used"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Compare current offers for one chosen product across US stores, ranked by price (item plus shipping where the store lists it, tax excluded). Use this at the buy step: the user asks where to buy it, what it costs at different stores, whether a price or sale is a good deal, if it's cheaper somewhere else, or for the link; pass a product_id from search_products. Returns the top 3 offers by default (detail=true for up to 8) and a status that says plainly when no offers exist, so never guess a price. Each offer links to its divux page, where the user picks a store. Official CPSC recall notices that mention the product are included only when there are some; their absence is not a safety check (use check_recalls for that). Do not use to buy or check out.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product id from search_products"
    },
    "condition": {
      "default": "new",
      "description": "new (default) unless the user asks for used, open-box or refurbished; 'used' covers all of those; 'any' shows everything.",
      "type": "string",
      "enum": [
        "new",
        "used",
        "any"
      ]
    },
    "include_out_of_stock": {
      "default": false,
      "type": "boolean"
    },
    "detail": {
      "default": false,
      "description": "false: top 3 offers (default, best for chat and voice). true: up to 8.",
      "type": "boolean"
    }
  },
  "required": [
    "product_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Turn a project you designed (planter, shelf, desk, raised bed, fence, patio, painted room, pipe rack) into exact numbers and a blueprint page. Works for boards, pipe, tube, sheets, and materials bought by area, volume or count. You design it, choose materials and estimate prices yourself (search the web if you can); send every piece with its real size in inches and, for the drawing, where it sits. divux returns what to buy, where to cut each board or sheet (saw blade included), size mistakes to fix (a 2x4 is really 1.5 x 3.5 in), and a link to a page with the drawing, cut diagrams and buy list. It doesn't look up store prices; when the user wants to buy an item, use search_products and compare_prices for it.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Project name, e.g. 'Cedar planter 24 x 12 in'"
    },
    "parts": {
      "minItems": 1,
      "maxItems": 150,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80,
            "description": "e.g. 'Long side' or 'Leg'"
          },
          "material": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "e.g. '2x4', '1x6 cedar', 'cedar fence picket', '3/4 plywood'"
          },
          "size": {
            "type": "array",
            "prefixItems": [
              {
                "type": "number",
                "exclusiveMinimum": 0,
                "maximum": 600
              },
              {
                "type": "number",
                "exclusiveMinimum": 0,
                "maximum": 600
              },
              {
                "type": "number",
                "exclusiveMinimum": 0,
                "maximum": 600
              }
            ],
            "items": false,
            "minItems": 3,
            "maxItems": 3,
            "description": "Real size in inches along width (x), depth (y), height (z)"
          },
          "at": {
            "description": "Corner position of each copy in inches, for the drawing; one entry per copy",
            "maxItems": 200,
            "type": "array",
            "items": {
              "type": "array",
              "prefixItems": [
                {
                  "type": "number",
                  "minimum": -600,
                  "maximum": 600
                },
                {
                  "type": "number",
                  "minimum": -600,
                  "maximum": 600
                },
                {
                  "type": "number",
                  "minimum": -600,
                  "maximum": 600
                }
              ],
              "items": false,
              "minItems": 3,
              "maxItems": 3
            }
          },
          "qty": {
            "description": "Copies when 'at' isn't given",
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          },
          "step": {
            "description": "Assembly step (1-based) this piece goes on in, matching 'steps'",
            "type": "integer",
            "minimum": 1,
            "maximum": 50
          }
        },
        "required": [
          "name",
          "material",
          "size"
        ]
      }
    },
    "stock": {
      "description": "Board lengths or sheets you'd buy, with your price estimates. Without it, divux uses common US store lengths and shows no prices.",
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "material": {
            "type": "string",
            "maxLength": 60
          },
          "length": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 600,
            "description": "Board length, or sheet length, in inches"
          },
          "width": {
            "description": "Sheet width in inches",
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 120
          },
          "price_estimate": {
            "description": "Your estimate in USD for one",
            "type": "number",
            "minimum": 0,
            "maximum": 10000
          }
        },
        "required": [
          "material",
          "length"
        ]
      }
    },
    "extras": {
      "description": "Screws, nails, glue, finish, and tools needed",
      "maxItems": 60,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          },
          "kind": {
            "type": "string",
            "enum": [
              "hardware",
              "tool",
              "supply"
            ]
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10000
          },
          "price_estimate": {
            "description": "Your estimate in USD for one (for a tool, the tool)",
            "type": "number",
            "minimum": 0,
            "maximum": 10000
          }
        },
        "required": [
          "name",
          "kind",
          "qty"
        ]
      }
    },
    "quantities": {
      "description": "Materials bought by area, volume or count: paint, stain, tile, flooring, fabric, soil, mulch, gravel, concrete",
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80,
            "description": "e.g. 'Exterior paint', 'Potting soil', 'Concrete mix', 'Floor tile'"
          },
          "form": {
            "type": "string",
            "enum": [
              "area",
              "volume",
              "count"
            ]
          },
          "dims": {
            "description": "Inches: [length, width] for area, [length, width, depth] for volume",
            "minItems": 2,
            "maxItems": 3,
            "type": "array",
            "items": {
              "type": "number",
              "exclusiveMinimum": 0,
              "maximum": 100000
            }
          },
          "amount": {
            "description": "Square feet, cubic feet or pieces, when dims don't fit",
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 1000000
          },
          "times": {
            "description": "Repeat the dims, e.g. 2 coats or 4 walls",
            "type": "integer",
            "minimum": 1,
            "maximum": 1000
          },
          "per_unit": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 1000000,
            "description": "What one unit covers (sq ft, cu ft or pieces), e.g. 350 for a gallon of paint, 0.6 for an 80 lb concrete bag"
          },
          "unit": {
            "type": "string",
            "minLength": 1,
            "maxLength": 30,
            "description": "e.g. 'gallon', '80 lb bag', 'box'"
          },
          "waste_pct": {
            "description": "Extra to buy; default 10 for area, 5 for volume, 0 for count",
            "type": "number",
            "minimum": 0,
            "maximum": 100
          },
          "price_estimate": {
            "description": "Your estimate in USD for one unit",
            "type": "number",
            "minimum": 0,
            "maximum": 10000
          }
        },
        "required": [
          "name",
          "form",
          "per_unit",
          "unit"
        ]
      }
    },
    "steps": {
      "description": "Assembly steps in order; pieces refer to them with 'step'",
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 300
      }
    },
    "kerf": {
      "default": 0.125,
      "description": "Saw blade width in inches",
      "type": "number",
      "minimum": 0,
      "maximum": 0.5
    }
  },
  "required": [
    "title",
    "parts"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Everything for a trip in one call; send only the parts needed. Destination (country, plus latitude and longitude for weather): official travel advice from the US State Department, UK FCDO and Canada side by side, active disaster alerts, weather risk for the days ahead, CDC travel health notices, public holidays and an exchange rate. Fares (from, plus to or a country): the cheapest round-trip or one-way fares travelers found recently, sorted by price, with dates, airline, stops and booking links (paid links); cached recent finds, not live quotes, and divux never books. Delays (airports): what the FAA reports right now at US airports: ground stops, delay programs, arrival and departure delays and closures. Use when someone plans or takes a trip ('anything I should know before Lisbon?', 'flights from LA to Tokyo in January?', 'any delays at SFO?'). Facts are dated and linked; never call a destination safe.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Destination country in English or two-letter code, e.g. 'Japan' or 'JP'",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "lat": {
      "description": "Latitude of the place being visited, for weather",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude of the place being visited, for weather",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "start_date": {
      "description": "Trip start, YYYY-MM-DD",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "end_date": {
      "description": "Trip end, YYYY-MM-DD",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "home_currency": {
      "description": "Traveler's currency, e.g. 'USD'",
      "type": "string",
      "minLength": 3,
      "maxLength": 3
    },
    "local_currency": {
      "description": "Destination currency, e.g. 'JPY'",
      "type": "string",
      "minLength": 3,
      "maxLength": 3
    },
    "from": {
      "description": "For fares: departure city or airport code, e.g. 'New York' or 'JFK'",
      "type": "string",
      "maxLength": 60
    },
    "to": {
      "description": "For fares: destination city or airport code, e.g. 'Lisbon'; defaults to the country's capital",
      "type": "string",
      "maxLength": 60
    },
    "depart": {
      "description": "For fares: departure month YYYY-MM or date YYYY-MM-DD; defaults to start_date",
      "type": "string",
      "maxLength": 10
    },
    "return": {
      "description": "For fares: return month or date; defaults to end_date; leave both out for one-way",
      "type": "string",
      "maxLength": 10
    },
    "one_way": {
      "description": "For fares: true for one-way; defaults to one-way when there's no return",
      "type": "boolean"
    },
    "direct_only": {
      "description": "For fares: true for nonstop flights only",
      "type": "boolean"
    },
    "airports": {
      "description": "US airport codes for the FAA's delays right now, e.g. ['SFO', 'JFK']; an empty list for every US airport with a delay",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 3,
        "maxLength": 4
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Official US facts about a car, truck or SUV from a VIN or a year, make and model: specs decoded from the VIN (NHTSA vPIC), recalls (NHTSA), owner complaints with the most-reported problem areas, NHTSA 5-star crash ratings, and EPA fuel economy (fueleconomy.gov). Add miles (you work out the distance) for the exact fuel cost of a drive: the car's EPA combined mpg (or an mpg the person gives) times this week's average pump price from the US Energy Information Administration for the state, its region or the US. Use when someone owns, is buying or is comparing a vehicle, used or new, and for road trips, commutes and 'is it cheaper to drive or fly'. A VIN gives the exact version; without one, results cover the model year. Doesn't show accident history, title status or value.

{
  "type": "object",
  "properties": {
    "vin": {
      "description": "17-character VIN, if known",
      "type": "string",
      "maxLength": 24
    },
    "year": {
      "description": "Model year, when there's no VIN",
      "type": "integer",
      "minimum": 1981,
      "maximum": 2100
    },
    "make": {
      "description": "Make, e.g. 'Honda'",
      "type": "string",
      "maxLength": 40
    },
    "model": {
      "description": "Model, e.g. 'CR-V'",
      "type": "string",
      "maxLength": 60
    },
    "miles": {
      "description": "For fuel cost: driving distance in miles, one way",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 20000
    },
    "round_trip": {
      "description": "For fuel cost: true to double the distance",
      "type": "boolean"
    },
    "state": {
      "description": "For fuel cost: two-letter US state where most of the driving happens, e.g. CA",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "fuel": {
      "description": "For fuel cost, when the model comes in both",
      "type": "string",
      "enum": [
        "regular",
        "diesel"
      ]
    },
    "mpg": {
      "description": "For fuel cost: the car's mpg, if known or when there's no specific car",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 200
    },
    "fuel_only": {
      "description": "true when only fuel cost is wanted; skips recall, complaint and crash-rating lookups (needs miles and mpg, or year/make/model)",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Exact math on sending money abroad or changing currency. Send the amount, the two currencies and each provider's fee and exchange rate (you find the quotes); divux returns what arrives with each, the exchange-rate markup against the ECB reference rate, the total cost as a percent, a ranking, and the World Bank average cost for the receiving country. With no quotes, it returns the reference rate and the benchmark. Rates are receiving currency per one unit of sending currency; a rate given the other way round is flipped and noted.

{
  "type": "object",
  "properties": {
    "send_amount": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000000,
      "description": "Amount being converted, before fees, in the sending currency"
    },
    "send_currency": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3,
      "description": "Sending currency, e.g. 'USD'"
    },
    "receive_currency": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3,
      "description": "Receiving currency, e.g. 'MXN'"
    },
    "receive_country": {
      "description": "Receiving country's two-letter code, e.g. 'MX', for the World Bank benchmark",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "quotes": {
      "description": "Quotes you found, one per provider",
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "provider": {
            "type": "string",
            "minLength": 1,
            "maxLength": 60,
            "description": "Provider name, e.g. 'Remitly'"
          },
          "fee": {
            "type": "number",
            "minimum": 0,
            "maximum": 1000000,
            "description": "Transfer fee in the sending currency (0 if none)"
          },
          "rate": {
            "type": "number",
            "exclusiveMinimum": 0,
            "description": "Exchange rate offered: receiving currency per 1 sending currency"
          },
          "receive_amount": {
            "description": "Amount the provider says arrives, if shown",
            "type": "number",
            "exclusiveMinimum": 0
          }
        },
        "required": [
          "provider",
          "fee",
          "rate"
        ]
      }
    }
  },
  "required": [
    "send_amount",
    "send_currency",
    "receive_currency"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Nutrition facts for a food from its barcode (UPC/EAN, via Open Food Facts) or its name (USDA FoodData Central): calories, protein, fat, saturated fat, carbs, sugars, fiber and sodium per 100 g or 100 ml, per serving and for gram amounts when the source uses grams, with % Daily Value from the FDA's reference values. Volume-based foods aren't converted to grams without density. Barcodes also give ingredients, allergens and Nutri-Score. When a brand is known, FDA recall reports matching it are included. Meals: send items (foods by name or barcode with grams or servings, or restaurant menu items with the numbers you read on the chain's own nutrition page) and optional daily targets; divux adds them up exactly, with % Daily Value and what's left of each target. Use for questions about what's in a food, comparing foods, whether a meal or menu order fits someone's goals, or whether a packaged food was recalled. Not medical or diet advice. Not for medicines (use check_medicine) or skincare and cosmetics (use check_cosmetic).

{
  "type": "object",
  "properties": {
    "barcode": {
      "description": "UPC or EAN printed under the bars, 8 to 14 digits",
      "type": "string",
      "maxLength": 20
    },
    "query": {
      "description": "Food name, with brand when known, e.g. 'Chobani plain Greek yogurt' or 'banana'",
      "type": "string",
      "maxLength": 100
    },
    "fdc_id": {
      "description": "A USDA FoodData Central id from an earlier result's alternatives",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "amount_g": {
      "description": "Amount eaten in grams, to scale the values",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 5000
    },
    "items": {
      "description": "For a meal: each food or menu item; divux adds them up",
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "Item name, e.g. 'Chipotle chicken burrito bowl'",
            "type": "string",
            "maxLength": 100
          },
          "query": {
            "description": "Food name to look up, with brand when known",
            "type": "string",
            "maxLength": 100
          },
          "barcode": {
            "type": "string",
            "maxLength": 20
          },
          "fdc_id": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "amount_g": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 5000
          },
          "servings": {
            "description": "How many servings; default 1",
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 20
          },
          "nutrients": {
            "description": "Per-serving numbers you read on a restaurant's or brand's own nutrition page, instead of a lookup",
            "type": "object",
            "properties": {
              "kcal": {
                "type": "number",
                "minimum": 0,
                "maximum": 10000
              },
              "protein_g": {
                "type": "number",
                "minimum": 0,
                "maximum": 1000
              },
              "fat_g": {
                "type": "number",
                "minimum": 0,
                "maximum": 1000
              },
              "sat_fat_g": {
                "type": "number",
                "minimum": 0,
                "maximum": 1000
              },
              "carbs_g": {
                "type": "number",
                "minimum": 0,
                "maximum": 2000
              },
              "sugars_g": {
                "type": "number",
                "minimum": 0,
                "maximum": 2000
              },
              "added_sugars_g": {
                "type": "number",
                "minimum": 0,
                "maximum": 2000
              },
              "fiber_g": {
                "type": "number",
                "minimum": 0,
                "maximum": 500
              },
              "sodium_mg": {
                "type": "number",
                "minimum": 0,
                "maximum": 50000
              }
            }
          }
        }
      }
    },
    "targets": {
      "description": "The person's own daily or meal targets, for what's left",
      "type": "object",
      "properties": {
        "kcal": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 10000
        },
        "protein_g": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 1000
        },
        "carbs_g": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 2000
        },
        "fat_g": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 1000
        },
        "sodium_mg": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 50000
        },
        "sugars_g": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 2000
        },
        "fiber_g": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 500
        }
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

What's in a skincare, makeup, hair or body product and what the EU Cosmetics Regulation says about each ingredient, from the European Commission's CosIng annexes: banned (Annex II, with any exception), restricted with the maximum concentration, where it may be used and the required warnings (Annex III), fragrance allergens the EU requires on the label, and preservatives, UV filters and colorants allowed only within limits. Send the ingredient list (from the package or the brand's product page), or a product name with brand or a barcode to look it up in Open Beauty Facts. Recalls and EU Safety Gate alerts naming the brand (EU, UK and Canada) are included. Use when someone asks what's in a product, whether an ingredient is allowed or limited, or which fragrance allergens it has. It doesn't rate products or say what suits someone's skin; you advise. Not medical advice. Not for medicines (use check_medicine) or food (use check_food).

{
  "type": "object",
  "properties": {
    "ingredients": {
      "description": "The INCI ingredient list, comma separated, e.g. 'Aqua, Glycerin, Niacinamide, Phenoxyethanol'",
      "type": "string",
      "maxLength": 4000
    },
    "product": {
      "description": "Product name with brand, e.g. 'CeraVe Moisturizing Cream'",
      "type": "string",
      "maxLength": 120
    },
    "barcode": {
      "description": "UPC or EAN on the package",
      "type": "string",
      "maxLength": 20
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Official facts about a US address or point: flood zone, natural-hazard ratings, weather alerts, air quality, crime rate, drinking water, internet providers, electricity price, home price trends, EV chargers, county health, childcare prices and nearby housing counselors. Use when someone is buying, renting or moving, or asks about flood or disaster risk. Send a street address, or latitude and longitude. Outside the US (a point): earthquakes, disaster alerts within 500 km and the 10-day weather risk. Also, each on request: park (a US national park's alerts, closures, fees, campgrounds); sky: true with a point (aurora chance, moon, darkness, tides); schools: true (public schools nearby; not school assignment or test scores); college (net price after aid, graduation rate, debt, earnings; add major). Send only the parts needed. Never call a place, school or college safe, good or bad; give the numbers. Not an insurance quote.

{
  "type": "object",
  "properties": {
    "address": {
      "description": "US street address with city and state, e.g. '1600 Pennsylvania Ave NW, Washington, DC 20500'",
      "type": "string",
      "maxLength": 200
    },
    "lat": {
      "description": "Latitude, when there's no street address (e.g. the center of a ZIP or city)",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude, with lat",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "place": {
      "description": "Name of the place, for the answer",
      "type": "string",
      "maxLength": 80
    },
    "park": {
      "description": "A US national park or site's name or 4-letter NPS code, e.g. 'Yosemite', 'mora'",
      "type": "string",
      "minLength": 3,
      "maxLength": 80
    },
    "sky": {
      "description": "true for the night sky at the point: aurora chance, moon, darkness and, on US coasts, tides",
      "type": "boolean"
    },
    "schools": {
      "description": "true for public schools near the address or point, closest first",
      "type": "boolean"
    },
    "level": {
      "description": "School level, with schools",
      "type": "string",
      "enum": [
        "elementary",
        "middle",
        "high"
      ]
    },
    "radius_miles": {
      "description": "School search radius, default 2",
      "type": "number",
      "minimum": 0.5,
      "maximum": 15
    },
    "limit": {
      "description": "How many schools",
      "type": "integer",
      "minimum": 1,
      "maximum": 15
    },
    "college": {
      "description": "A US college's name, e.g. 'University of Washington', 'Rice University'",
      "type": "string",
      "minLength": 3,
      "maxLength": 120
    },
    "state": {
      "description": "Two-letter state to narrow a common college name, e.g. 'WA'",
      "type": "string",
      "maxLength": 2
    },
    "major": {
      "description": "A field of study at the college, for what its graduates earn and borrow, e.g. 'nursing'",
      "type": "string",
      "maxLength": 60
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Official facts about a medicine from its brand or generic name (e.g. 'Advil', 'metformin'). In the EU and EEA (send the country): the European Medicines Agency's authorisation, what it's approved for, shortages and safety letters to doctors. In the US: whether it's over the counter or prescription, what the FDA label says it's for, its boxed warning and key warnings, a link to the full label (DailyMed), FDA recall reports, current FDA drug shortages, and what US pharmacies pay per tablet for each strength (CMS NADAC), brand next to generic. With `with` set to a second medicine, returns the exact label sentences where either label names the other. Use for questions about a medicine, its recalls, availability or cost, or a combination someone takes. Not medical advice; absence of a mention is not a sign of safety. Not for foods (use check_food) or medical devices (use check_recalls).

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Brand or generic name, e.g. 'Advil' or 'metformin'"
    },
    "with": {
      "description": "A second medicine the person takes, to look for in both labels",
      "type": "string",
      "maxLength": 80
    },
    "country": {
      "description": "Where the person lives; an EU or EEA country uses the European Medicines Agency instead of the FDA",
      "type": "string",
      "maxLength": 60
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Exact inflation math for any country: what an amount from one year is worth in another, the total price change, the average yearly rate and the latest inflation rate. The US uses the Bureau of Labor Statistics CPI-U (monthly, back to 1913); other countries use their national consumer price index as published by the World Bank (yearly). Use instead of estimating for questions like 'what is $100 from 1990 worth today?', 'what were 1,000 euros in 2000 worth in Germany now?' or 'what's inflation in India?'. Not for today's interest rates (use check_rates) or pay for a job (use check_wage).

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000000000,
      "description": "Amount in the country's currency (dollars for the US)"
    },
    "from": {
      "type": "string",
      "maxLength": 7,
      "description": "Year (1990), or for the US a month (1990-06), the amount is from"
    },
    "to": {
      "description": "Year or month to convert to; defaults to the latest figure",
      "type": "string",
      "maxLength": 7
    },
    "country": {
      "description": "Country name or two-letter code; defaults to the United States. Amounts are in that country's currency.",
      "type": "string",
      "maxLength": 60
    }
  },
  "required": [
    "amount",
    "from"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Clinicians: the federal NPI registry (CMS) for a named doctor, nurse practitioner, therapist or other provider (last name, first name, state), or clinicians of a specialty in a city or state: credential, specialty, state license number, practice address and phone, whether the record is active, and whether they opted out of Medicare. It's a registry, not a quality rating, and doesn't show insurance networks. Hospitals and nursing homes: Medicare's own ratings in a US city or ZIP code, highest rated first. Nursing homes: overall, health inspection, staffing and quality stars, total fines, Medicare's abuse icon and stale inspections. Hospitals: overall star rating, emergency services and safety measures better or worse than national. Each with a Medicare Care Compare link. Use to check who a clinician is, to start a search for one, or when someone is choosing care for themselves or a family member.

{
  "type": "object",
  "properties": {
    "kind": {
      "description": "clinician (doctor, nurse practitioner, therapist and others), hospital or nursing_home; clinician when a name or specialty is sent",
      "type": "string",
      "enum": [
        "clinician",
        "hospital",
        "nursing_home"
      ]
    },
    "last_name": {
      "description": "Clinician's last name",
      "type": "string",
      "maxLength": 60
    },
    "first_name": {
      "description": "Clinician's first name",
      "type": "string",
      "maxLength": 60
    },
    "specialty": {
      "description": "Clinician specialty, e.g. 'pediatrics', 'dermatology', 'family medicine', 'psychologist'",
      "type": "string",
      "maxLength": 80
    },
    "name": {
      "description": "Part of a hospital's or nursing home's name, to check one place",
      "type": "string",
      "maxLength": 80
    },
    "city": {
      "type": "string",
      "maxLength": 60
    },
    "state": {
      "description": "Two-letter state",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "zip": {
      "description": "Hospitals and nursing homes: 5-digit ZIP code instead of city and state",
      "type": "string",
      "maxLength": 10
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Outside the US (send the country): whether a company is in the global LEI register (GLEIF): its legal name, country, local registry number, whether it's active and its ultimate parent. In the US: the Consumer Financial Protection Bureau's complaint record (counts, top problems, on-time answers, how often people got relief) and whether it's an FDIC-insured bank; and for a public company, what it reported to the SEC (EDGAR XBRL): revenue, net income and diluted EPS for four fiscal years, the latest quarter against a year earlier, cash and shares outstanding. Use before someone chooses a bank, lender or card, when they're dealing with a problem company, or whenever someone asks how much a company made, grew or earned (send a name or a ticker such as NVDA). Complaint counts grow with company size; compare similar companies. Not investment advice; no stock prices.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Company name or US stock ticker, e.g. 'Capital One', 'Chime', 'NVDA'"
    },
    "months": {
      "description": "How far back to count; default 24",
      "type": "integer",
      "minimum": 1,
      "maximum": 120
    },
    "country": {
      "description": "Country where the company is registered or operates; leave out for the US",
      "type": "string",
      "maxLength": 60
    }
  },
  "required": [
    "company"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Clinical trials recruiting now for a condition, from ClinicalTrials.gov: title, phase, sponsor, who can join (age, sex, healthy volunteers), the nearest recruiting site and its distance, and the study page. Send the place's latitude and longitude (you work them out) to search within a radius, and an age to keep only trials that accept it. Use when someone or a family member is looking for trial options. Not medical advice. Not for a medicine's label, recalls or cost (use check_medicine).

{
  "type": "object",
  "properties": {
    "condition": {
      "type": "string",
      "minLength": 3,
      "maxLength": 120,
      "description": "Condition, e.g. 'type 1 diabetes', 'early-stage triple negative breast cancer'"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "place": {
      "description": "Name of the place, for the answer",
      "type": "string",
      "maxLength": 80
    },
    "radius_miles": {
      "description": "Default 50",
      "type": "number",
      "minimum": 5,
      "maximum": 500
    },
    "age": {
      "type": "integer",
      "minimum": 0,
      "maximum": 120
    },
    "intervention": {
      "description": "A drug or treatment to narrow to, e.g. 'pembrolizumab'",
      "type": "string",
      "maxLength": 80
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 15
    }
  },
  "required": [
    "condition"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Other countries: the central bank's policy rate (Bank for International Settlements, about 40 central banks, the ECB for euro countries) with the date it last changed and the country's latest yearly inflation. US: today's Treasury yields from the Treasury's daily par yield curve (1 month to 30 years), each next to the latest 12-month inflation (BLS CPI) as a real, after-inflation rate, and optionally the interest a sum would earn at one term. Use for 'where should I keep cash', 'what do T-bills pay', 'is a 5% CD good right now' and similar questions. Not investment advice. Not for what money from a past year is worth today (use check_inflation).

{
  "type": "object",
  "properties": {
    "amount": {
      "description": "Dollar amount to show interest for",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000000000
    },
    "term": {
      "description": "Term for the interest example; default 1 year",
      "type": "string",
      "enum": [
        "1 month",
        "3 months",
        "6 months",
        "1 year",
        "2 years",
        "5 years",
        "10 years",
        "30 years"
      ]
    },
    "country": {
      "description": "Country name or two-letter code; defaults to the United States",
      "type": "string",
      "maxLength": 60
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

What's going around. Any country: outbreaks the World Health Organization reported there in the past 12 months (Disease Outbreak News). A US state, this week, from CDC open data: the state's acute respiratory illness level, wastewater levels for COVID, flu A and RSV at a typical site with the direction over three weeks (and the sites serving a county when one is given), and whether measles or H5 bird flu was found in the state's wastewater in the last four weeks. Use for 'is flu going around', 'is COVID up', measles worries before travel or school, and visiting someone vulnerable. Send the state, and the county if known. Community levels, not medical advice or anyone's personal risk. Not for health notices abroad (use check_trip).

{
  "type": "object",
  "properties": {
    "state": {
      "description": "US state name or two-letter code, e.g. 'WA'",
      "type": "string",
      "minLength": 2,
      "maxLength": 30
    },
    "county": {
      "description": "US county name without 'County', e.g. 'King'",
      "type": "string",
      "maxLength": 40
    },
    "country": {
      "description": "Any other country, for WHO outbreak reports; leave out for the US",
      "type": "string",
      "maxLength": 60
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The lowest current price for a PC game across the digital stores Divux tracks (Steam, GOG, Epic Games Store, Humble, Fanatical, Green Man Gaming and more), each store's price and discount, and the lowest price ever seen with its date. Use when someone wants to buy a PC game or asks if it's on sale or worth waiting for. Send the game's title. US dollars; PC only.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Game title, e.g. 'Elden Ring'"
    }
  },
  "required": [
    "title"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

What a job pays. In the US: a metro area, state or the whole country, from the Bureau of Labor Statistics' Occupational Employment and Wage Statistics (May 2025, all industries): median yearly pay, the 10th to 90th percentile range and how many people do the job. Any other country: average monthly pay of employees by broad job group (managers, professionals, technicians, trades and more) in local currency, from the International Labour Organization's ILOSTAT. Use for job offers, salary negotiations, moving and career questions. Send the job title and a city, state (WA) or nothing for national. Not for inflation or what old dollars are worth (use check_inflation).

{
  "type": "object",
  "properties": {
    "job": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Job title, e.g. 'registered nurse', 'electrician', 'software developer'"
    },
    "place": {
      "description": "US only: city ('Seattle', 'Austin, TX'), state ('WA' or 'Washington'), or leave out for national",
      "type": "string",
      "maxLength": 60
    },
    "country": {
      "description": "Country name or two-letter code; defaults to the United States",
      "type": "string",
      "maxLength": 60
    }
  },
  "required": [
    "job"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Look up official recalls in the US (default), the UK or Canada. In the US, category 'product' searches CPSC consumer-product recalls by words in the product name (brand plus product type works best, e.g. 'Rowenta vacuum'); 'food_drug' searches FDA food, drug and medical device enforcement reports (e.g. 'CPAP', 'insulin pump'); 'vehicle' searches NHTSA by make, model and model year. With country 'GB' it searches the UK's product recalls and safety reports (OPSS) and Food Standards Agency alerts; with 'CA', Health Canada's recalls (food, health products, medical devices, consumer products); with any EU or EEA country (e.g. 'DE', 'France'), the EU's Safety Gate alerts on dangerous non-food products and vehicles from the last three years. Use this when someone asks if a product, food, medicine or car was recalled, is safe to buy or use, or before they buy something used. An empty result means none was found, not that the item is safe. Not for medical advice.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "product",
        "food_drug",
        "vehicle"
      ],
      "description": "product (CPSC), food_drug (FDA food, drugs and medical devices) or vehicle (NHTSA)"
    },
    "query": {
      "description": "Product, food, drug or medical device words, for product and food_drug, e.g. 'stroller', 'peanut butter' or 'CPAP'",
      "type": "string",
      "maxLength": 80
    },
    "make": {
      "description": "Vehicle make, e.g. 'Honda' (vehicle only)",
      "type": "string",
      "maxLength": 40
    },
    "model": {
      "description": "Vehicle model, e.g. 'Civic' (vehicle only)",
      "type": "string",
      "maxLength": 40
    },
    "year": {
      "description": "Vehicle model year (vehicle only)",
      "type": "integer",
      "minimum": 1950,
      "maximum": 2100
    },
    "country": {
      "description": "Where the person lives or bought it: United States (default), United Kingdom, Canada or any EU/EEA country",
      "type": "string",
      "maxLength": 60
    }
  },
  "required": [
    "category"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Check whether an appliance model is ENERGY STAR certified, or list certified models (most efficient first), from the EPA's official data. Categories: heat pumps, heat pump water heaters, clothes washers, clothes dryers, refrigerators, dishwashers. Use this when someone asks if a model is ENERGY STAR, which models are most efficient, or about energy-efficient appliance choices. Heat pump answers include the fact that federal 25C/25D tax credits ended after Dec 31, 2025. Do not use for prices (use compare_prices) or recalls.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "heat_pump",
        "heat_pump_water_heater",
        "clothes_washer",
        "clothes_dryer",
        "refrigerator",
        "dishwasher"
      ],
      "description": "Appliance category"
    },
    "brand": {
      "description": "Brand to filter by, e.g. 'Rheem'",
      "type": "string",
      "maxLength": 40
    },
    "model": {
      "description": "Model number or part of it, to check certification",
      "type": "string",
      "maxLength": 40
    },
    "most_efficient_only": {
      "default": false,
      "description": "Only models meeting ENERGY STAR Most Efficient criteria (not available for water heaters)",
      "type": "boolean"
    }
  },
  "required": [
    "category"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}