ecommercedataapi-com · Schema

AmazonKeywordsResearchRequest

Companyecommercedataapiamazonmarket-research

Properties

Name Type Description
departments array Departments.
excludeKeywords string Exclude keywords.
keywords string Keywords used by the query.
marketPeriod string Market period. Available values (Table 1.7): N, S1, S2, S3, S4, S5, S6, S7, S8, S9, S10, S11, S12, I, D
marketplace string Amazon marketplace code. Supported values are listed in the schema.
maxAraClickRate number Max ara click rate. Maximum value.
maxAvgPrice number Max avg price. Maximum value.
maxBid number Max bid. Maximum value.
maxGoodsValue number Max goods value. 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.
maxRating number Max rating. Maximum value.
maxRatings integer Max ratings. Maximum value.
maxSearchMonthCr number Max search month change rate. Maximum value. Percentage or ratio value as documented.
maxSearchMonthCv integer Max search month change value. Maximum value.
maxSearchNearlyCr number Max search nearly change rate. Maximum value. Percentage or ratio value as documented.
maxSearchNearlyCv integer Max search nearly change value. Maximum value.
maxSearches integer Max searches. Maximum value.
maxSearchesCr number Max searches change rate. Maximum value. Percentage or ratio value as documented.
maxSupplyDemandRatio number Max supply demand ratio. Maximum value.
maxWordCount integer Max word count. Maximum value.
minAraClickRate number Min ara click rate. Minimum value.
minAvgPrice number Min avg price. Minimum value.
minBid number Min bid. Minimum value.
minGoodsValue number Min goods value. 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.
minRating number Min rating. Minimum value.
minRatings integer Min ratings. Minimum value.
minSearchMonthCr number Min search month change rate. Minimum value. Percentage or ratio value as documented.
minSearchMonthCv integer Min search month change value. Minimum value.
minSearchNearlyCr number Min search nearly change rate. Minimum value. Percentage or ratio value as documented.
minSearchNearlyCv integer Min search nearly change value. Minimum value.
minSearches integer Min searches. Minimum value.
minSearchesCr number Min searches change rate. Minimum value. Percentage or ratio value as documented.
minSupplyDemandRatio number Min supply demand ratio. Minimum value.
minWordCount integer Min word count. Minimum value.
month string Data month. Use the format documented for this endpoint, usually yyyyMM. Available values (Table 1.1): nearly, yyyyMM
order object Sort definition.
page integer Page number starting at 1.
returnFields string Optional comma-separated response fields. Omit it to receive the standard payload.
size integer Number of results per page.
withYearlyGrowth boolean With yearly growth.
View JSON Schema on GitHub

JSON Schema

