Amazon Research JS

Amazon Keyword Share Of Voice

Compare how often brands appear in Amazon's organic and sponsored search results. Call via REST API or MCP from 88 credits per call.

MCP tool name

nexscope_amazon_keyword_share_of_voice

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "amazon-keyword-share-of-voice-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_keyword_share_of_voice",
    "arguments": {
      "keyword": "phone case",
      "marketplace": "us"
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`marketplace`	`string`	required	Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp Example: us
`keyword`	`string`	required	Keyword to query Example: phone case

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`costToken`	`integer`	optional	Number of tokens consumed Example: {}
`shareOfVoice`	`object`	optional	Share of Voice data subject Example: {}
`id`	`string`	optional	Resource ID Example: {}
`type`	`string`	optional	Fixed value `share_of_voice` Example: {}
`estimated30DaySearchVolume`	`integer`	optional	Exact match search volume over the past 30 days Example: {}
`exactSuggestedBidMedian`	`number`	optional	Median PPC bid (USD) Example: {}
`productCount`	`integer`	optional	Total number of items in the first 3 pages of search results Example: {}
`updatedAt`	`string`	optional	Data update time Example: {}
`topAsinsModelStartDate`	`string`	optional	TOP ASIN click/conversion data window start date Example: {}
`topAsinsModelEndDate`	`string`	optional	TOP ASIN click/conversion data window end date Example: {}
`brands`	`array`	optional	Brand SOV detailed list Example: {}
`topAsins`	`array`	optional	TOP 3 ASIN click conversion list Example: {}
`brand`	`string`	optional	brand name Example: {}
`organicProducts`	`integer`	optional	Number of items in organic search results Example: {}
`sponsoredProducts`	`integer`	optional	The number of products in the ad slot Example: {}
`combinedProducts`	`integer`	optional	Comprehensive product quantity Example: {}
`organicBasicSov`	`number`	optional	Natural search basics SOV (0–1) Example: {}
`organicWeightedSov`	`number`	optional	Natural search weighted SOV (0–1) Example: {}
`sponsoredBasicSov`	`number`	optional	Ad search basics SOV (0–1) Example: {}
`sponsoredWeightedSov`	`number`	optional	Ad Search Weighted SOV (0–1) Example: {}
`combinedBasicSov`	`number`	optional	Comprehensive Basic SOV (0–1) Example: {}
`combinedWeightedSov`	`number`	optional	Comprehensive weighted SOV (0–1) Example: {}
`organicAveragePosition`	`number`	optional	Average organic search ranking position Example: {}
`sponsoredAveragePosition`	`number`	optional	Ad search average position Example: {}
`combinedAveragePosition`	`number`	optional	Overall average ranking position Example: {}
`organicAveragePrice`	`number`	optional	Average price of natural search items Example: {}
`sponsoredAveragePrice`	`number`	optional	Average price of advertised search products Example: {}
`combinedAveragePrice`	`number`	optional	Comprehensive product average price Example: {}
`asin`	`string`	optional	ASIN number Example: {}
`name`	`string`	optional	Product name Example: {}
`brand`	`string`	optional	brand name Example: {}
`clicks`	`integer`	optional	Clicks (30-day window) Example: {}
`conversions`	`integer`	optional	Conversions (30-day window) Example: {}
`conversionRate`	`number`	optional	Conversion rate (0-1) Example: {}

Examples

Example arguments

{
  "keyword": "phone case",
  "marketplace": "us"
}

Example structuredContent

{}