Amazon Keywords a Product Ranks For (US English, by ASIN, 1 or 100 Keywords)

omnial/amazon-keyword-ranks

Given an Amazon product's ASIN, returns the keywords it ranks for in Amazon search for the United States marketplace in English: how many ranked keywords there are, and 1 or 100 of them (fewer when fewer exist), each with its estimated Amazon search volume, when that figure was last updated, the product's position in the search results for that keyword, how many results the search holds, and when the ranking was last refreshed and the refresh before it.

activeper resultv1

Price

Up to $0.0164 base + $0.000164 per result; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

Amazon search keyword index

Data from an index of Amazon search keywords and search volume estimates.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/amazon-keyword-ranks" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/amazon-keyword-ranks" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/amazon-keyword-ranks", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/amazon-keyword-ranks", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Base price Charged once per request	$0.0164
Per result Charged for every result returned	$0.000164

Updated: Oct 18, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "asin",
    "location_code",
    "language_code",
    "limit"
  ],
  "properties": {
    "asin": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{10}$",
      "description": "The Amazon product's ASIN: a 10-character alphanumeric identifier."
    },
    "limit": {
      "enum": [
        1,
        100
      ],
      "type": "integer",
      "default": 100,
      "description": "The most ranked keywords to return: 100 (the default) or 1."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The search language; only en (English) is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "The marketplace; only 2840 (the United States) is offered."
    },
    "ignore_synonyms": {
      "enum": [
        false
      ],
      "type": "boolean",
      "default": false,
      "description": "Whether very similar keywords are left out; only false, the default, is offered."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "asin": {
            "type": "string",
            "description": "The product's ASIN, as sent."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "keyword_data": {
                  "type": "object",
                  "properties": {
                    "keyword": {
                      "type": "string",
                      "description": "The keyword the product ranks for."
                    },
                    "keyword_info": {
                      "type": "object",
                      "properties": {
                        "search_volume": {
                          "type": "number",
                          "description": "Its estimated Amazon search volume."
                        },
                        "last_updated_time": {
                          "type": "string",
                          "description": "When that figure was last updated, with time zone."
                        }
                      }
                    }
                  }
                },
                "ranked_serp_element": {
                  "type": "object",
                  "properties": {
                    "serp_item": {
                      "type": "object",
                      "properties": {
                        "rank_absolute": {
                          "type": "number",
                          "description": "The product's position in the search results."
                        }
                      }
                    },
                    "se_results_count": {
                      "type": "number",
                      "description": "How many results the search for the keyword holds."
                    },
                    "last_updated_time": {
                      "type": "string",
                      "description": "When the ranking was last refreshed, with time zone."
                    },
                    "previous_updated_time": {
                      "type": "string",
                      "description": "When the ranking was refreshed before that, with time zone."
                    }
                  }
                }
              }
            },
            "description": "The ranked keywords returned."
          },
          "items_count": {
            "type": "number",
            "description": "The number of entries in items."
          },
          "total_count": {
            "type": "number",
            "description": "How many keywords the product ranks for."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}