add_interest

Save an interest for the user in plain words, e.g. "trail running shoes under 80 euro" or "Lego Technic at least 30% off": Lowbird then alerts them and fills their deals feed. Requires signing in.

Argument	Type	Description
text*	string	The interest in plain words, with the product words in the marketplace language (amazon.it: Italian, translate if needed), e.g. "cuffie Sony sotto 200 euro" or "scarpe trail running under 90 euro".

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "The interest in plain words, with the product words in the marketplace language (amazon.it:\nItalian, translate if needed), e.g. \"cuffie Sony sotto 200 euro\" or \"scarpe trail running\nunder 90 euro\"."
    }
  }
}

feed_choice

Record the user's choice on a card of their deals feed (follow or skip): Lowbird learns their taste. Used by the Lowbird view.

Argument	Type	Description
action*	string	`follow` or `pass`.
product_id*	string	Lowbird product id of the card.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product_id",
    "action"
  ],
  "properties": {
    "action": {
      "type": "string",
      "description": "`follow` or `pass`."
    },
    "product_id": {
      "type": "string",
      "format": "uuid",
      "description": "Lowbird product id of the card."
    }
  }
}

get_product

Get a product with its current price, 90-day range, all-time low and a verdict on whether now is a good time to buy, shown to the user as a card with the price chart. Accepts an Amazon link, an ASIN or a Lowbird id.

read-only

Argument	Type	Description
product*	string	An Amazon product link (also amzn.eu short links), an ASIN, or a Lowbird product id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product"
  ],
  "properties": {
    "product": {
      "type": "string",
      "description": "An Amazon product link (also amzn.eu short links), an ASIN, or a Lowbird product id."
    }
  }
}

list_interests

The user's saved interests (what Lowbird looks for: words, brands, max price, minimum discount). Requires signing in.

read-only

No arguments.

Input schema (JSON)

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

list_watches

Products the user follows, with their alert threshold and current price. Requires signing in.

read-only

No arguments.

Input schema (JSON)

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

my_deals_feed

The user's personal feed: deals and price drops matching their interests, best first, shown to the user as a carousel. Requires signing in to Lowbird (the sign-in address).

read-only

Argument	Type	Description
limit	integer \| null	Maximum number of items (default 10, max 25).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": [
        "integer",
        "null"
      ],
      "format": "uint8",
      "maximum": 255,
      "minimum": 0,
      "description": "Maximum number of items (default 10, max 25)."
    }
  }
}

pause_interest

Pause or resume one of the user's interests (no alerts or feed items while paused). Requires signing in.

Argument	Type	Description
paused	boolean \| null	`true` to pause (default), `false` to resume.
interest_id*	string	Id of the interest (from `list_interests`).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "interest_id"
  ],
  "properties": {
    "paused": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "`true` to pause (default), `false` to resume."
    },
    "interest_id": {
      "type": "string",
      "format": "uuid",
      "description": "Id of the interest (from `list_interests`)."
    }
  }
}

price_drops

Current Amazon price drops found by Lowbird: products now cheaper than their 30-day median, biggest drop first. Optionally narrowed by words.

read-only

Argument	Type	Description
limit	integer \| null	Maximum number of products (default 10, max 25).
query	string \| null	Optional words to narrow the drops, in the marketplace language (amazon.it: Italian), e.g. "cuffie" or "Samsung".
min_drop_percent	integer \| null	Minimum drop versus the 30-day median, in percent (default 15).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": [
        "integer",
        "null"
      ],
      "format": "uint8",
      "maximum": 255,
      "minimum": 0,
      "description": "Maximum number of products (default 10, max 25)."
    },
    "query": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional words to narrow the drops, in the marketplace language (amazon.it: Italian), e.g.\n\"cuffie\" or \"Samsung\"."
    },
    "min_drop_percent": {
      "type": [
        "integer",
        "null"
      ],
      "format": "uint8",
      "maximum": 255,
      "minimum": 0,
      "description": "Minimum drop versus the 30-day median, in percent (default 15)."
    }
  }
}

price_history

Daily price history of a product (lowest price of each day, coupons included) with a verdict on the current price. Accepts an Amazon link, an ASIN or a Lowbird id.

read-only

