{ "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } }, "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": "27", "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:4ee0751858295b87879c5f2bb2c38097188fb96c202892c617f785cd72a5e74b" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "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.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } } } } }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ], "paths": { "/apis/v1/amazon/get-category-products-v1": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.01476 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "amazon.get-category-products-v1", "parameters": [ { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "categoryId", "required": true, "schema": { "maxLength": 1024, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "AE" }, "minimal": { "value": "AE" } }, "in": "query", "name": "country", "required": true, "schema": { "enum": [ "AE", "AU", "BE", "BR", "CA", "CN", "DE", "EG", "ES", "FR", "GB", "IE", "IN", "IT", "JP", "MX", "NL", "PL", "SA", "SE", "SG", "TR", "US", "ZA" ], "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": 1 }, "minimal": { "value": 1 } }, "in": "query", "name": "page", "required": true, "schema": { "enum": [ 1 ], "maximum": 1, "minimum": 1, "type": "integer" } }, { "examples": { "default": { "value": "BEST_SELLERS" }, "minimal": { "value": "BEST_SELLERS" } }, "in": "query", "name": "sortBy", "required": true, "schema": { "enum": [ "BEST_SELLERS", "HIGHEST_PRICE", "LOWEST_PRICE", "NEWEST", "RELEVANCE", "REVIEWS" ], "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Amazon products by category id and country", "tags": [ "Amazon" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "commerce", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01476, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "ee07509144cafbd5e3d183b49ccff2d261749fdb61ea649e385bf9803e6d4e3d", "x-aisa-response-upstream-path-sha256": "88485d7f882afd43e240550d02d7f59fb08d526948cb442698dd03894b4852d0", "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c629c8f4dce0" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "amazon", "x-aisa-runtime-operation": { "operation_id": "amazon.get-category-products-v1", "method": "GET", "path": "/apis/v1/amazon/get-category-products-v1" }, "x-aisa-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" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/amazon/get-category-products-v1?categoryId=example&country=AE&page=1&sortBy=BEST_SELLERS' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/amazon/amazon-get-category-products-v1" } }, "/apis/v1/amazon/search-products-v1": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.01476 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "amazon.search-products-v1", "parameters": [ { "examples": { "default": { "value": "AE" }, "minimal": { "value": "AE" } }, "in": "query", "name": "country", "required": true, "schema": { "enum": [ "AE", "AU", "BE", "BR", "CA", "CN", "DE", "EG", "ES", "FR", "GB", "IE", "IN", "IT", "JP", "MX", "NL", "PL", "SA", "SE", "SG", "TR", "US", "ZA" ], "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "ALL_DISCOUNTS" }, "minimal": { "value": "ALL_DISCOUNTS" } }, "in": "query", "name": "dealsAndDiscounts", "required": true, "schema": { "enum": [ "ALL_DISCOUNTS", "NONE", "TODAYS_DEALS" ], "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": false }, "minimal": { "value": false } }, "in": "query", "name": "isPrime", "required": true, "schema": { "enum": [ false, true ], "type": "boolean" } }, { "examples": { "default": { "value": "nike" }, "minimal": { "value": "nike" } }, "in": "query", "name": "keyword", "required": true, "schema": { "maxLength": 1024, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": 1 }, "minimal": { "value": 1 } }, "in": "query", "name": "page", "required": true, "schema": { "enum": [ 1 ], "maximum": 1, "minimum": 1, "type": "integer" } }, { "examples": { "default": { "value": "ALL" }, "minimal": { "value": "ALL" } }, "in": "query", "name": "productCondition", "required": true, "schema": { "enum": [ "ALL", "COLLECTIBLE", "NEW", "RENEWED", "USED" ], "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "BEST_SELLERS" }, "minimal": { "value": "BEST_SELLERS" } }, "in": "query", "name": "sortBy", "required": true, "schema": { "enum": [ "BEST_SELLERS", "HIGHEST_PRICE", "LOWEST_PRICE", "NEWEST", "RELEVANCE", "REVIEWS" ], "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search Amazon products by keyword or ASIN", "tags": [ "Amazon" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "commerce", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01476, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "ee07509144cafbd5e3d183b49ccff2d261749fdb61ea649e385bf9803e6d4e3d", "x-aisa-response-upstream-path-sha256": "c60715a6a173d02edf4c3d126fe91ceaffc37176aae3cfe030a39b394ce98312", "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "44e076de9aca" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "amazon", "x-aisa-runtime-operation": { "operation_id": "amazon.search-products-v1", "method": "GET", "path": "/apis/v1/amazon/search-products-v1" }, "x-aisa-response-pending": { "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" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/amazon/search-products-v1?country=AE&dealsAndDiscounts=ALL_DISCOUNTS&isPrime=false&keyword=nike&page=1&productCondition=ALL&sortBy=BEST_SELLERS' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/amazon/amazon-search-products-v1" } }, "/apis/v1/amazon/shop": { "get": { "description": "\nUsage-based billing; Default request estimate: $0.014 USD (not a fixed price). Declared unit rate: $0.014 USD per provider_credit. Account-specific pricing and final settlement may differ.\n", "operationId": "amazon.shop", "parameters": [ { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 16384, "minLength": 1, "type": "string" } }, { "examples": { "default": { "value": "example" }, "minimal": { "value": "example" } }, "in": "query", "name": "url", "required": true, "schema": { "maxLength": 4096, "minLength": 1, "type": "string" } } ], "responses": { "200": { "description": "Successful response" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get Amazon Shop page", "tags": [ "Amazon" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "mpp": false, "mpp_methods": [], "x402": false }, "x-aisa-category": "social", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.014, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 1, "unit": "provider_credit", "unit_rate_usd": 0.014 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "f0e4ae514d1a43a38999ea43c73bb405c7b0d1bcf929f5c9c22d2f8c7ad85b6b", "x-aisa-response-upstream-path-sha256": "4e0842c181f10454254a2cbfb71ff73b663daea91f935d66ea23ea11a1b1f9cb", "x-aisa-revision": { "customer_pricing_ref": "b35ec6a8f68b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "79f04998d308" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "x-aisa-catalog-id": "amazon", "x-aisa-runtime-operation": { "operation_id": "amazon.shop", "method": "GET", "path": "/apis/v1/amazon/shop" }, "x-aisa-response-pending": { "operation_id": "amazon.shop", "path": "/apis/v1/amazon/shop", "method": "GET", "statuses": [ "200" ], "reason": "public success response has no authoritative payload declaration" }, "x-codeSamples": [ { "lang": "text", "label": "Reference example", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request GET \\\n --url 'https://api.aisa.one/apis/v1/amazon/shop?url=example' \\\n --header 'Authorization: Bearer '" } ], "x-aisa-docs-url": "https://aisa.one/docs/api-reference/amazon/amazon-shop" } } } }