Skip to content

Docs / All tools / Base tools

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

FieldTypeDescription
queryRequiredstringNatural-language Amazon shopping request
historyarray of object
checkoutbooleanIf true, 'buy option N' drives an assisted checkout to a ready-to-confirm order; if false, returns the v1 product-page link.
headlessbooleanRun 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.

FieldType
phasestring
answerstring
productsarray of object
checkout_urlstring
order_numberstring
questionobject

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())