ecommercedataapi-com-amazon-keywords-research-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-research-request-schema.json",
  "title": "AmazonKeywordsResearchRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ecommercedataapi-com-openapi.json#/components/schemas/AmazonKeywordsResearchRequest",
  "type": "object",
  "properties": {
    "departments": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Departments."
      },
      "description": "Departments."
    },
    "excludeKeywords": {
      "type": "string",
      "description": "Exclude keywords."
    },
    "keywords": {
      "type": "string",
      "description": "Keywords used by the query."
    },
    "marketPeriod": {
      "type": "string",
      "description": "Market period. Available values (Table 1.7): N, S1, S2, S3, S4, S5, S6, S7, S8, S9, S10, S11, S12, I, D"
    },
    "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."
    },
    "maxAraClickRate": {
      "type": "number",
      "format": "float",
      "description": "Max ara click rate. Maximum value."
    },
    "maxAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Max avg price. Maximum value."
    },
    "maxBid": {
      "type": "number",
      "format": "float",
      "description": "Max bid. Maximum value."
    },
    "maxGoodsValue": {
      "type": "number",
      "format": "float",
      "description": "Max goods value. 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."
    },
    "maxRating": {
      "type": "number",
      "format": "float",
      "description": "Max rating. Maximum value."
    },
    "maxRatings": {
      "type": "integer",
      "format": "int32",
      "description": "Max ratings. Maximum value."
    },
    "maxSearchMonthCr": {
      "type": "number",
      "format": "float",
      "description": "Max search month change rate. Maximum value. Percentage or ratio value as documented."
    },
    "maxSearchMonthCv": {
      "type": "integer",
      "format": "int32",
      "description": "Max search month change value. Maximum value."
    },
    "maxSearchNearlyCr": {
      "type": "number",
      "format": "float",
      "description": "Max search nearly change rate. Maximum value. Percentage or ratio value as documented."
    },
    "maxSearchNearlyCv": {
      "type": "integer",
      "format": "int32",
      "description": "Max search nearly change value. Maximum value."
    },
    "maxSearches": {
      "type": "integer",
      "format": "int32",
      "description": "Max searches. Maximum value."
    },
    "maxSearchesCr": {
      "type": "number",
      "format": "float",
      "description": "Max searches change rate. Maximum value. Percentage or ratio value as documented."
    },
    "maxSupplyDemandRatio": {
      "type": "number",
      "format": "float",
      "description": "Max supply demand ratio. Maximum value."
    },
    "maxWordCount": {
      "type": "integer",
      "format": "int32",
      "description": "Max word count. Maximum value."
    },
    "minAraClickRate": {
      "type": "number",
      "format": "float",
      "description": "Min ara click rate. Minimum value."
    },
    "minAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Min avg price. Minimum value."
    },
    "minBid": {
      "type": "number",
      "format": "float",
      "description": "Min bid. Minimum value."
    },
    "minGoodsValue": {
      "type": "number",
      "format": "float",
      "description": "Min goods value. 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."
    },
    "minRating": {
      "type": "number",
      "format": "float",
      "description": "Min rating. Minimum value."
    },
    "minRatings": {
      "type": "integer",
      "format": "int32",
      "description": "Min ratings. Minimum value."
    },
    "minSearchMonthCr": {
      "type": "number",
      "format": "float",
      "description": "Min search month change rate. Minimum value. Percentage or ratio value as documented."
    },
    "minSearchMonthCv": {
      "type": "integer",
      "format": "int32",
      "description": "Min search month change value. Minimum value."
    },
    "minSearchNearlyCr": {
      "type": "number",
      "format": "float",
      "description": "Min search nearly change rate. Minimum value. Percentage or ratio value as documented."
    },
    "minSearchNearlyCv": {
      "type": "integer",
      "format": "int32",
      "description": "Min search nearly change value. Minimum value."
    },
    "minSearches": {
      "type": "integer",
      "format": "int32",
      "description": "Min searches. Minimum value."
    },
    "minSearchesCr": {
      "type": "number",
      "format": "float",
      "description": "Min searches change rate. Minimum value. Percentage or ratio value as documented."
    },
    "minSupplyDemandRatio": {
      "type": "number",
      "format": "float",
      "description": "Min supply demand ratio. Minimum value."
    },
    "minWordCount": {
      "type": "integer",
      "format": "int32",
      "description": "Min word count. Minimum value."
    },
    "month": {
      "type": "string",
      "description": "Data month. Use the format documented for this endpoint, usually yyyyMM. Available values (Table 1.1): nearly, yyyyMM"
    },
    "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 1.8): searches, keywordsIsHide, searches_growth, yearly_growth_rate, growth_rate_trend_min, monopoly_click_rate, goods_value"
        }
      },
      "additionalProperties": false,
      "description": "Sort definition."
    },
    "page": {
      "type": "integer",
      "format": "int32",
      "minimum": 1,
      "description": "Page number starting at 1."
    },
    "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."
    },
    "withYearlyGrowth": {
      "type": "boolean",
      "description": "With yearly growth."
    }
  },
  "required": [
    "marketplace"
  ],
  "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-research-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.