← Back to Skills Marketplace
Amazon Products By Category API
by
justoneapi
· GitHub ↗
· v1.0.2
· MIT-0
101
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install justoneapi-amazon-get-category-products
Description
Call GET /api/amazon/get-category-products/v1 for Amazon Products By Category through JustOneAPI with categoryId.
README (SKILL.md)
Amazon Products By Category
Use this focused JustOneAPI skill for products By Category in Amazon. It targets GET /api/amazon/get-category-products/v1. Required non-token inputs are categoryId. OpenAPI describes it as: Get Amazon products By Category data, including title, price, and rating, for category-based product discovery and returns product information such as title, price, and rating.
Endpoint Scope
- Platform key:
amazon - Endpoint key:
get-category-products - Platform family: Amazon
- Skill slug:
justoneapi-amazon-get-category-products
| Operation | Version | Method | Path | OpenAPI summary |
|---|---|---|---|---|
getProductsByCategoryV1 |
v1 |
GET |
/api/amazon/get-category-products/v1 |
Products By Category |
Inputs
| Parameter | In | Required by | Optional by | Type | Notes |
|---|---|---|---|---|---|
categoryId |
query |
all | n/a | string |
For example: https://amazon.com/s?node=172282 - the Amazon Category ID is 172282 |
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 |
sortBy |
query |
n/a | all | string |
Sort by. Available Values: - RELEVANCE: Relevance - LOWEST_PRICE: Lowest Price - HIGHEST_PRICE: Highest Price - REVIEWS: Reviews - NEWEST: Newest - BEST_SELLERS: Best Sellers |
sortBy enum |
values | n/a | n/a | n/a | BEST_SELLERS, HIGHEST_PRICE, LOWEST_PRICE, NEWEST, RELEVANCE, REVIEWS |
Request body: none documented; send parameters through path or query arguments.
Version Choice
Use getProductsByCategoryV1 for the documented v1 endpoint. There are no alternate versions grouped in this skill.
Run This Endpoint
Supported operation IDs in this skill: getProductsByCategoryV1.
node {baseDir}/bin/run.mjs --operation "getProductsByCategoryV1" --token "$JUST_ONE_API_TOKEN" --params-json '{"categoryId":"\x3CcategoryId>"}'
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
getProductsByCategoryV1on/api/amazon/get-category-products/v1. - Echo the required lookup scope (
categoryId) before summarizing results. - Prioritize fields that support this endpoint purpose: Get Amazon products By Category data, including title, price, and rating, for category-based product discovery and returns product information such as title, price, and rating.
- 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 appears to do what it says: make GET requests to JustOneAPI's Amazon category-products endpoint. Before installing: (1) only provide a JustOneAPI token with least privilege and don't paste the token into chat; (2) be aware the token is sent in the URL query string (it may be logged by intermediaries or servers) — if that's a concern, check whether the upstream API supports sending tokens in headers; (3) verify you trust api.justoneapi.com and review their docs, rate limits, and data-retention/policy; (4) test with a limited-scope token or dummy account first. Overall there are no incoherent requirements or unexpected behaviors in the skill files.
Capability Analysis
Type: OpenClaw Skill
Name: justoneapi-amazon-get-category-products
Version: 1.0.2
The skill is a legitimate API wrapper for the JustOneAPI service, specifically for retrieving Amazon product category data. The execution script `bin/run.mjs` is a straightforward Node.js wrapper that uses the built-in fetch API to communicate with a hardcoded, reputable endpoint (api.justoneapi.com). There is no evidence of data exfiltration, unauthorized file access, or malicious instructions in the documentation (SKILL.md).
Capability Assessment
Purpose & Capability
Name/description match the code and SKILL.md: the package is a thin client for GET /api/amazon/get-category-products/v1 on api.justoneapi.com. The requested binary (node) and the required env var JUST_ONE_API_TOKEN are exactly what this wrapper needs.
Instruction Scope
SKILL.md and bin/run.mjs limit actions to building the request, validating inputs, and calling the JustOneAPI endpoint. No file system reads, unrelated environment access, or external endpoints are referenced beyond api.justoneapi.com.
Install Mechanism
There is no install spec (instruction-only plus a small CLI file). No downloads from arbitrary URLs or package installs are performed by the skill itself.
Credentials
Only JUST_ONE_API_TOKEN is required (proportionate). Note: the token is sent as a query parameter named 'token' (per the OpenAPI/CLI). Sending auth in URLs can expose tokens in logs or referer headers — this is a security/privacy consideration of the upstream API rather than an incoherence in the skill, but users should be aware.
Persistence & Privilege
The skill does not request permanent/global presence (always is false) and does not modify other skills or system-wide settings. Autonomous invocation is allowed (default) but not combined with other red flags.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install justoneapi-amazon-get-category-products - After installation, invoke the skill by name or use
/justoneapi-amazon-get-category-products - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Improved and clarified documentation for the Amazon Products By Category skill, making the required inputs, endpoint details, and output rules more concise and explicit.
- Updated skill description and usage instructions to emphasize the single supported endpoint (`GET /api/amazon/get-category-products/v1`) and required `categoryId` parameter.
- Enhanced tables and enum value listings for all parameters to ensure parameter expectations are easy to reference.
- Aligned output guidelines to prioritize operation ID, used path, and core Amazon product fields (title, price, rating) in responses.
- No changes to API logic or endpoint behavior—only documentation and guidance updates.
v1.0.1
- Updated generated files to reflect latest API operation details.
- No changes to the skill interface or user instructions.
- Minor behind-the-scenes improvements for operation documentation and command usage.
v1.0.0
Initial publish
Metadata
Frequently Asked Questions
What is Amazon Products By Category API?
Call GET /api/amazon/get-category-products/v1 for Amazon Products By Category through JustOneAPI with categoryId. It is an AI Agent Skill for Claude Code / OpenClaw, with 101 downloads so far.
How do I install Amazon Products By Category API?
Run "/install justoneapi-amazon-get-category-products" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Amazon Products By Category API free?
Yes, Amazon Products By Category API is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Amazon Products By Category API support?
Amazon Products By Category API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Amazon Products By Category API?
It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.2.
More Skills