Skip to content

Repository files navigation

Amazon Data API

Product, keyword, traffic, review, sales, pricing, market, and competitor intelligence through one API key.

Validate examples API docs License: MIT

Get an API key · Browse every API · Read the full documentation


Nexscope provides developer access to Amazon marketplace data for product discovery, ASIN research, keyword and traffic analysis, reviews, sales estimates, price history, market research, and competitor analysis. This repository contains copy-ready requests and dependency-free clients for every currently published Amazon API in the Nexscope catalog.

Quick start

1. Create an API key

Sign in to Nexscope API Access, create a key, and keep it private.

export NEXSCOPE_API_KEY="YOUR_API_KEY"

2. Run an Amazon search

curl -X POST \
  https://api.nexscope.ai/api/skill-api/v1/skills/amazon-search/run \
  -H "Authorization: Bearer ${NEXSCOPE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"phone case","page":1}'

The response schema, supported marketplaces, request fields, and known limitations are documented on the Amazon Search API page.

3. Try another language

Every current Amazon API has a sample payload in examples/requests.json.

# Python 3, standard library only
python3 examples/python/run.py amazon-product-detail \
  examples/payloads/amazon-product-detail.json

# Node.js 18+
node examples/javascript/run.mjs amazon-reviews-list \
  examples/payloads/amazon-reviews-list.json

# cURL
bash examples/curl/run.sh amazon-keyword-overview \
  examples/payloads/amazon-keyword-overview.json

API calls may consume account credits. The example clients make one request per command and do not retry automatically.

API coverage

The Nexscope public catalog currently includes the following Amazon APIs. Use the linked documentation as the source of truth for request fields, response schemas, marketplace coverage, costs, and limitations.

All public skill endpoints follow this pattern:

POST https://api.nexscope.ai/api/skill-api/v1/skills/{api-slug}/run

Authenticate with Authorization: Bearer YOUR_API_KEY and Content-Type: application/json.

Search and product discovery

API What it does
Amazon Alexa Search Search Amazon Alexa shopping results.
Amazon Broad Product Search Search and filter products using broad research criteria.
Amazon Market Product Search Search products in an Amazon marketplace.
Amazon Product Database Search Search the Amazon product database with product metrics.
Amazon Product Discovery Discover products using marketplace and performance filters.
Amazon Related ASINs Retrieve ASINs related to a target ASIN.
Amazon Search Retrieve storefront search results and ranking data.
Amazon Search by Image Find visually similar Amazon products from an image URL.

Product, sales, and price data

API What it does
Amazon Market Product Detail Retrieve marketplace product details.
Amazon Product Database Query a product database using research filters.
Amazon Product Detail Retrieve details for one or more ASINs.
Amazon Product History Retrieve historical product data and current details.
Amazon Product Price Series Retrieve price, BSR, and other product metric series.
Amazon Sales Estimates Estimate historical daily sales for a product.

Keyword and traffic intelligence

API What it does
Amazon ASIN Keywords Retrieve keywords associated with an ASIN.
Amazon ASIN Traffic Summary Analyze ASIN traffic-source composition.
Amazon Keyword Expansion Expand a seed keyword into related terms.
Amazon Keyword Intelligence Query Amazon search-term intelligence data.
Amazon Keyword Overview Retrieve an overview for an Amazon keyword.
Amazon Keyword Search History Retrieve historical keyword search-volume data.
Amazon Keyword Share of Voice Analyze keyword share of voice.
Amazon Keyword Summary Retrieve summary metrics for a keyword.
Amazon Traffic Keywords Research traffic-driving keywords for an ASIN.

Market, niche, and opportunity research

API What it does
Amazon Market Research Search markets using demand and competition filters.
Amazon Market Statistics Analyze statistics for an Amazon market or category.
Amazon Niche Info Retrieve details for a niche identifier.
Amazon Niche Info by ASIN Find niche information from an ASIN.
Amazon Niche Info by Keyword Find niches associated with a keyword.
Amazon Niche Reviews by Keyword Retrieve niche review data from a keyword.
Amazon Opportunity Report by Keyword Generate an opportunity report for a keyword.
Amazon Opportunity Search by Metrics Search opportunities using numeric filters.

Competitors, reviews, and policy

API What it does
Amazon Competitor Lookup Find and analyze competing Amazon products.
Amazon Policy Feed Retrieve marketplace policy updates and article details.
Amazon Reviews List Retrieve product reviews with rating and sorting controls.

Open the complete API catalog for the dedicated catalog view and API documentation links.

Repository layout

amazon-data-api/
├── api-catalog/             # Complete Amazon API directory
├── examples/
│   ├── curl/                # Generic cURL runner
│   ├── javascript/          # Dependency-free Node.js client
│   ├── python/              # Dependency-free Python client
│   ├── payloads/            # One published sample payload per API
│   └── requests.json        # Machine-readable payload index
├── recipes/                 # Multi-step integration ideas
└── scripts/                 # Repository validation

Authentication and errors

Send the key as a bearer token:

Authorization: Bearer YOUR_API_KEY

Handle these status classes explicitly:

Status Meaning
200 The request reached the API. Check API-specific business fields as documented.
401 The API key is missing, invalid, expired, disabled, or deleted.
402 The account does not have enough credits for the request.
403 The account does not have access to the requested API or resource.
429 The request was rate limited. Back off before retrying.
5xx Nexscope or an upstream dependency failed.

Do not log API keys, paste them into issues, commit them to a repository, or expose them in client-side browser code.

Data and production use

  • Treat source, freshness, coverage, estimation methods, and field-level caveats as specified only when the API's documentation states them.
  • Do not assume every field is official Amazon data, real-time, or available in every marketplace.
  • Sales estimates and other modeled metrics are estimates, not guaranteed outcomes.
  • Use request validation, timeouts, rate-limit handling, observability, and secure secret storage before production deployment.

AI agent skills

Building an agent rather than a REST integration? The companion nexscope-ecommerce-skills repository packages these capabilities for compatible AI agents.

Contributing

Bug reports and example improvements are welcome. Read CONTRIBUTING.md before opening a pull request. For security-sensitive reports, follow SECURITY.md.

Trademark notice

Amazon and related marks are trademarks of Amazon.com, Inc. or its affiliates. Nexscope is an independent service and is not endorsed by Amazon.com, Inc.

License

The example code in this repository is available under the MIT License. Access to the hosted Nexscope APIs is governed separately by Nexscope's service terms and account rules.


Built by Nexscope — ecommerce data APIs for product research, keywords, pricing, reviews, seller intelligence, and marketplace workflows.

About

Amazon marketplace data APIs for product search, ASIN research, keywords, traffic, reviews, sales estimates, price history, market research and competitor analysis.

Topics

Resources

Contributing

Security policy

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages