ecommercedataapi-com · Schema

AmazonKeywordsExpandRequest

Companyecommercedataapiamazonmarket-research

Properties

Name Type Description
amazonChoice boolean Amazon choice.
asinList array List of 1 to 20 ASINs per request.
excludeKeywords array Exclude keywords.
historyDate string History date. Date or timestamp value.
includeKeywords array Include keywords.
marketplace string Amazon marketplace code. Supported values are listed in the schema.
maxAdProducts integer Max ad products. Maximum value.
maxAvgPrice number Max avg price. Maximum value.
maxBid number Max bid. Maximum value.
maxCompetitors integer Max competitors. Maximum value.
maxConversionRate number Max conversion rate. Maximum value. Percentage or ratio value as documented.
maxMonopolyClickRate number Max monopoly click rate. Maximum value.
maxProducts integer Max products. Maximum value.
maxPurchaseRate number Max purchase rate. Maximum value. Percentage or ratio value as documented.
maxPurchases integer Max purchases. Maximum value.
maxSPR integer Max SPR. Maximum value.
maxSearchRank integer Max search rank. Maximum value.
maxSearches integer Max searches. Maximum value.
maxSupplyDemandRatio number Max supply demand ratio. Maximum value.
maxTitleDensity integer Max title density. Maximum value.
maxTrafficPercentage number Max traffic percentage. Maximum value. Percentage or ratio value as documented.
maxWordCount integer Max word count. Maximum value.
minAdProducts integer Min ad products. Minimum value.
minAvgPrice number Min avg price. Minimum value.
minBid number Min bid. Minimum value.
minCompetitors integer Min competitors. Minimum value.
minConversionRate number Min conversion rate. Minimum value. Percentage or ratio value as documented.
minMonopolyClickRate number Min monopoly click rate. Minimum value.
minProducts integer Min products. Minimum value.
minPurchaseRate number Min purchase rate. Minimum value. Percentage or ratio value as documented.
minPurchases integer Min purchases. Minimum value.
minSPR integer Min SPR. Minimum value.
minSearchRank integer Min search rank. Minimum value.
minSearches integer Min searches. Minimum value.
minSupplyDemandRatio number Min supply demand ratio. Minimum value.
minTitleDensity integer Min title density. Minimum value.
minTrafficPercentage number Min traffic percentage. Minimum value. Percentage or ratio value as documented.
minWordCount integer Min word count. Minimum value.
order object Sort definition.
page integer Page number starting at 1.
queryType integer Query type. See the documented default in the example column.
returnFields string Optional comma-separated response fields. Omit it to receive the standard payload.
size integer Number of results per page.
View JSON Schema on GitHub

JSON Schema

ecommercedataapi-com-amazon-keywords-expand-request-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ecommercedataapi-com/json-schema/ecommercedataapi-com-amazon-keywords-expand-request-schema.json",
  "title": "AmazonKeywordsExpandRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ecommercedataapi-com-openapi.json#/components/schemas/AmazonKeywordsExpandRequest",
  "type": "object",
  "properties": {
    "amazonChoice": {
      "type": "boolean",
      "description": "Amazon choice."
    },
    "asinList": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z0-9]{10}$",
        "description": "List of 1 to 20 ASINs per request."
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "List of 1 to 20 ASINs per request."
    },
    "excludeKeywords": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Exclude keywords."
      },
      "description": "Exclude keywords."
    },
    "historyDate": {
      "type": "string",
      "description": "History date. Date or timestamp value."
    },
    "includeKeywords": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Include keywords."
      },
      "description": "Include keywords."
    },
    "marketplace": {
      "type": "string",
      "enum": [
        "US",
        "UK",
        "DE",
        "FR",
        "IT",
        "ES",
        "MX",
        "CA",
        "AU",
        "JP",
        "IN",
        "AE",
        "BR"
      ],
      "description": "Amazon marketplace code. Supported values are listed in the schema."
    },
    "maxAdProducts": {
      "type": "integer",
      "format": "int32",
      "description": "Max ad products. Maximum value."
    },
    "maxAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Max avg price. Maximum value."
    },
    "maxBid": {
      "type": "number",
      "format": "float",
      "description": "Max bid. Maximum value."
    },
    "maxCompetitors": {
      "type": "integer",
      "format": "int32",
      "description": "Max competitors. Maximum value."
    },
    "maxConversionRate": {
      "type": "number",
      "format": "float",
      "description": "Max conversion rate. Maximum value. Percentage or ratio value as documented."
    },
    "maxMonopolyClickRate": {
      "type": "number",
      "format": "float",
      "description": "Max monopoly click rate. Maximum value."
    },
    "maxProducts": {
      "type": "integer",
      "format": "int32",
      "description": "Max products. Maximum value."
    },
    "maxPurchaseRate": {
      "type": "number",
      "format": "float",
      "description": "Max purchase rate. Maximum value. Percentage or ratio value as documented."
    },
    "maxPurchases": {
      "type": "integer",
      "format": "int32",
      "description": "Max purchases. Maximum value."
    },
    "maxSPR": {
      "type": "integer",
      "format": "int32",
      "description": "Max SPR. Maximum value."
    },
    "maxSearchRank": {
      "type": "integer",
      "format": "int32",
      "description": "Max search rank. Maximum value."
    },
    "maxSearches": {
      "type": "integer",
      "format": "int32",
      "description": "Max searches. Maximum value."
    },
    "maxSupplyDemandRatio": {
      "type": "number",
      "format": "float",
      "description": "Max supply demand ratio. Maximum value."
    },
    "maxTitleDensity": {
      "type": "integer",
      "format": "int32",
      "description": "Max title density. Maximum value."
    },
    "maxTrafficPercentage": {
      "type": "number",
      "format": "float",
      "description": "Max traffic percentage. Maximum value. Percentage or ratio value as documented."
    },
    "maxWordCount": {
      "type": "integer",
      "format": "int32",
      "description": "Max word count. Maximum value."
    },
    "minAdProducts": {
      "type": "integer",
      "format": "int32",
      "description": "Min ad products. Minimum value."
    },
    "minAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Min avg price. Minimum value."
    },
    "minBid": {
      "type": "number",
      "format": "float",
      "description": "Min bid. Minimum value."
    },
    "minCompetitors": {
      "type": "integer",
      "format": "int32",
      "description": "Min competitors. Minimum value."
    },
    "minConversionRate": {
      "type": "number",
      "format": "float",
      "description": "Min conversion rate. Minimum value. Percentage or ratio value as documented."
    },
    "minMonopolyClickRate": {
      "type": "number",
      "format": "float",
      "description": "Min monopoly click rate. Minimum value."
    },
    "minProducts": {
      "type": "integer",
      "format": "int32",
      "description": "Min products. Minimum value."
    },
    "minPurchaseRate": {
      "type": "number",
      "format": "float",
      "description": "Min purchase rate. Minimum value. Percentage or ratio value as documented."
    },
    "minPurchases": {
      "type": "integer",
      "format": "int32",
      "description": "Min purchases. Minimum value."
    },
    "minSPR": {
      "type": "integer",
      "format": "int32",
      "description": "Min SPR. Minimum value."
    },
    "minSearchRank": {
      "type": "integer",
      "format": "int32",
      "description": "Min search rank. Minimum value."
    },
    "minSearches": {
      "type": "integer",
      "format": "int32",
      "description": "Min searches. Minimum value."
    },
    "minSupplyDemandRatio": {
      "type": "number",
      "format": "float",
      "description": "Min supply demand ratio. Minimum value."
    },
    "minTitleDensity": {
      "type": "integer",
      "format": "int32",
      "description": "Min title density. Minimum value."
    },
    "minTrafficPercentage": {
      "type": "number",
      "format": "float",
      "description": "Min traffic percentage. Minimum value. Percentage or ratio value as documented."
    },
    "minWordCount": {
      "type": "integer",
      "format": "int32",
      "description": "Min word count. Minimum value."
    },
    "order": {
      "type": "object",
      "properties": {
        "desc": {
          "type": "boolean",
          "description": "Use true for descending order or false for ascending order."
        },
        "field": {
          "type": "string",
          "description": "Field used to sort the results. Available values (Table 2.5): trafficPercentage, relationAsin, searchesRank, searches, purchases, purchaseRate, spr, titleDensity, products, supplyDemandRatio, adProduct, monopolyClickRate, bid"
        }
      },
      "additionalProperties": false,
      "description": "Sort definition."
    },
    "page": {
      "type": "integer",
      "format": "int32",
      "minimum": 1,
      "description": "Page number starting at 1."
    },
    "queryType": {
      "type": "integer",
      "format": "int32",
      "description": "Query type. See the documented default in the example column."
    },
    "returnFields": {
      "type": "string",
      "description": "Optional comma-separated response fields. Omit it to receive the standard payload."
    },
    "size": {
      "type": "integer",
      "format": "int32",
      "minimum": 1,
      "description": "Number of results per page."
    }
  },
  "required": [
    "asinList",
    "marketplace",
    "queryType"
  ],
  "additionalProperties": false
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema 
curl "https://apis.io/api/v1/json-schemas/ecommercedataapi-com-amazon-keywords-expand-request"
All schemas 
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.