PriceBee

Search the products and prices of the online shops PriceBee compares in Lithuania, Latvia or Estonia (phones, laptops, TVs, appliances, cosmetics and much more), the same search as pricebee.lt, pricebee.lv and pricebee.ee. Ask for the country if it isn't clear. Use it when someone wants to buy something, compare prices or find where a product is cheapest. Works best with concrete product names or models ("Samsung Galaxy S25", "Dyson V15"); put a budget in max_price_eur, not in the query. Results are products (compared across shops; get_product lists their shops) or offers of a single shop for things PriceBee hasn't matched to a product. Prices are in euros including VAT. Give the user each result's url. price_overview describes the prices of every match, for suggesting budgets. search_url opens all results for the query on PriceBee (without the price range), for when the user wants to browse more.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "What to look for, ideally a product name or model, in any language. No prices here.",
      "type": "string"
    },
    "country": {
      "description": "The country to shop in: lt (Lithuania, default), lv (Latvia) or ee (Estonia).",
      "enum": [
        "lt",
        "lv",
        "ee"
      ],
      "type": "string"
    },
    "min_price_eur": {
      "description": "Lowest price in euros.",
      "minimum": 0,
      "type": "number"
    },
    "max_price_eur": {
      "description": "Highest price in euros (the budget).",
      "minimum": 0,
      "type": "number"
    },
    "limit": {
      "description": "How many results, 1-20 (default 8).",
      "minimum": 1,
      "maximum": 20,
      "type": "integer"
    }
  },
  "required": [
    "query"
  ]
}

One product with the shops that sell it in a country and their offers (variants, colours) with prices, cheapest first (the first 15 listed, all counted), by the product id search_products returned (results of type "product"); pass the same country as that search. Use it to answer where something is cheapest or to compare shops. Give the user the product's url: its PriceBee page links to each shop.

{
  "type": "object",
  "properties": {
    "product_id": {
      "description": "The id of a search_products result of type \"product\".",
      "minimum": 1,
      "type": "integer"
    },
    "country": {
      "description": "The country to shop in: lt (Lithuania, default), lv (Latvia) or ee (Estonia).",
      "enum": [
        "lt",
        "lv",
        "ee"
      ],
      "type": "string"
    }
  },
  "required": [
    "product_id"
  ]
}

Search the mobile phone plans of every operator in Lithuania, Latvia or Estonia, as compared on PriceBee. Prices are in euros, per month unless price_period says otherwise, from the operators' own sites, updated daily. Use it whenever someone wants a mobile, SIM-only, prepaid or data plan, or to compare operators. Set only the filters the user actually asked for. Each plan's pricebee_url (Lithuania) or order_url is the link to give the user.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "lt Lithuania (default), lv Latvia, ee Estonia.",
      "enum": [
        "lt",
        "lv",
        "ee"
      ],
      "type": "string"
    },
    "max_monthly_price_eur": {
      "description": "Highest monthly price in euros (per month even for weekly or daily plans).",
      "minimum": 0,
      "type": "number"
    },
    "min_data_gb": {
      "description": "At least this much mobile data per month, in GB. Unlimited plans match too.",
      "minimum": 0,
      "type": "number"
    },
    "unlimited_data": {
      "description": "Only plans with unlimited mobile data.",
      "type": "boolean"
    },
    "min_minutes": {
      "description": "At least this many call minutes. Unlimited plans match too.",
      "minimum": 0,
      "type": "integer"
    },
    "unlimited_minutes": {
      "description": "Only plans with unlimited calls.",
      "type": "boolean"
    },
    "needs_5g": {
      "description": "Only plans on a 5G network.",
      "type": "boolean"
    },
    "esim": {
      "description": "Only plans the operator says work with an eSIM.",
      "type": "boolean"
    },
    "data_in_eu": {
      "description": "Only plans with data while roaming in the EU.",
      "type": "boolean"
    },
    "streaming": {
      "description": "Only plans that include a streaming service (Netflix, Disney+, Go3, ...).",
      "type": "boolean"
    },
    "commitment": {
      "description": "Contract length: none (cancel any time), 12 or 24 months.",
      "enum": [
        "none",
        "12",
        "24"
      ],
      "type": "string"
    },
    "prepaid": {
      "description": "true: only prepaid (pay as you go); false: only contract plans.",
      "type": "boolean"
    },
    "operator": {
      "description": "Only this operator, by name or domain, e.g. \"Telia\", \"tele2.lt\", \"LMT\".",
      "type": "string"
    },
    "audience": {
      "description": "Plans made for this group only (e.g. seniors, pupils).",
      "enum": [
        "kids",
        "pupils",
        "youth",
        "students",
        "seniors"
      ],
      "type": "string"
    },
    "for_devices": {
      "description": "true: IoT plans for trackers, alarms and other devices instead of phones.",
      "type": "boolean"
    },
    "sort": {
      "description": "price_asc cheapest first (default), popular, data_desc most data, minutes_desc most minutes.",
      "enum": [
        "price_asc",
        "popular",
        "data_desc",
        "minutes_desc"
      ],
      "type": "string"
    },
    "limit": {
      "description": "How many plans to return, 1-20 (default 8).",
      "minimum": 1,
      "maximum": 20,
      "type": "integer"
    }
  }
}

One mobile plan in full, by the id search_mobile_plans returned: every contract option with promos, crossed-out and announced prices, order fees and the total over the commitment, data roaming outside the EU, calls and SMS to the EU, and PriceBee's overview of who the plan suits. Use it when the user asks about a specific plan or wants the fine print before choosing.

{
  "type": "object",
  "properties": {
    "plan_id": {
      "description": "The plan id from search_mobile_plans.",
      "minimum": 1,
      "type": "integer"
    },
    "language": {
      "description": "The user's language for the plan overview: en (default), lt, ru, lv or ee.",
      "enum": [
        "en",
        "lt",
        "ru",
        "lv",
        "ee"
      ],
      "type": "string"
    }
  },
  "required": [
    "plan_id"
  ]
}

The mobile operators PriceBee compares in a country (Lithuania, Latvia or Estonia), with how many plans each has, its cheapest monthly price, and whether it has 5G plans. Use it for questions about which operators exist, or to pick operator names for search_mobile_plans.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "lt Lithuania (default), lv Latvia, ee Estonia.",
      "enum": [
        "lt",
        "lv",
        "ee"
      ],
      "type": "string"
    }
  }
}