> ## 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 # Keepa Product Finder > Keepa Product Finder. Token usage is settled from the response using the account's immutable rate. ## Request contract * **Method and path:** POST /apis/v1/keepa/query * **Availability:** enabled * **Request URL template:** `https://api.aisa.one/apis/v1/keepa/query` * **domain:** query; required * **Runtime facts:** 0bc51a4801a2062613b38952cd78afdcee61c1d5eb0d536a8aa7e307f9bd9a12 [Complete OpenAPI definition](https://aisa.one/docs/openapi/keepa.json) Effective request declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "post_keepa_apis_v1_keepa_query", "method": "POST", "path": "/apis/v1/keepa/query", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [ { "in": "query", "name": "domain", "required": true, "schema": { "enum": [ "1", "10", "11", "12", "2", "3", "4", "5", "6", "8", "9" ], "type": "string" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "allOf": [ { "anyOf": [ { "properties": { "brand": {} }, "required": [ "brand" ] }, { "properties": { "categories_exclude": {} }, "required": [ "categories_exclude" ] }, { "properties": { "categories_include": {} }, "required": [ "categories_include" ] }, { "properties": { "color": {} }, "required": [ "color" ] }, { "properties": { "current_AMAZON_gte": {} }, "required": [ "current_AMAZON_gte" ] }, { "properties": { "current_AMAZON_lte": {} }, "required": [ "current_AMAZON_lte" ] }, { "properties": { "current_COUNT_REVIEWS_gte": {} }, "required": [ "current_COUNT_REVIEWS_gte" ] }, { "properties": { "current_COUNT_REVIEWS_lte": {} }, "required": [ "current_COUNT_REVIEWS_lte" ] }, { "properties": { "current_NEW_gte": {} }, "required": [ "current_NEW_gte" ] }, { "properties": { "current_NEW_lte": {} }, "required": [ "current_NEW_lte" ] }, { "properties": { "current_RATING_gte": {} }, "required": [ "current_RATING_gte" ] }, { "properties": { "current_RATING_lte": {} }, "required": [ "current_RATING_lte" ] }, { "properties": { "current_SALES_gte": {} }, "required": [ "current_SALES_gte" ] }, { "properties": { "current_SALES_lte": {} }, "required": [ "current_SALES_lte" ] }, { "properties": { "hasParentASIN": {} }, "required": [ "hasParentASIN" ] }, { "properties": { "hasReviews": {} }, "required": [ "hasReviews" ] }, { "properties": { "manufacturer": {} }, "required": [ "manufacturer" ] }, { "properties": { "model": {} }, "required": [ "model" ] }, { "properties": { "productType": {} }, "required": [ "productType" ] }, { "properties": { "rootCategory": {} }, "required": [ "rootCategory" ] }, { "properties": { "singleVariation": {} }, "required": [ "singleVariation" ] }, { "properties": { "size": {} }, "required": [ "size" ] }, { "properties": { "title": {} }, "required": [ "title" ] } ] } ], "properties": { "brand": { "items": { "maxLength": 500, "minLength": 1, "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "categories_exclude": { "items": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "maxItems": 50, "minItems": 1, "type": "array" }, "categories_include": { "items": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "maxItems": 50, "minItems": 1, "type": "array" }, "color": { "items": { "maxLength": 500, "minLength": 1, "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "current_AMAZON_gte": { "maximum": 2147483647, "minimum": 0, "type": "integer" }, "current_AMAZON_lte": { "maximum": 2147483647, "minimum": 0, "type": "integer" }, "current_COUNT_REVIEWS_gte": { "maximum": 2147483647, "minimum": 0, "type": "integer" }, "current_COUNT_REVIEWS_lte": { "maximum": 2147483647, "minimum": 0, "type": "integer" }, "current_NEW_gte": { "maximum": 2147483647, "minimum": 0, "type": "integer" }, "current_NEW_lte": { "maximum": 2147483647, "minimum": 0, "type": "integer" }, "current_RATING_gte": { "maximum": 2147483647, "minimum": 0, "type": "integer" }, "current_RATING_lte": { "maximum": 2147483647, "minimum": 0, "type": "integer" }, "current_SALES_gte": { "maximum": 2147483647, "minimum": 0, "type": "integer" }, "current_SALES_lte": { "maximum": 2147483647, "minimum": 0, "type": "integer" }, "hasParentASIN": { "type": "boolean" }, "hasReviews": { "type": "boolean" }, "manufacturer": { "items": { "maxLength": 500, "minLength": 1, "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "model": { "items": { "maxLength": 500, "minLength": 1, "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "page": { "default": 0, "maximum": 199, "minimum": 0, "type": "integer" }, "perPage": { "default": 50, "maximum": 10000, "minimum": 50, "type": "integer" }, "productType": { "maximum": 5, "minimum": 0, "type": "integer" }, "rootCategory": { "items": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "maxItems": 50, "minItems": 1, "type": "array" }, "singleVariation": { "type": "boolean" }, "size": { "items": { "maxLength": 500, "minLength": 1, "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "sort": { "items": { "items": { "maxLength": 100, "minLength": 1, "type": "string" }, "maxItems": 2, "minItems": 2, "type": "array" }, "maxItems": 3, "minItems": 1, "type": "array" }, "title": { "maxLength": 500, "type": "string" } }, "type": "object" } } }, "required": true }, "x-aisa-status": "enabled", "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Usage-based pricing. A price estimate is not currently available. Your account price may differ; use a request quote where supported. ## OpenAPI ````yaml openapi/keepa.json POST /apis/v1/keepa/query openapi: 3.1.0 info: description: '' title: Keepa 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-catalogs: keepa: description: '' title: Keepa x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-document: facts_hash: 0bc51a4801a2062613b38952cd78afdcee61c1d5eb0d536a8aa7e307f9bd9a12 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-configured-paths: - /apis/v1/keepa/bestsellers - /apis/v1/keepa/category - /apis/v1/keepa/deal - /apis/v1/keepa/lightningdeal - /apis/v1/keepa/lightningdeal/list - /apis/v1/keepa/product - /apis/v1/keepa/query - /apis/v1/keepa/search/category - /apis/v1/keepa/search/product - /apis/v1/keepa/seller - /apis/v1/keepa/seller/storefront - /apis/v1/keepa/sellerquery - /apis/v1/keepa/topseller x-aisa-document: composer_version: '29' document_hash: sha256:013f49b467e9f538cbbb294ac8c2cd1de915a7b24c777d217fb8e14a4e02f779 facts_hash: 0bc51a4801a2062613b38952cd78afdcee61c1d5eb0d536a8aa7e307f9bd9a12 generator_version: '3' protocol_version: '1' response_pending: [] schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: keepa servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/keepa/query: post: tags: - ecommerce summary: Keepa Product Finder description: >- Keepa Product Finder. Token usage is settled from the response using the account's immutable rate. A request reference price is not currently available; use a request quote where supported. Declared unit rate: $0 USD per keepa_token. Account-specific pricing and final settlement may differ. operationId: post_keepa_apis_v1_keepa_query parameters: - in: query name: domain required: true schema: enum: - '1' - '10' - '11' - '12' - '2' - '3' - '4' - '5' - '6' - '8' - '9' type: string requestBody: content: application/json: schema: additionalProperties: false allOf: - anyOf: - properties: brand: {} required: - brand - properties: categories_exclude: {} required: - categories_exclude - properties: categories_include: {} required: - categories_include - properties: color: {} required: - color - properties: current_AMAZON_gte: {} required: - current_AMAZON_gte - properties: current_AMAZON_lte: {} required: - current_AMAZON_lte - properties: current_COUNT_REVIEWS_gte: {} required: - current_COUNT_REVIEWS_gte - properties: current_COUNT_REVIEWS_lte: {} required: - current_COUNT_REVIEWS_lte - properties: current_NEW_gte: {} required: - current_NEW_gte - properties: current_NEW_lte: {} required: - current_NEW_lte - properties: current_RATING_gte: {} required: - current_RATING_gte - properties: current_RATING_lte: {} required: - current_RATING_lte - properties: current_SALES_gte: {} required: - current_SALES_gte - properties: current_SALES_lte: {} required: - current_SALES_lte - properties: hasParentASIN: {} required: - hasParentASIN - properties: hasReviews: {} required: - hasReviews - properties: manufacturer: {} required: - manufacturer - properties: model: {} required: - model - properties: productType: {} required: - productType - properties: rootCategory: {} required: - rootCategory - properties: singleVariation: {} required: - singleVariation - properties: size: {} required: - size - properties: title: {} required: - title properties: brand: items: maxLength: 500 minLength: 1 type: string maxItems: 50 minItems: 1 type: array categories_exclude: items: maximum: 9007199254740991 minimum: 0 type: integer maxItems: 50 minItems: 1 type: array categories_include: items: maximum: 9007199254740991 minimum: 0 type: integer maxItems: 50 minItems: 1 type: array color: items: maxLength: 500 minLength: 1 type: string maxItems: 50 minItems: 1 type: array current_AMAZON_gte: maximum: 2147483647 minimum: 0 type: integer current_AMAZON_lte: maximum: 2147483647 minimum: 0 type: integer current_COUNT_REVIEWS_gte: maximum: 2147483647 minimum: 0 type: integer current_COUNT_REVIEWS_lte: maximum: 2147483647 minimum: 0 type: integer current_NEW_gte: maximum: 2147483647 minimum: 0 type: integer current_NEW_lte: maximum: 2147483647 minimum: 0 type: integer current_RATING_gte: maximum: 2147483647 minimum: 0 type: integer current_RATING_lte: maximum: 2147483647 minimum: 0 type: integer current_SALES_gte: maximum: 2147483647 minimum: 0 type: integer current_SALES_lte: maximum: 2147483647 minimum: 0 type: integer hasParentASIN: type: boolean hasReviews: type: boolean manufacturer: items: maxLength: 500 minLength: 1 type: string maxItems: 50 minItems: 1 type: array model: items: maxLength: 500 minLength: 1 type: string maxItems: 50 minItems: 1 type: array page: default: 0 maximum: 199 minimum: 0 type: integer perPage: default: 50 maximum: 10000 minimum: 50 type: integer productType: maximum: 5 minimum: 0 type: integer rootCategory: items: maximum: 9007199254740991 minimum: 0 type: integer maxItems: 50 minItems: 1 type: array singleVariation: type: boolean size: items: maxLength: 500 minLength: 1 type: string maxItems: 50 minItems: 1 type: array sort: items: items: maxLength: 100 minLength: 1 type: string maxItems: 2 minItems: 2 type: array maxItems: 3 minItems: 1 type: array title: maxLength: 500 type: string type: object required: true responses: '200': content: application/json: schema: additionalProperties: true properties: asinList: items: type: string type: array error: additionalProperties: true type: - object - 'null' refillIn: type: integer refillRate: type: integer tokenFlowReduction: type: number tokensConsumed: minimum: 0 type: integer tokensLeft: type: integer totalResults: minimum: 0 type: integer required: - tokensConsumed type: object description: >- Native Keepa Product Finder response. Result availability and errors follow the provider envelope. default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.