Amazon Product Search via Scavio
Search Amazon products or retrieve full product details by ASIN. Returns structured JSON. Supports 12 Amazon marketplaces.
When to trigger
Use this skill when the user asks to:
- Find products on Amazon with price or rating requirements
- Look up a specific product by ASIN
- Research Amazon pricing, availability, or reviews
- Compare Amazon products or find best sellers in a category
Setup
Get a free API key at https://scavio.dev (1,000 free credits/month, no card required):
export SCAVIO_API_KEY=sk_live_your_key
Workflow
- If the user has an ASIN, call
/api/v1/amazon/product directly.
- If the user has a keyword, call
/api/v1/amazon/search with appropriate filters (sort_by, domain, zip_code).
- If the user asks about a specific market (e.g. "Amazon Germany"), set the
domain param accordingly.
- Present results with name, price, rating, review count, and URL. Note Prime status.
Endpoints
| Endpoint | Description |
|---|
POST https://api.scavio.dev/api/v1/amazon/search | Keyword search with filters |
POST https://api.scavio.dev/api/v1/amazon/product | Full product details by ASIN |
Authorization: Bearer $SCAVIO_API_KEY
Search Parameters
| Parameter | Type | Default | Description |
|---|
query | string | required | Search query (1-500 chars) |
domain | string | com | com, co.uk, de, fr, co.jp, ca, it, es, in, com.au, com.br, com.mx |
sort_by | string | -- | most_recent, price_low_to_high, price_high_to_low, featured, average_review, bestsellers |
start_page | integer | 1 | Starting page |
pages | integer | 1 | Number of pages |
category_id | string | -- | Amazon category/department ID |
currency | string | -- | ISO 4217 (e.g. USD, EUR) |
zip_code | string | -- | ZIP code for localized pricing and availability |
device | string | desktop | desktop, mobile, or tablet |
Product Detail Parameters
| Parameter | Type | Default | Description |
|---|
query | string | required | Amazon ASIN (e.g. B09XS7JWHH) |
domain | string | com | Amazon domain suffix |
currency | string | -- | ISO 4217 currency code |
zip_code | string | -- | ZIP code for localized pricing |
Examples
import os, requests
BASE = "https://api.scavio.dev"
HEADERS = {"Authorization": f"Bearer {os.environ['SCAVIO_API_KEY']}"}
# Search
results = requests.post(f"{BASE}/api/v1/amazon/search", headers=HEADERS,
json={"query": "wireless headphones", "sort_by": "average_review"}).json()
# Product by ASIN
product = requests.post(f"{BASE}/api/v1/amazon/product", headers=HEADERS,
json={"query": "B09XS7JWHH"}).json()
Search Response
{
"data": [
{
"name": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
"asin": "B09XS7JWHH",
"url": "https://www.amazon.com/dp/B09XS7JWHH",
"price": "$278.00",
"currency": "USD",
"rating": 4.6,
"total_reviews": 12450,
"is_prime": true,
"is_best_seller": false
}
],
"credits_used": 1,
"credits_remaining": 999
}
Product detail response also includes: description, features, images, categories, availability, seller, list_price.
Guardrails
- Never fabricate product names, ASINs, prices, or ratings. Only return data from the API.
- If the user asks for a price comparison, search both terms and present both results.
- If an ASIN is not found, tell the user and suggest a keyword search instead.
- Always include the product URL so the user can verify.
Failure handling
- If the API returns an error, report the status code and stop.
- If no products are returned, tell the user and suggest different keywords or filters.
- If
SCAVIO_API_KEY is not set, prompt the user to export it before continuing.
LangChain
pip install scavio-langchain
from scavio_langchain import ScavioSearchTool
tool = ScavioSearchTool(engine="amazon")
