The Amazon Rufus endpoint sends any shopping query to Amazon’s AI shopping assistant and returns curated product recommendations and follow-up questions as structured JSON. ScrapeLLM handles authentication, anti-bot tokens, SSE parsing, and marketplace routing server-side.Documentation Index
Fetch the complete documentation index at: https://docs.scrapellm.com/llms.txt
Use this file to discover all available pages before exploring further.
Structured product cards with ASINsEvery product recommendation includes an ASIN — Amazon’s unique product identifier — making it easy to cross-reference products, track recommendation changes over time, and link directly to product listings.
Overview
Use this endpoint to monitor which products Amazon’s AI recommends for any category, track competitor product placements in Rufus answers, and research what editorial tags (like “Best overall” or “Best value”) Amazon assigns to products in your space.Unique features
- ASINs: Amazon Standard Identification Numbers for every recommended product — enabling direct product tracking
- Editorial tags: Rufus’s curated labels like “Best overall”, “Best value”, or “Most reviewed”
- Related questions: Follow-up questions Rufus suggests — useful for understanding shopping intent
- Multi-marketplace: Automatic routing to the correct Amazon marketplace based on country code
Request parameters
The shopping query to send to Amazon Rufus. Maximum 4,000 characters.
Maps to the Amazon marketplace —
US → amazon.com, GB → amazon.co.uk, DE → amazon.de, etc.Skip the response cache and always fetch a fresh result.
Maximum seconds to wait for Rufus to respond (10–600).
Supported marketplaces
| Country code | Marketplace |
|---|---|
US | amazon.com |
GB | amazon.co.uk |
DE | amazon.de |
FR | amazon.fr |
IT | amazon.it |
ES | amazon.es |
CA | amazon.ca |
AU | amazon.com.au |
JP | amazon.co.jp |
IN | amazon.in |
4 credits per request
Example request
Response schema
Includes common response fields plus:| Field | Type | Description |
|---|---|---|
result | string | Rufus’s plain-text answer to the query |
products | array | Structured product recommendations |
products[].asin | string | Amazon Standard Identification Number |
products[].title | string | Product title as shown in Rufus |
products[].rating | string | Customer rating (e.g. "4.5"). Nullable |
products[].reviews | string | Number of customer reviews (e.g. "18,423"). Nullable |
products[].image_url | string | Product image URL. Nullable |
products[].category | string | Product category label. Nullable |
products[].url | string | Absolute URL to the Amazon product listing. Nullable |
products[].footer | string | Rufus editorial tag (e.g. "Best overall", "Best value"). Nullable |
related_questions | array | Follow-up questions Rufus suggests for further shopping research |
interim_messages | array | Loading-state messages localised to the marketplace (e.g. “Checking reviews…”) |
credits_used | integer | Credits consumed — always 4 for Amazon Rufus |
elapsed_ms | float | End-to-end request duration in milliseconds |
cached | boolean | true if served from cache |
Common questions
Why does Amazon Rufus cost 4 credits instead of 3?
Rufus requires authenticated Amazon sessions with anti-bot token handling and real-time SSE stream parsing — more infrastructure than a standard web scrape. The extra credit reflects this complexity.Are all product fields always populated?
No. Fields likerating, reviews, image_url, category, url, and footer are nullable — Rufus doesn’t always return all fields for every product. Always check for null before processing.
How do I track if my product appears in Rufus recommendations?
Query your product category and checkproducts[].asin for your ASIN. Run the same prompt repeatedly across different countries to monitor regional placement and track changes over time.