Use Cases for Keyword by ASIN Endpoint

The Keywords by ASIN endpoint allows you to discover which keywords drive traffic to specific Amazon products. By analyzing up to 10 ASINs simultaneously, you can uncover the search terms that customers use to find these products, giving you valuable insights into keyword strategies, competitive positioning, and market opportunities.

Why Use This Endpoint: This is essential for reverse-engineering successful keyword strategies, optimizing your own product listings, understanding competitive positioning, and discovering untapped keyword opportunities. Unlike other keyword tools that work on a 1-to-1 basis, this endpoint returns all keywords relating to your input ASINs, providing comprehensive keyword intelligence in a single call.


Endpoint Details

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


What You Can Input (Per API Call)

Required Parameters

  • ASINs: Up to 10 Amazon ASINs to analyze
  • Marketplace: Country code (us, uk, de, in, ca, fr, it, es, mx, jp)

Optional Filtering Parameters

  • Include Variants: Boolean to include variant ASINs in results
  • 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) and cursor for additional pages
  • Sorting: Multiple sort options including search volume, trends, competition metrics

Sample Request Body

{
  "data": {
    "type": "keywords_by_asin_query",
    "attributes": {
      "asins": [
        "B08RT1NF23",
        "B002UXRXE6", 
        "B09RTVN5GN"
      ],
      "include_variants": false,
      "min_monthly_search_volume_exact": 1,
      "max_monthly_search_volume_exact": 99999,
      "min_word_count": 1,
      "max_word_count": 99999
    }
  }
}

What You Get Back

Core Keyword Data

  • Keyword Name: The actual search term (e.g., "aaa batteries 24 pack")
  • Primary ASIN: The first ASIN in the list entered if more than 1 ASIN was queried. This will be the ASIN used for the comparison metrics below which will compare the other ASINs data points to this ASIN.
  • 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)

Ranking & Competitive Positioning

Ranking Analysis

  • Organic Rank: Where the primary ASIN ranks organically (0 = not ranking). The ASIN's organic position on the search results page for the keyword. Sponsored results are excluded.
  • Sponsored Rank: Where the primary ASIN ranks in sponsored results. The ASIN's sponsored position on the search results page for the keyword. Organic results are excluded.
  • Overall Rank: The primary ASIN's overall position on the search results page for the keyword. This would display the first time an ASIN appears on the page and ignores if it is a sponsored or organic result.

Competitive Positioning - If you want to compare your ASIN to competitors, enter your ASIN first in the query so it is the Primary ASIN.

  • Organic Ranking ASINs Count: How many of your input ASINs rank organically, excluding the primary ASIN
  • Sponsored Ranking ASINs Count: How many of your input ASINs rank in ads, excluding the primary ASIN
  • Average Competitor Organic Rank: This is the average organic rank for the ASINs you entered excluding the primary ASIN (basically, how well these ASINs are ranking for this keyword on average).
  • Average Competitor Sponsored Rank: This is the average sponsored rank for the ASINs you entered excluding the primary ASIN. (basically, how well the ads for these other ASINs rank for this keyword on average).
  • Relative Organic/Sponsored Position: The organic or sponsored rank of the Primary ASIN relative to the other ASINs. For example, if the primary ASIN ranks higher than the other ASINs the rank will be 1. Use this to show your position relative to competitors if Your ASIN is the primary ASIN.
  • Competitor Organic/Sponsored Rank: Individual organic and sponsored rank for each ASIN excluding the Primary ASIN.

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 ASINs

Sample Response Output

