request

Fetch structured data by URL or ASIN with optional field filters. Same payload as get_product, but accepts an Amazon product URL directly and lets you request only the fields you need.

When to use: when you have a product URL instead of an ASIN, or want a trimmed payload.

Parameters

Name	Type	Required	Description
`url`	string	one of two	A valid Amazon product URL containing an ASIN
`asin`	string	one of two	10-character Amazon ASIN
`fields`	list of string	no	Subset of top-level fields to return

Available fields

profile, price, trend, ratings, competitiveness, seller, facts_check, red_flags, sentiment

Example call

{
  "jsonrpc": "2.0", "id": 9, "method": "tools/call",
  "params": {
    "name": "request",
    "arguments": {
      "url": "https://www.amazon.com/dp/B01MTB55WH",
      "fields": ["price", "ratings"]
    }
  }
}

Response shape

{
  "price": {"price_current": 29.99, "currency": "USD", "price_as_of": "2026-11-04T08:12:00Z"},
  "ratings": {"rating": 4.6, "review_count": 25000, "rating_distribution": {"...": "..."}},
  "notes": {"...": "..."}
}

*(abbreviated for readability)*

Field notes

Unknown fields values return an error listing the available keys.
Quantitative fields return insufficient_sample when the underlying sample is too small.

Tool note

> Returns raw data by structured fields; see schema for field definitions. Quantitative fields return insufficient_sample when the sample is insufficient.

Related tools

get_product — full payload, ASIN input
get_price — price-only shortcut