Scavio Amazon

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:

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

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

Failure handling

LangChain

pip install scavio-langchain

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

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

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