Scrapers
Amazon Rufus
Extract structured product recommendations from Amazon Rufus - ASINs, ratings, editorial tags, and follow-up questions - as clean JSON.
GET
/
scrapers
/
amazon_rufus
cURL
# Streaming can take up to 300s - --max-time matches the server timeout
curl --max-time 300 \
-G "https://api.scrapellm.com/scrapers/amazon_rufus" \
--data-urlencode "api_key=YOUR_API_KEY" \
--data-urlencode "prompt=What are the best wireless headphones for working from home?" \
--data-urlencode "country=US"import requests
response = requests.get(
"https://api.scrapellm.com/scrapers/amazon_rufus",
params={
"api_key": "YOUR_API_KEY",
"prompt": "What are the best wireless headphones for working from home?",
"country": "US",
}
)
print(response.json())
const params = new URLSearchParams({
api_key: "YOUR_API_KEY",
prompt: "What are the best wireless headphones for working from home?",
country: "US",
});
const response = await fetch(
`https://api.scrapellm.com/scrapers/amazon_rufus?${params}`
);
const data = await response.json();
console.log(data);
const params = new URLSearchParams({
api_key: "YOUR_API_KEY",
prompt: "What are the best wireless headphones for working from home?",
country: "US",
});
const response = await fetch(
`https://api.scrapellm.com/scrapers/amazon_rufus?${params}`
);
const data = await response.json();
console.log(data);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scrapellm.com/scrapers/amazon_rufus",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scrapellm.com/scrapers/amazon_rufus"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scrapellm.com/scrapers/amazon_rufus")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scrapellm.com/scrapers/amazon_rufus")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"scraper": "amazon_rufus",
"status": "done",
"job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"prompt": "best wireless headphones under $100",
"country": "US",
"products": [
{
"asin": "B09XYZ1234",
"title": "Sony WH-CH520 Wireless Headphones",
"rating": "4.5",
"reviews": "18,423",
"image_url": "https://m.media-amazon.com/images/I/example.jpg",
"image_alt": "Sony WH-CH520 Wireless Headphones",
"category": "Electronics",
"url": "https://www.amazon.com/dp/B09XYZ1234",
"footer": "Best overall"
}
],
"related_questions": [
"What headphones have the best noise cancellation?",
"Sony vs Bose wireless headphones comparison"
],
"interim_messages": [
"Checking reviews...",
"Gathering data..."
],
"credits_used": 3,
"elapsed_ms": 8341.2,
"cached": false,
"markdown_url": "https://scrapellm.com/md/3fa85f64-5717-4562-b3fc-2c963f66afa6.md"
}{
"error": "Missing API key. Pass your key in the X-API-Key header or as ?api_key= in the URL."
}{
"error": "Invalid API key."
}{
"error": "Invalid API key."
}{
"error": "Invalid API key."
}{
"error": "Invalid API key."
}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
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 |
Example request
# Streaming can take up to 300s - --max-time matches the server timeout
curl --max-time 300 \
-G "https://api.scrapellm.com/scrapers/amazon-rufus" \
--data-urlencode "api_key=YOUR_API_KEY" \
--data-urlencode "prompt=What are the best wireless headphones for working from home?" \
--data-urlencode "country=US"
import requests
response = requests.get(
"https://api.scrapellm.com/scrapers/amazon-rufus",
headers={"X-API-Key": "YOUR_API_KEY"},
params={
"prompt": "What are the best wireless headphones for working from home?",
"country": "US",
}
)
data = response.json()
for product in data["products"]:
print(f"{product['asin']} {product['rating']}★ {product['title'][:80]}")
const params = new URLSearchParams({
prompt: "What are the best wireless headphones for working from home?",
country: "US",
});
const response = await fetch(
`https://api.scrapellm.com/scrapers/amazon-rufus?${params}`,
{ headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const data = await response.json();
for (const product of data.products) {
console.log(`${product.asin} ${product.rating}★ ${product.title.slice(0, 80)}`);
}
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.
Which marketplaces support all features?
All supported marketplaces return ASINs, titles, and follow-up questions. Rating, review count, and editorial tags depend on the marketplace’s Rufus implementation and may vary by region.Authorizations
ApiKeyHeaderApiKeyQuery
Query Parameters
Response
Scrape completed successfully.
cURL
# Streaming can take up to 300s - --max-time matches the server timeout
curl --max-time 300 \
-G "https://api.scrapellm.com/scrapers/amazon_rufus" \
--data-urlencode "api_key=YOUR_API_KEY" \
--data-urlencode "prompt=What are the best wireless headphones for working from home?" \
--data-urlencode "country=US"import requests
response = requests.get(
"https://api.scrapellm.com/scrapers/amazon_rufus",
params={
"api_key": "YOUR_API_KEY",
"prompt": "What are the best wireless headphones for working from home?",
"country": "US",
}
)
print(response.json())
const params = new URLSearchParams({
api_key: "YOUR_API_KEY",
prompt: "What are the best wireless headphones for working from home?",
country: "US",
});
const response = await fetch(
`https://api.scrapellm.com/scrapers/amazon_rufus?${params}`
);
const data = await response.json();
console.log(data);
const params = new URLSearchParams({
api_key: "YOUR_API_KEY",
prompt: "What are the best wireless headphones for working from home?",
country: "US",
});
const response = await fetch(
`https://api.scrapellm.com/scrapers/amazon_rufus?${params}`
);
const data = await response.json();
console.log(data);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scrapellm.com/scrapers/amazon_rufus",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scrapellm.com/scrapers/amazon_rufus"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scrapellm.com/scrapers/amazon_rufus")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scrapellm.com/scrapers/amazon_rufus")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"scraper": "amazon_rufus",
"status": "done",
"job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"prompt": "best wireless headphones under $100",
"country": "US",
"products": [
{
"asin": "B09XYZ1234",
"title": "Sony WH-CH520 Wireless Headphones",
"rating": "4.5",
"reviews": "18,423",
"image_url": "https://m.media-amazon.com/images/I/example.jpg",
"image_alt": "Sony WH-CH520 Wireless Headphones",
"category": "Electronics",
"url": "https://www.amazon.com/dp/B09XYZ1234",
"footer": "Best overall"
}
],
"related_questions": [
"What headphones have the best noise cancellation?",
"Sony vs Bose wireless headphones comparison"
],
"interim_messages": [
"Checking reviews...",
"Gathering data..."
],
"credits_used": 3,
"elapsed_ms": 8341.2,
"cached": false,
"markdown_url": "https://scrapellm.com/md/3fa85f64-5717-4562-b3fc-2c963f66afa6.md"
}{
"error": "Missing API key. Pass your key in the X-API-Key header or as ?api_key= in the URL."
}{
"error": "Invalid API key."
}{
"error": "Invalid API key."
}{
"error": "Invalid API key."
}{
"error": "Invalid API key."
}