Skip to main content
POST
Ask Amazon Rufus
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

string
required
Your ScrapeBadger API key.

Parameters

string
required
The shopping question to ask. Maximum 4,000 characters. Include all context needed because every request starts an independent conversation.
string
Optional 10-character product ASIN, matching ^[A-Z0-9]{10}$. Rufus opens that product page before answering, making the question product-aware.

Response

string
The complete answer text after all JSON Patch events have been applied.
RufusProduct[]
Ordered product recommendations. Empty when the answer contains no product cards.
string | null
Amazon’s server-side conversation identifier, returned for tracing. Not a multi-turn input.
string
Always rufus.
string
Always com.
string | null
The product context you supplied, or null for a general shopping question.
boolean
Whether Amazon closed the response stream cleanly.
integer
End-to-end request time in milliseconds.

Example

Response

Errors

Errors use {"detail":{"code":"...","message":"..."}}.