Ask Amazon Rufus
curl --request POST \
--url https://scrapebadger.com/v1/rufus/ask \
--header 'X-API-Key: <x-api-key>'import requests
url = "https://scrapebadger.com/v1/rufus/ask"
headers = {"X-API-Key": "<x-api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'X-API-Key': '<x-api-key>'}};
fetch('https://scrapebadger.com/v1/rufus/ask', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/rufus/ask",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"X-API-Key: <x-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://scrapebadger.com/v1/rufus/ask"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("X-API-Key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://scrapebadger.com/v1/rufus/ask")
.header("X-API-Key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/rufus/ask")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"answer": "<string>",
"products": [
{}
],
"thread_id": {},
"model": "<string>",
"domain": "<string>",
"asin": {},
"stream_terminated": true,
"elapsed_ms": 123
}Ask
Ask Amazon Rufus
Ask Alexa for Shopping (Rufus) and get the complete answer and recommended product cards as structured JSON, with optional ASIN product context.
POST
/
v1
/
rufus
/
ask
Ask Amazon Rufus
curl --request POST \
--url https://scrapebadger.com/v1/rufus/ask \
--header 'X-API-Key: <x-api-key>'import requests
url = "https://scrapebadger.com/v1/rufus/ask"
headers = {"X-API-Key": "<x-api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'X-API-Key': '<x-api-key>'}};
fetch('https://scrapebadger.com/v1/rufus/ask', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/rufus/ask",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"X-API-Key: <x-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://scrapebadger.com/v1/rufus/ask"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("X-API-Key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://scrapebadger.com/v1/rufus/ask")
.header("X-API-Key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/rufus/ask")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"answer": "<string>",
"products": [
{}
],
"thread_id": {},
"model": "<string>",
"domain": "<string>",
"asin": {},
"stream_terminated": true,
"elapsed_ms": 123
}Ask a shopping question and receive the real Rufus answer after its streamed response finishes.
GET accepts query parameters; POST accepts the same fields in a JSON body.
Credits: 50 per successful answer
Allow up to 100 seconds. Empty answers,
softlanding_error, truncated streams, authentication failures, and upstream errors return non-2xx responses and are not billed.Authorization
Parameters
The shopping question to ask. Maximum 4,000 characters. Include all context needed because every request starts an independent conversation.
Optional 10-character product ASIN, matching
^[A-Z0-9]{10}$. Rufus opens that product page before answering, making the question product-aware.Response
Amazon’s server-side conversation identifier, returned for tracing. Not a multi-turn input.
Show RufusProduct
Show RufusProduct
Example
curl "https://scrapebadger.com/v1/rufus/ask?asin=B09M7WWTFP&prompt=What%20are%20the%20main%20tradeoffs%20of%20this%20product%3F" \
-H "X-API-Key: YOUR_API_KEY" \
--max-time 100
const res = await fetch("https://scrapebadger.com/v1/rufus/ask", {
method: "POST",
headers: {
"X-API-Key": process.env.SCRAPEBADGER_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
prompt: "What are the main tradeoffs of this product?",
asin: "B09M7WWTFP",
}),
signal: AbortSignal.timeout(100_000),
});
const data = await res.json();
console.log(data.answer);
console.log(data.products);
import requests
res = requests.post(
"https://scrapebadger.com/v1/rufus/ask",
headers={"X-API-Key": "YOUR_API_KEY"},
json={
"prompt": "What are the main tradeoffs of this product?",
"asin": "B09M7WWTFP",
},
timeout=100,
)
data = res.json()
print(data["answer"])
print(data["products"])
Response
{
"answer": "The main tradeoffs are reliability and subscription cost...",
"products": [
{
"asin": "B09M7WWTFP",
"title": "Example product",
"url": "https://www.amazon.com/dp/B09M7WWTFP",
"price": "$39.99",
"rating": 4.7,
"rating_count": 8769,
"badge": "Best Seller",
"image_url": "https://example.com/product.jpg",
"rank": 1
}
],
"thread_id": "thread-abc123",
"model": "rufus",
"domain": "com",
"asin": "B09M7WWTFP",
"stream_terminated": true,
"elapsed_ms": 14362
}
Errors
Errors use{"detail":{"code":"...","message":"..."}}.
| Code | HTTP | Meaning |
|---|---|---|
pool_disabled, pool_exhausted | 503 | No authenticated account is currently available. Retry later. |
authentication_required | 503 | Amazon requested fresh authentication and the affected session was rotated. |
blocked | 422 | Amazon served an anti-bot page. Not billed. |
answer_timeout, stream_truncated, softlanding_error | 502 | The response did not complete successfully. Not billed. |
empty_answer | 502 | The stream ended without usable answer text. Not billed. |
composer_not_found, new_chat_unavailable, upstream_error | 502 | The upstream page or answer failed. Not billed. |

