Amazon Keyword Rank Tracker for Share of Shelf

What this pipeline does

Amazon search rank is easiest to manage when you separate two jobs: finding the target ASIN and understanding the shelf around it. The target rank tells you whether your product is visible. The surrounding rows tell you who owns the attention when your product does not.

The Amazon Keyword Rank Tracker checks Amazon search result pages for your keywords and target ASINs. It returns the keyword, page, rank, ASIN, title, price, rating, review count, competitor rows, and keyword-level summaries. That makes it useful for seller SEO, agency reporting, retail media planning, and weekly share-of-shelf checks.

Best first run

Start with a short keyword list and a small ASIN list on one Amazon domain. Avoid mixing countries, brands, and broad category terms in the first run.

{
  "keywords": ["wireless headphones", "noise cancelling headphones"],
  "targetAsins": ["B0TARGETASIN"],
  "amazonDomain": "amazon.com",
  "maxPagesPerKeyword": 2,
  "maxProductsPerKeyword": 40,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

The first run should prove whether the tracker can find your target ASIN and whether the surrounding product rows have enough context for decisions.

Output fields to keep

{
  "keyword": "wireless headphones",
  "target_asin": "B0TARGETASIN",
  "asin": "B0EXAMPLE1",
  "rank": 3,
  "page": 1,
  "is_target_asin": true
}

Keep one row per keyword and product position. Then build a summary table that stores the best rank for each target ASIN by keyword, the number of competing products found above it, and whether the ASIN was missing from the checked pages.

Share-of-shelf reporting

A useful weekly Amazon SEO report should be short enough to read. Start with these views:

• Keywords where the target ASIN is on page one
• Keywords where the target ASIN moved onto or off page one
• Keywords where the target ASIN is missing from the checked pages
• Competitors appearing above the target ASIN most often
• Price, rating, and review-count gaps against top competing rows

Those views are more useful than a raw rank dump because they explain why a seller might change price, content, ads, or inventory.

Alerting logic

Do not alert on every one-position move. Amazon search pages move often enough that small movement can become noise. Better alerts are:

• Target ASIN disappeared from the first checked pages
• Target ASIN moved from page one to page two
• A competitor crossed above the target ASIN on three or more priority keywords
• Target ASIN rank improved after a content, price, or ad campaign change

Store the source keyword, Amazon domain, run timestamp, and dataset URL with every alert so the team can inspect the underlying run.

Deployment notes

Run priority keywords daily and long-tail keywords weekly. Keep brand keywords, category keywords, and competitor keywords in separate groups so the report does not blend different intent. Pair this actor with Amazon Product Scraper for deeper product fields and Amazon Price Tracker & Watchlist when price changes need their own alerting lane.