Argument	Type	Description
days	integer \| null	How many days back (default 90, max 180).
product*	string	An Amazon product link, an ASIN, or a Lowbird product id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product"
  ],
  "properties": {
    "days": {
      "type": [
        "integer",
        "null"
      ],
      "format": "uint16",
      "maximum": 65535,
      "minimum": 0,
      "description": "How many days back (default 90, max 180)."
    },
    "product": {
      "type": "string",
      "description": "An Amazon product link, an ASIN, or a Lowbird product id."
    }
  }
}

recent_alerts

The user's most recent price alerts (thresholds reached, drops, back in stock, all-time lows, deals for their interests). Requires signing in.

read-only

Argument	Type	Description
limit	integer \| null	Maximum number of items (default 10, max 25).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": [
        "integer",
        "null"
      ],
      "format": "uint8",
      "maximum": 255,
      "minimum": 0,
      "description": "Maximum number of items (default 10, max 25)."
    }
  }
}

remove_interest

Delete one of the user's interests. Requires signing in.

destructive

Argument	Type	Description
interest_id*	string	Id of the interest (from `list_interests`).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "interest_id"
  ],
  "properties": {
    "interest_id": {
      "type": "string",
      "format": "uuid",
      "description": "Id of the interest (from `list_interests`)."
    }
  }
}

search_products

Search the Lowbird catalog of tracked Amazon products. Returns current price, when it was recorded, and the 90-day low/high/average.

read-only

Argument	Type	Description
limit	integer \| null	Maximum number of products (default 10, max 25).
query*	string	Words to search in title, brand, ASIN or category, in the marketplace language (amazon.it: Italian, translate if needed), e.g. "robot aspirapolvere" or "Lego Technic".

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": [
        "integer",
        "null"
      ],
      "format": "uint8",
      "maximum": 255,
      "minimum": 0,
      "description": "Maximum number of products (default 10, max 25)."
    },
    "query": {
      "type": "string",
      "description": "Words to search in title, brand, ASIN or category, in the marketplace language (amazon.it:\nItalian, translate if needed), e.g. \"robot aspirapolvere\" or \"Lego Technic\"."
    }
  }
}

show_products

Show products to the user as a carousel with image, price, when it was recorded and buttons to follow or open them. Use it only when the user wants to see, browse or compare products, after choosing them with the other tools (which return data only). Up to 10 products: Lowbird ids, Amazon links or ASINs.

read-only

Argument	Type	Description
title	string \| null	Optional heading for the carousel, in the user's language, e.g. "Robot aspirapolvere sotto 300 €".
products*	array	Up to 10 products to show, best first: Lowbird product ids (from the other tools), Amazon links or ASINs.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "products"
  ],
  "properties": {
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional heading for the carousel, in the user's language, e.g. \"Robot aspirapolvere sotto 300 €\"."
    },
    "products": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Up to 10 products to show, best first: Lowbird product ids (from the other tools), Amazon\nlinks or ASINs."
    }
  }
}

track_product

Start tracking an Amazon product on Lowbird (it is added to the shared catalog; the first price arrives within minutes). Does not follow it for the user.

Argument	Type	Description
url*	string	An Amazon product link or ASIN.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "An Amazon product link or ASIN."
    }
  }
}

unwatch_product

Stop following a product for the user. Accepts an Amazon link, an ASIN or a Lowbird id. Requires signing in.

destructive

Argument	Type	Description
product*	string	An Amazon product link (also amzn.eu short links), an ASIN, or a Lowbird product id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product"
  ],
  "properties": {
    "product": {
      "type": "string",
      "description": "An Amazon product link (also amzn.eu short links), an ASIN, or a Lowbird product id."
    }
  }
}

watch_product

Follow a product for the user: Lowbird alerts them (app, email or Telegram, as they chose) when the price drops, or goes below `target_price` if given. Accepts an Amazon link, an ASIN or a Lowbird id; products not yet tracked are added. Nothing is deleted: if the product is already followed, only its alert threshold is updated, and the user can change it again or unfollow at any time. Requires signing in.

Argument	Type	Description
product*	string	An Amazon product link, an ASIN or a Lowbird product id.
target_price	number \| null	Optional alert threshold in the marketplace currency, e.g. 79.90.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product"
  ],
  "properties": {
    "product": {
      "type": "string",
      "description": "An Amazon product link, an ASIN or a Lowbird product id."
    },
    "target_price": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "description": "Optional alert threshold in the marketplace currency, e.g. 79.90."
    }
  }
}

Lowbird

Try it

add_interest

Lowbird

Try it

add_interest

Install

Tools (16)

Security checkA100/100