{
  "data": [
    {
      "id": "us/aaa batteries 24 pack",
      "type": "keywords_by_asin_result",
      "attributes": {
        "country": "us",
        "name": "aaa batteries 24 pack",
        "primary_asin": "B08RT1NF23",
        "monthly_trend": 13.5,
        "monthly_search_volume_exact": 74882,
        "quarterly_trend": -44.22,
        "monthly_search_volume_broad": 84866,
        "dominant_category": "Health & Household",
        "recommended_promotions": 1022,
        "sp_brand_ad_bid": null,
        "ppc_bid_broad": 2.2,
        "ppc_bid_exact": 6.67,
        "ease_of_ranking_score": 90,
        "relevancy_score": 70,
        "organic_product_count": 10000,
        "sponsored_product_count": 28,
        "organic_rank": 0,
        "sponsored_rank": null,
        "overall_rank": null,
        "organic_ranking_asins_count": 2,
        "sponsored_ranking_asins_count": 1,
        "avg_competitor_organic_rank": 4,
        "avg_competitor_sponsored_rank": 2,
        "relative_organic_position": 3,
        "relative_sponsored_position": 2,
        "competitor_organic_rank": [
          {
            "asin": "B002UXRXE6",
            "organic_rank": 2
          },
          {
            "asin": "B09RTVN5GN",
            "organic_rank": 6
          }
        ],
        "competitor_sponsored_rank": [
          {
            "asin": "B002UXRXE6",
            "sponsored_rank": 0
          },
          {
            "asin": "B09RTVN5GN",
            "sponsored_rank": 1
          }
        ]
      }
    }
  ],
  "meta": {
    "total_items": 2191
  },
  "links": {
    "self": "http://developer.junglescout.com/api/keywords/keywords_by_asin_query?marketplace=us&page%5Bsize%5D=3",
    "next": "http://developer.junglescout.com/api/keywords/keywords_by_asin_query?marketplace=us&page%5Bcursor%5D=Wzc0NTE1LCJhYSBiYXR0ZXJpZXMgMjQgcGFjayIsNTIuMDA5NDRd&page%5Bsize%5D=3"
  }
}

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.
  • Search Depth: Analyzes up to 3 pages of Amazon search results per keyword
  • Response Limit: Up to 100 keywords per API call with pagination for larger datasets

Use Cases & Applications

1. Tracking Organic Rank for Multiple ASINs Across Keywords

Business Goal: Monitor how multiple products perform across shared keywords and identify ranking opportunities.

Screen Shot 2024-02-02 at 4.28.31 PM.png

How to Implement:

  • Input up to 10 related ASINs (your products + key competitors)
  • Analyze organic and sponsored rankings for each ASIN across relevant keywords
  • Compare performance metrics to identify strengths and weaknesses

Key Metrics to Focus On:

  • Organic ranking positions for each ASIN
  • Relative organic position compared to competitors
  • Average competitor rankings to understand competitive landscape

Business Impact: Identify which products are winning in search results and which need optimization. Shift marketing budgets toward highest-performing products and keywords.


2. Discovering Opportunity Keywords

Business Goal: Find untapped keywords where competitors rank but you don't, revealing expansion opportunities.

Screen Shot 2024-02-02 at 4.29.06 PM.png

How to Implement:

  • Run separate queries: one with your ASINs, another with competitor ASINs
  • Compare keyword lists to identify gaps
  • Focus on keywords where competitors rank well but you don't appear
  • Analyze search volume and competition levels for prioritization

Key Metrics to Focus On:

  • Keywords with high search volume where you don't rank
  • Competitor relevancy scores vs. your potential
  • Ease of ranking scores for opportunity assessment

Business Impact: Expand keyword targeting for SEO and advertising campaigns. Identify new content opportunities and listing optimization priorities.


Technical Specifications

Rate Limits

  • Endpoint follows standard API rate limits (300 requests/minute, 15/second)
  • Each call can process up to 10 ASINs simultaneously
  • Pagination available for responses exceeding 100 keywords

Response Format

  • JSON API format with proper pagination links
  • Meta data includes total available items
  • Links provided for self-reference and next page retrieval

Error Handling

  • 400 Bad Request: Invalid ASIN format or missing required parameters
  • 403 Forbidden: API key lacks marketplace permissions
  • 422 Validation Error: Parameter values outside acceptable ranges

Additional endpoint documentation is available here: https://developer.junglescout.com/api#endpoints

 

Was this article helpful?
0 out of 0 found this helpful