amazon. shop
Find, compare, and recommend products on Amazon. Place an order on the connected account after confirmation.
40 credits. Per order placed. Free when it only returns a product link, or when cancelled.
Example prompt
Send this to your AI app when Heelo is connected:
Find me a wireless mouse under $30 with good reviews
Input fields
| Field | Type | Description |
|---|---|---|
queryRequired | string | Natural-language Amazon shopping request |
history | array of object | |
checkout | boolean | If true, 'buy option N' drives an assisted checkout to a ready-to-confirm order; if false, returns the v1 product-page link. |
headless | boolean | Run the checkout browser headless (server). Pass false for the dev-headed flow where the user can clear sign-in/verification by hand. |
Output fields
The fields in data when status is success.
| Field | Type |
|---|---|
phase | string |
answer | string |
products | array of object |
checkout_url | string |
order_number | string |
question | object |
Code
The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.
import os
import requests
response = requests.post(
"https://toolsprimitives.uk/v1/tools/amazon.shop/invoke",
headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
json={"input": {
"query": "Find me a wireless mouse under $30 with good reviews",
}},
timeout=120,
)
response.raise_for_status()
print(response.json())// Node.js 18 or newer, in an ES module.
const response = await fetch("https://toolsprimitives.uk/v1/tools/amazon.shop/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {
"query": "Find me a wireless mouse under $30 with good reviews"
},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());