Tosheroon

Search for Amazon products by keyword, ASIN, or Amazon URL with optional filters for brand, category, price range, stock status, and sorting. Returns product IDs for use with other tools. Rate limited to 20 req/min without an API key — use the register_api_key tool for 120 req/min.

{
  "type": "object",
  "properties": {
    "brand": {
      "description": "Filter by brand name (e.g. Apple, Samsung, Sony)",
      "type": "string"
    },
    "category": {
      "description": "Filter by category (e.g. Laptops, Headphones, TVs)",
      "type": "string"
    },
    "in_stock": {
      "default": true,
      "description": "When true, only returns in-stock products. When false, returns both in-stock and out-of-stock products (it does NOT filter to out-of-stock only). Defaults to true.",
      "type": "boolean"
    },
    "limit": {
      "default": 20,
      "description": "Number of results to return (1-50). Defaults to 20.",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "max_price": {
      "description": "Maximum price in the region's currency (e.g. 500 for £500)",
      "type": "number"
    },
    "min_price": {
      "description": "Minimum price in the region's currency (e.g. 100 for £100)",
      "type": "number"
    },
    "query": {
      "description": "Search keyword, Amazon ASIN (e.g. B08N5WRWNW), or Amazon product URL. Optional when using brand/category filters.",
      "type": "string"
    },
    "region": {
      "default": "uk",
      "description": "Country code (e.g. uk, us, de). Defaults to uk.",
      "type": "string"
    },
    "sort_by": {
      "default": "relevance",
      "description": "Sort order for results. Defaults to relevance.",
      "enum": [
        "relevance",
        "price_asc",
        "price_desc",
        "newest"
      ],
      "type": "string"
    }
  },
  "required": []
}

Get detailed product information by product_id. Returns full product details including current price and affiliate buy link.

{
  "type": "object",
  "properties": {
    "product_id": {
      "description": "The product ID returned by search_products or other discovery tools",
      "type": "integer"
    }
  },
  "required": [
    "product_id"
  ]
}

Get price history for a product by product_id. Returns daily prices for up to 90 days.

{
  "type": "object",
  "properties": {
    "days": {
      "default": 90,
      "description": "Number of days of history to return (1-90). Defaults to 90.",
      "maximum": 90,
      "minimum": 1,
      "type": "integer"
    },
    "product_id": {
      "description": "The product ID returned by search_products or other discovery tools",
      "type": "integer"
    }
  },
  "required": [
    "product_id"
  ]
}

Get Amazon products with recent significant price drops. Returns products sorted by drop percentage.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "description": "Number of results to return (1-20). Defaults to 10.",
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "region": {
      "default": "uk",
      "description": "Country code (e.g. uk, us, de). Defaults to uk.",
      "type": "string"
    }
  },
  "required": []
}

Browse Amazon products by category. Omit category to list all available categories. Provide a category name to get products in that category.

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Category name to browse. Omit to list all available categories.",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Number of products to return (1-50). Defaults to 20.",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "region": {
      "default": "uk",
      "description": "Country code (e.g. uk, us, de). Defaults to uk.",
      "type": "string"
    }
  },
  "required": []
}

Browse Amazon products by brand name. Returns products matching the given brand.

{
  "type": "object",
  "properties": {
    "brand": {
      "description": "Brand name to search for (e.g. Sony, Apple, Samsung)",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Number of products to return (1-50). Defaults to 20.",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "region": {
      "default": "uk",
      "description": "Country code (e.g. uk, us, de). Defaults to uk.",
      "type": "string"
    }
  },
  "required": [
    "brand"
  ]
}

Get price statistics for a product (all-time high/low, mean, median, histogram). Uses cached data for performance.

{
  "type": "object",
  "properties": {
    "product_id": {
      "description": "The product ID returned by search_products or other discovery tools",
      "type": "integer"
    }
  },
  "required": [
    "product_id"
  ]
}

Get a 30-day price forecast for a product. Requires sufficient price history. Returns predicted prices with confidence scores.

{
  "type": "object",
  "properties": {
    "product_id": {
      "description": "The product ID returned by search_products or other discovery tools",
      "type": "integer"
    }
  },
  "required": [
    "product_id"
  ]
}

Create a price drop alert. You'll receive an email when the product drops to or below your target price.

{
  "type": "object",
  "properties": {
    "email": {
      "description": "The email address to send the alert to",
      "type": "string"
    },
    "product_id": {
      "description": "The product ID returned by search_products or other discovery tools",
      "type": "integer"
    },
    "target_price": {
      "description": "The target price — alert is sent when the product drops to or below this price",
      "type": "number"
    }
  },
  "required": [
    "product_id",
    "email",
    "target_price"
  ]
}

Create a back-in-stock alert. You'll receive an email when the product becomes available again.

{
  "type": "object",
  "properties": {
    "email": {
      "description": "The email address to send the alert to",
      "type": "string"
    },
    "product_id": {
      "description": "The product ID returned by search_products or other discovery tools",
      "type": "integer"
    }
  },
  "required": [
    "product_id",
    "email"
  ]
}

Find products similar to a given product. Useful for discovering alternatives or related items.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 6,
      "description": "Number of similar products to return (1-20). Defaults to 6.",
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "product_id": {
      "description": "The product ID to find similar products for",
      "type": "integer"
    }
  },
  "required": [
    "product_id"
  ]
}

Register for a free API key to increase your rate limits from 20/min to 120/min. An API key will be emailed to you.

{
  "type": "object",
  "properties": {
    "email": {
      "description": "Your email address. The API key will be sent here.",
      "type": "string"
    }
  },
  "required": [
    "email"
  ]
}