> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Amazon Product Search > Usage-based billing; Default request estimate: $0.0143 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** POST /apis/v1/amazon/search-products * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/amazon/search-products` * **Runtime facts:** 264e46cb48593b2d959a688a2c9ea64a62f337571623d93d81c67a6b2572c2de [Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/amazon.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "amazon.search-products", "method": "POST", "path": "/apis/v1/amazon/search-products", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "keyword" ], "properties": { "page": { "type": "integer", "default": 1, "description": "Page number for pagination." }, "country": { "enum": [ "US", "AU", "BR", "CA", "CN", "FR", "DE", "IN", "IT", "MX", "NL", "SG", "ES", "TR", "AE", "GB", "JP", "SA", "PL", "SE", "BE", "EG", "ZA", "IE" ], "type": "string", "default": "US", "description": "Country code for the Amazon marketplace.\n\nAvailable Values:\n- `US`: United States\n- `AU`: Australia\n- `BR`: Brazil\n- `CA`: Canada\n- `CN`: China\n- `FR`: France\n- `DE`: Germany\n- `IN`: India\n- `IT`: Italy\n- `MX`: Mexico\n- `NL`: Netherlands\n- `SG`: Singapore\n- `ES`: Spain\n- `TR`: Turkey\n- `AE`: United Arab Emirates\n- `GB`: United Kingdom\n- `JP`: Japan\n- `SA`: Saudi Arabia\n- `PL`: Poland\n- `SE`: Sweden\n- `BE`: Belgium\n- `EG`: Egypt\n- `ZA`: South Africa\n- `IE`: Ireland" }, "keyword": { "type": "string", "description": "Search keyword or ASIN to find Amazon products." }, "sort_by": { "enum": [ "RELEVANCE", "LOWEST_PRICE", "HIGHEST_PRICE", "REVIEWS", "NEWEST", "BEST_SELLERS" ], "type": "string", "default": "RELEVANCE", "description": "Sort order for Amazon product search results.\n\nAvailable Values:\n- `RELEVANCE`: Relevance\n- `LOWEST_PRICE`: Lowest Price\n- `HIGHEST_PRICE`: Highest Price\n- `REVIEWS`: Reviews\n- `NEWEST`: Newest\n- `BEST_SELLERS`: Best Sellers" }, "is_prime": { "type": "boolean", "default": false, "description": "Whether to return only Prime-eligible products." }, "product_condition": { "enum": [ "ALL", "NEW", "USED", "RENEWED", "COLLECTIBLE" ], "type": "string", "default": "ALL", "description": "Product condition filter for Amazon search results.\n\nAvailable Values:\n- `ALL`: All product conditions\n- `NEW`: New products\n- `USED`: Used products\n- `RENEWED`: Renewed products\n- `COLLECTIBLE`: Collectible products" }, "deals_and_discounts": { "enum": [ "NONE", "ALL_DISCOUNTS", "TODAYS_DEALS" ], "type": "string", "default": "NONE", "description": "Deals and discounts filter for Amazon search results.\n\nAvailable Values:\n- `NONE`: Do not filter by deals or discounts\n- `ALL_DISCOUNTS`: Return discounted products\n- `TODAYS_DEALS`: Return today's deals" } } } } } }, "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0143, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Usage-based billing; Default request estimate: \$0.0143 USD (not a fixed price). Declared unit rate: \$0.000001 USD per provider\_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.0143 * **Declared unit rate (USD):** 1e-06 * **Billing unit:** provider\_credit * **Cost contract:** response\_units * **Published reference multiplier:** 1.0 * **Declared maximum count/units:** 10000000 * **Settlement evidence source:** response\_body ## OpenAPI ````yaml reference-contracts/amazon.json POST /apis/v1/amazon/search-products openapi: 3.1.0 info: description: '' title: Amazon version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/amazon/get-best-sellers - /apis/v1/amazon/get-best-sellers-v1 - /apis/v1/amazon/get-category-products - /apis/v1/amazon/get-category-products-v1 - /apis/v1/amazon/get-product-detail - /apis/v1/amazon/get-product-detail-v1 - /apis/v1/amazon/get-product-top-reviews - /apis/v1/amazon/get-product-top-reviews-v1 - /apis/v1/amazon/search-products - /apis/v1/amazon/search-products-v1 - /apis/v1/amazon/shop x-aisa-document: facts_hash: 264e46cb48593b2d959a688a2c9ea64a62f337571623d93d81c67a6b2572c2de generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '28' response_pending: - operation_id: amazon.get-category-products-v1 path: /apis/v1/amazon/get-category-products-v1 method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: amazon.search-products-v1 path: /apis/v1/amazon/search-products-v1 method: GET statuses: - '200' reason: public success response has no authoritative payload declaration - operation_id: amazon.shop path: /apis/v1/amazon/shop method: GET statuses: - '200' reason: public success response has no authoritative payload declaration document_hash: sha256:0dc242b12a2fc8a4e8114f47fa6337a04558c697d512bb5c166894a91d7b22a8 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: amazon x-aisa-catalogs: amazon: title: Amazon description: '' x-aisa-document: facts_hash: 264e46cb48593b2d959a688a2c9ea64a62f337571623d93d81c67a6b2572c2de generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/amazon/search-products: post: tags: - Amazon summary: Amazon Product Search description: >- Usage-based billing; Default request estimate: $0.0143 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. operationId: amazon.search-products requestBody: required: true content: application/json: schema: type: object required: - keyword properties: page: type: integer default: 1 description: Page number for pagination. country: enum: - US - AU - BR - CA - CN - FR - DE - IN - IT - MX - NL - SG - ES - TR - AE - GB - JP - SA - PL - SE - BE - EG - ZA - IE type: string default: US description: |- Country code for the Amazon marketplace. 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 keyword: type: string description: Search keyword or ASIN to find Amazon products. sort_by: enum: - RELEVANCE - LOWEST_PRICE - HIGHEST_PRICE - REVIEWS - NEWEST - BEST_SELLERS type: string default: RELEVANCE description: |- Sort order for Amazon product search results. Available Values: - `RELEVANCE`: Relevance - `LOWEST_PRICE`: Lowest Price - `HIGHEST_PRICE`: Highest Price - `REVIEWS`: Reviews - `NEWEST`: Newest - `BEST_SELLERS`: Best Sellers is_prime: type: boolean default: false description: Whether to return only Prime-eligible products. product_condition: enum: - ALL - NEW - USED - RENEWED - COLLECTIBLE type: string default: ALL description: |- Product condition filter for Amazon search results. Available Values: - `ALL`: All product conditions - `NEW`: New products - `USED`: Used products - `RENEWED`: Renewed products - `COLLECTIBLE`: Collectible products deals_and_discounts: enum: - NONE - ALL_DISCOUNTS - TODAYS_DEALS type: string default: NONE description: |- Deals and discounts filter for Amazon search results. Available Values: - `NONE`: Do not filter by deals or discounts - `ALL_DISCOUNTS`: Return discounted products - `TODAYS_DEALS`: Return today's deals responses: '200': description: Tool result data content: application/json: schema: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_JUST_ONE_API_AMAZON_SEARCH_PRODUCTS__output__public_data default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response576A0Ea506F3_connect_JUST_ONE_API_AMAZON_SEARCH_PRODUCTS__output__public_data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_JUST_ONE_API_AMAZON_SEARCH_PRODUCTS__output__f554bab3a9f624d5 Response576A0Ea506F3_connect_JUST_ONE_API_AMAZON_SEARCH_PRODUCTS__output__f554bab3a9f624d5: type: object required: - code - data - message - recordTime properties: code: type: integer data: {} message: anyOf: - type: string - type: 'null' requestId: type: string recordTime: anyOf: - type: string - type: 'null' additionalProperties: true securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.