← Back to Skills Marketplace
Amazon Best Sellers API
by
justoneapi
· GitHub ↗
· v1.0.2
· MIT-0
103
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install justoneapi-amazon-get-best-sellers
Description
Call GET /api/amazon/get-best-sellers/v1 for Amazon Best Sellers through JustOneAPI with category.
README (SKILL.md)
Amazon Best Sellers
Use this focused JustOneAPI skill for best Sellers in Amazon. It targets GET /api/amazon/get-best-sellers/v1. Required non-token inputs are category. OpenAPI describes it as: Get Amazon best Sellers data, including rank positions, product metadata, and pricing, for identifying trending products in specific categories, market share analysis and category research, and tracking sales rank and popularity over time.
Endpoint Scope
- Platform key:
amazon - Endpoint key:
get-best-sellers - Platform family: Amazon
- Skill slug:
justoneapi-amazon-get-best-sellers
| Operation | Version | Method | Path | OpenAPI summary |
|---|---|---|---|---|
getBestSellersV1 |
v1 |
GET |
/api/amazon/get-best-sellers/v1 |
Best Sellers |
Inputs
| Parameter | In | Required by | Optional by | Type | Notes |
|---|---|---|---|---|---|
category |
query |
all | n/a | string |
Best sellers category to return products for (e.g. 'baby-products' or 'baby-products/166777011'). The value is derived from the URL path of the Amazon Best Sellers page, such as: https://www.amazon.com/Best-Sellers-Baby-Baby-Toddler-Feeding-Supplies/zgbs/baby-products/166777011 |
country |
query |
n/a | all | string |
Country code for the Amazon product. Available Values: - US: United States - AU: Australia - BR: Brazil - CA: Canada - CN: China - FR: France - DE: Germany - IN: India - IT: Italy - MX: Mexico - NL: Netherlands - SG: Singapore - ES: Spain - TR: Turkey - AE: United Arab Emirates - GB: United Kingdom - JP: Japan - SA: Saudi Arabia - PL: Poland - SE: Sweden - BE: Belgium - EG: Egypt - ZA: South Africa - IE: Ireland |
country enum |
values | n/a | n/a | n/a | AE, AU, BE, BR, CA, CN, DE, EG, ES, FR, GB, IE, IN, IT, JP, MX, NL, PL, SA, SE, SG, TR, US, ZA |
page |
query |
n/a | all | integer |
Page number for pagination |
Request body: none documented; send parameters through path or query arguments.
Version Choice
Use getBestSellersV1 for the documented v1 endpoint. There are no alternate versions grouped in this skill.
Run This Endpoint
Supported operation IDs in this skill: getBestSellersV1.
node {baseDir}/bin/run.mjs --operation "getBestSellersV1" --token "$JUST_ONE_API_TOKEN" --params-json '{"category":"\x3Ccategory>"}'
Ask for any missing required parameter before calling the helper. Keep user-provided IDs, cursors, keywords, and filters unchanged.
Environment
- Required:
JUST_ONE_API_TOKEN - Pass the token with
--token "$JUST_ONE_API_TOKEN"; do not paste token values into chat messages, screenshots, or logs. - Get a token from Just One API Dashboard.
- Authentication details: Just One API Usage Guide.
Output Focus
- State the operation ID and endpoint path used, for example
getBestSellersV1on/api/amazon/get-best-sellers/v1. - Echo the required lookup scope (
category) before summarizing results. - Prioritize fields that support this endpoint purpose: Get Amazon best Sellers data, including rank positions, product metadata, and pricing, for identifying trending products in specific categories, market share analysis and category research, and tracking sales rank and popularity over time.
- Return raw JSON only after the short, endpoint-specific summary.
- If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
This skill is coherent with its purpose. Before installing: ensure you trust JustOneAPI and the listed homepage; keep JUST_ONE_API_TOKEN secret (do not paste it into chats or logs); be aware the token is passed in the URL/query string and may appear in server logs; restrict the token's permissions if possible and rotate it if exposed; review the provider's pricing/rate limits and privacy policy so you understand what data is sent to the third party.
Capability Analysis
Type: OpenClaw Skill
Name: justoneapi-amazon-get-best-sellers
Version: 1.0.2
The skill is a standard API wrapper for the JustOneAPI Amazon Best Sellers service. The execution logic in `bin/run.mjs` is straightforward, using standard Node.js fetch to interact with the official domain (api.justoneapi.com), and the instructions in `SKILL.md` correctly advise the agent on secure token handling.
Capability Assessment
Purpose & Capability
Name/description, required env var (JUST_ONE_API_TOKEN), required binary (node), and the bundled run.mjs script all match the declared purpose of calling JustOneAPI's GET /api/amazon/get-best-sellers/v1 endpoint.
Instruction Scope
SKILL.md and bin/run.mjs only ask for the API token and query parameters (category, optional country/page) and perform a single HTTP GET to the documented base URL. The instructions do not request unrelated files, credentials, or system data.
Install Mechanism
There is no install spec; the skill includes a small node script (bin/run.mjs). Requiring node is proportionate and no external downloads or archives are used.
Credentials
Only JUST_ONE_API_TOKEN is required and is the primary credential for the stated API. No other secrets or config paths are requested. Note: the token is sent as a query parameter (per the API), which can be visible in logs/URLs — the SKILL.md warns against pasting the token into chats or logs.
Persistence & Privilege
The skill does not request always: true and does not modify other skills or system-wide settings. It runs only when invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install justoneapi-amazon-get-best-sellers - After installation, invoke the skill by name or use
/justoneapi-amazon-get-best-sellers - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Simplified and focused documentation to highlight the primary endpoint, required parameters, and use cases.
- Clarified that `category` is the only required parameter; improved parameter table and country code documentation.
- Added explicit endpoint and operation details (operation ID, path, summary table).
- Updated output instructions to prioritize the summary, required scope, and endpoint focus.
- Streamlined setup and usage instructions for environment configuration.
v1.0.1
- Updated internal operation definitions and documentation files.
- No changes to the user interface or input/output behavior.
- Maintenance release; keeps references and generated files in sync.
v1.0.0
Initial publish
Metadata
Frequently Asked Questions
What is Amazon Best Sellers API?
Call GET /api/amazon/get-best-sellers/v1 for Amazon Best Sellers through JustOneAPI with category. It is an AI Agent Skill for Claude Code / OpenClaw, with 103 downloads so far.
How do I install Amazon Best Sellers API?
Run "/install justoneapi-amazon-get-best-sellers" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Amazon Best Sellers API free?
Yes, Amazon Best Sellers API is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Amazon Best Sellers API support?
Amazon Best Sellers API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Amazon Best Sellers API?
It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.2.
More Skills