Use Cases for Keyword by Keyword Endpoint

Updated July 18, 2025 06:19

The Keywords by Keyword endpoint allows you to explore related keywords and identify new market opportunities by starting with a seed keyword. When you know one successful keyword, this endpoint helps you discover the entire keyword landscape around it, revealing opportunities you might not have considered.

Why Use This Endpoint: This is essential for keyword expansion, competitive research, optimizing your listings, and benchmarking against the competition. Unlike the Keywords by ASIN endpoint, this works on a 1-to-1 basis - you input a single keyword and receive data on all related keywords in one call, making it perfect for comprehensive keyword discovery and analysis.

Endpoint Details

Request Type: POST
URL: /api/keywords/keywords_by_keyword_query
Available Markets: US, UK, DE, IN, CA, FR, IT, ES, MX, JP

What You Can Input (Per API Call)

Required Parameters

Search Terms: Single target keyword (e.g., "yoga")
Marketplace: Country code (us, uk, de, in, ca, fr, it, es, mx, jp)

Optional Filtering Parameters

Search Volume Filters:
- Min/max monthly search volume (exact match)
- Min/max monthly search volume (broad match)
Keyword Characteristics:
- Min/max word count in keywords
- Min/max organic product count competing
Pagination: Page size (max 100 results, default 50) and cursor for additional pages
Sorting: Multiple sort options with default set to highest monthly search volume exact (-monthly_search_volume_exact)

Sample Request Body

{
  "data": {
    "type": "keywords_by_keyword_query",
    "attributes": {
      "search_terms": "yoga",
      "min_monthly_search_volume_exact": 1,
      "max_monthly_search_volume_exact": 99999,
      "min_monthly_search_volume_broad": 1,
      "max_monthly_search_volume_broad": 99999,
      "min_word_count": 1,
      "max_word_count": 99999,
      "min_organic_product_count": 1,
      "max_organic_product_count": 99999
    }
  }
}

What You Get Back

Core Keyword Data

Keyword Name: The related search term (e.g., "alo yoga women", "women's leggings")
Country: Amazon Marketplace

Search Volume & Trends

Monthly Search Volume (Exact): The number of times this exact keyword has been searched in the Amazon catalog in the past 30 days (excluding the singular/plural form and misspellings).
Monthly Search Volume (Broad): The number of times this keyword and any related keywords (synonyms, phrases, etc.) have been searched in Amazon in the last 30 days (excluding the singular/plural form and misspellings).
Monthly Trend: 30-day growth/decline percentage
Quarterly Trend: 90-day growth/decline percentage

Competition Intelligence

Organic Product Count: Total products ranking organically (up to 10,000)
Sponsored Product Count: The most recent number of sponsored products ranking for that specific keyword.
Dominant Category: The most common parent category for the top 10 ranked listings.

Advertising Insights

PPC Bid (Broad): The Estimated broad match bid rate for PPC (Sponsored Product ads) for the keyword
PPC Bid (Exact): The Estimated exact match bid rate for PPC (Sponsored Product ads) for the keyword
SP Brand Ad Bid: The Estimated bid rate for Sponsored brand ads (when available)

Additional Keyword Metrics

Ease of Ranking Score: Difficulty assessment (0-100 scale). How easy it is for a new product to rank for this keyword. It is measured when collecting data for a specific keyword. We take a snapshot of the 50-100 products we get from this data and assess the number of times the keyword shows up in the title of those products. The less it shows up, the ease to rank is higher or better; the more it shows up, the ease to rank is lower or worse.
Relevancy Score: How relevant the keyword is to your original search term
Recommended Promotions: Promotional opportunity count

Sample Response Output

{
  "data": [
    {
      "id": "us/alo yoga women",
      "type": "keywords_by_keyword_result",
      "attributes": {
        "country": "us",
        "name": "alo yoga women",
        "monthly_trend": 14.73,
        "monthly_search_volume_exact": 83255,
        "quarterly_trend": 8.99,
        "monthly_search_volume_broad": 89382,
        "dominant_category": "Clothing, Shoes & Jewelry",
        "recommended_promotions": 323,
        "sp_brand_ad_bid": null,
        "ppc_bid_broad": 1.18,
        "ppc_bid_exact": 1.11,
        "ease_of_ranking_score": 90,
        "relevancy_score": 122,
        "organic_product_count": 10000,
        "sponsored_product_count": 36
      }
    },
    {
      "id": "us/women's leggings",
      "type": "keywords_by_keyword_result",
      "attributes": {
        "country": "us",
        "name": "women's leggings",
        "monthly_trend": -6.74,
        "monthly_search_volume_exact": 53180,
        "quarterly_trend": -44.38,
        "monthly_search_volume_broad": 63816,
        "dominant_category": "Clothing, Shoes & Jewelry",
        "recommended_promotions": 28,
        "sp_brand_ad_bid": null,
        "ppc_bid_broad": 1.66,
        "ppc_bid_exact": 1.42,
        "ease_of_ranking_score": 95,
        "relevancy_score": 87,
        "organic_product_count": 70000,
        "sponsored_product_count": 14
      }
    }
  ],
  "meta": {
    "total_items": 980
  },
  "links": {
    "self": "http://developer.junglescout.com/api/keywords/keywords_by_keyword_query?marketplace=us&page%5Bsize%5D=4",
    "next": "http://developer.junglescout.com/api/keywords/keywords_by_keyword_query?marketplace=us&page%5Bcursor%5D=WzUzMTgwLCJ3b21lbidzIGxlZ2dpbmdzIiw4Ny4xMjk2MTZd&page%5Bsize%5D=4"
  }
}

Data Highlights

Data Freshness: Current/last known values including last 30-day search volume
Data Structure: Not listed by date - provides point-in-time snapshots with trend indicators. Use the Historical Search Volume endpoint to get weekly historical search volume by keyword.
Response Limit: Up to 100 keywords per API call with pagination for larger datasets (default 50 per page)
Search Method: 1-to-1 basis - input one keyword, get comprehensive related keyword data

Use Cases & Applications

1. Streamlining Related Keyword Discovery

Business Goal: Efficiently generate a comprehensive list of related keywords from a single input to save time and streamline keyword research.

How to Implement:

Start with your primary keyword (e.g., "basketball")
Use the endpoint to retrieve all related keywords in one call
Filter results by search volume and competition levels to prioritize opportunities
Export the keyword list for further analysis or campaign development

Key Metrics to Focus On:

Monthly search volume (exact) for market sizing
Relevancy score to ensure keyword alignment
Ease of ranking score for opportunity assessment
Monthly and quarterly trends for growth identification

Business Impact: Dramatically reduce keyword research time while ensuring comprehensive coverage of related search terms. Build more complete keyword strategies without missing valuable opportunities.

2. Foundation for Comprehensive API Data Analysis

Business Goal: Create a systematic approach to keyword research by using this endpoint as the foundation for deeper analysis across multiple API endpoints.