Scavio Amazon

Search Amazon products and look up product details by ASIN. Returns structured JSON with price, rating, Prime status, and availability. Supports 12 Amazon marketplaces.

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 (250 free credits/month, no card required):

export SCAVIO_API_KEY=sk_live_your_key

Workflow

1. If the user has an ASIN, call /api/v1/amazon/product directly.
2. If the user has a keyword, call /api/v1/amazon/search with appropriate filters (sort_by, domain, zip_code).
3. If the user asks about a specific market (e.g. "Amazon Germany"), set the domain param accordingly.
4. 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 langchain-scavio

from langchain_scavio import ScavioSearchTool
tool = ScavioSearchTool(engine="amazon")