REST API v1

Returns each organic result with its rank (on-page position), price (incl. list price, discount %, coupon, and per-item price when present), review count, rating, monthly-sales estimate, Prime/stock, delivery estimates, and badges, plus related_keywords. Results are organic only — sponsored/ad placements are excluded. One call returns a single page (~48 results); pass page = 2, 3, … to go deeper. has_more and last_page tell you whether more pages exist, and page echoes the page returned. Pass an optional asin to get a target block with that product's exact position on the requested page (if it flags "not ranked", the ASIN simply isn't on that page — request a higher page to find its true position). Pass an optional zip to localize the SERP — Amazon's ranking and which products appear vary by zip, and pinning one makes results stable and comparable across calls. delivery_to reflects the zip used.

Example request

curl "https://rankgeniusapp.com/api/v1/keyword_rank?keyword=insulated%20water%20bottle&zip=30303" \
  -H "Authorization: Bearer <your-api-key>"

Example response

{
    "status": "ok",
    "error": "",
    "data": {
        "query": "insulated water bottle",
        "marketplace": "us",
        "delivery_to": "Atlanta 30303",
        "total_results": 35618,
        "result_count": 48,
        "asin_count": 48,
        "page": 1,
        "last_page": 7,
        "has_more": true,
        "products": [
            {
                "asin": "B0D8J2ZB8P",
                "rank": 1,
                "sponsored": false,
                "organic_rank": 1,
                "title": "POWCAN 26 oz Insulated Water Bottle with 2-in-1 Straw and Spout Lid ...",
                "image_url": "https://m.media-amazon.com/images/I/515ELeeh4OL._AC_UL320_.jpg",
                "price": "$14.98",
                "price_num": 14.98,
                "list_price": 18.99,
                "price_per_item": null,
                "discount_pct": 21.12,
                "discount_amount": 4.01,
                "coupon": null,
                "rating": 4.6,
                "reviews": 11208,
                "monthly_sales": 9000,
                "is_prime": true,
                "stock_level": null,
                "free_delivery": "FREE delivery Tue, Jul 28",
                "fastest_delivery": "Tue, Jul 28",
                "html_index": 3,
                "badges": []
            },
            {
                "asin": "B085DTZQNZ",
                "rank": 2,
                "sponsored": false,
                "organic_rank": 2,
                "title": "Owala FreeSip Insulated Stainless Steel Water Bottle with Straw, 24 oz ...",
                "image_url": "https://m.media-amazon.com/images/I/718RbhzhVbL._AC_UL320_.jpg",
                "price": "$29.97",
                "price_num": 29.97,
                "list_price": null,
                "price_per_item": null,
                "discount_pct": null,
                "discount_amount": null,
                "coupon": null,
                "rating": 4.7,
                "reviews": 130660,
                "monthly_sales": 20000,
                "is_prime": true,
                "stock_level": null,
                "free_delivery": "FREE delivery Tue, Jul 28",
                "fastest_delivery": "Tue, Jul 28",
                "html_index": 5,
                "badges": ["best_seller"]
            }
        ],
        "related_keywords": ["water bottle", "insulated water bottle 32oz", "insulated water bottle 40oz"]
    }
}

Returns the owning seller id and name, winning price/currency, in-stock flag and stock "only N left" counter, FBA vs. merchant + ships_from, Prime status, and any used/used_price offer. seller_id, ships_from, fba, stock, and the used-offer fields are null when Amazon itself holds the Buy Box and populate for third-party listings. Pass an optional zip to add a location-specific delivery estimate — the response then also includes delivery_to, fastest_delivery, free_delivery, and free_shipping (only a fixed set of US postal codes is supported; others return an error).

Example request

curl "https://rankgeniusapp.com/api/v1/buybox?asin=B085DTZQNZ&zip=30303" \
  -H "Authorization: Bearer <your-api-key>"

Example response

{
    "status": "ok",
    "error": "",
    "data": {
        "asin": "B085DTZQNZ",
        "marketplace": "us",
        "seller_id": null,
        "sold_by": "Amazon.com",
        "price": 29.97,
        "currency": "$",
        "in_stock": true,
        "stock": null,
        "prime": true,
        "ships_from": null,
        "fba": null,
        "used": null,
        "used_price": null,
        "competing_offers": null,
        "zip": "30303",
        "delivery_to": "Atlanta 30303",
        "fastest_delivery": "Friday, July 24",
        "free_delivery": "Tuesday, July 28",
        "free_shipping": true
    }
}

Parses the major elements out of the live product page into a product object — title, brand, star rating and ratings count, "about this item" bullets, category breadcrumbs, Best Sellers Rank, image URLs, availability, variations (colour/size/style and the sibling ASINs), badges (e.g. frequently_returned, amazons_choice, climate_pledge_friendly), whether it has A+ content, and the buy-box seller/fulfillment. Also returns a full details attribute table (material, dimensions, weight, UPC/GTIN, model, care instructions, …), the AI-generated customer_say review summary, monthly_sales (recent purchase volume), A+ image/video URLs, and review_insights (per-aspect sentiment). (For a reliable price/currency, use buybox.)

Free repeats: re-requesting the same ASIN + marketplace within the freshness window (default 1 hour; see the since parameter) is served from cache and is not metered (cached: true).

Example request

curl "https://rankgeniusapp.com/api/v1/product_page?asin=B085DTZQNZ" \
  -H "Authorization: Bearer <your-api-key>"

Example response

{
    "status": "ok",
    "error": "",
    "data": {
        "asin": "B085DTZQNZ",
        "marketplace": "us",
        "delivery_to": null,
        "html_bytes": 0,
        "cached": false,
        "product": {
            "asin": "B085DTZQNZ",
            "parsed": true,
            "title": "Owala FreeSip Stainless Steel Water Bottle 24 oz ...",
            "brand": "Owala",
            "rating": 4.6,
            "ratings_count": 135827,
            "bullets": ["24-ounce insulated stainless-steel water bottle with a FreeSip spout ...", "..."],
            "best_sellers_rank": [
                { "rank": 1, "category": "Home & Kitchen" },
                { "rank": 1, "category": "Insulated Bottles" }
            ],
            "category": ["Home & Kitchen", "Kitchen & Dining", "Thermoses", "Insulated Beverage Containers"],
            "images": [
                "https://m.media-amazon.com/images/I/718RbhzhVbL._AC_SL1500_.jpg",
                "https://m.media-amazon.com/images/I/51NEAowN4KL._AC_SL1080_.jpg"
            ],
            "availability": "In Stock",
            "sold_by": "Amazon.com",
            "seller_id": null,
            "ships_from": "Amazon.com",
            "sold_by_amazon": true,
            "fba": true,
            "prime": true,
            "price": 29.97,
            "buybox": { "seller_name": "Amazon.com", "seller_id": null, "ships_from": "Amazon.com", "sold_by_amazon": true, "fba": true },
            "monthly_sales": 40000,
            "monthly_sales_text": "40K+ bought in past month",
            "variations": [
                { "value": "32 oz", "asin": "B0BZYCJK89", "price": 29.99, "available": true, "image_url": "..." }
            ],
            "has_aplus": true,
            "aplus_images": ["https://m.media-amazon.com/images/S/aplus-media-library-service-media/....png"],
            "aplus_videos": [],
            "details": {
                "Brand Name": "Owala",
                "Material": "Stainless Steel",
                "Item Weight": "13.6 ounces",
                "UPC": "847280062256"
            },
            "customer_say": "Customers love the temperature retention, leak-proof design, and hidden straw.",
            "review_insights": { "summary": "...", "featureAspects": [] }
        }
    }
}

Returns customer reviews for a product, one page at a time (~10 per page). Each review carries rating, title, author, verified/vine flags, helpful_votes, body text, and any review images/videos. Aggregates: product_rating (e.g. 4.6); rating_count = all star ratings (with or without written text); review_count = written reviews only, so it is normally much smaller than rating_count (they are not meant to match). star_breakdown is the percentage at each 1–5 stars (Amazon publishes no per-star counts; multiply by rating_count for an estimate). Walk pages with page (has_more/last_page); sort with sort: recent (chronological, newest first) or helpful (Amazon's "Top reviews" order — Amazon's own relevance ranking, which factors in recency and verified purchases, so it is not a strict most-helpful-votes sort and low-vote reviews can appear first). Amazon exposes only ~100 reviews per sort: last_page reflects those accessible pages and can be far below review_count — you cannot page to every review.

One page (~10 reviews) per request; page through with page up to last_page (Amazon caps public reviews at ~100 per sort). rating_count and review_count are the true product totals and differ by design (all ratings vs written reviews). star_breakdown is percentages only — Amazon exposes no exact per-star counts, so track product_rating + rating_count for precise trends.

Example request

curl "https://rankgeniusapp.com/api/v1/product_reviews?asin=B085DTZQNZ&page=1&sort=recent" \
  -H "Authorization: Bearer <your-api-key>"

Example response

{
    "status": "ok",
    "error": "",
    "data": {
        "asin": "B085DTZQNZ",
        "marketplace": "us",
        "page": 1,
        "last_page": 10,
        "has_more": true,
        "sort": "recent",
        "product_title": "Owala FreeSip Stainless Steel Water Bottle 24 oz ...",
        "product_rating": 4.6,
        "rating_count": 133146,
        "review_count": 10000,
        "star_breakdown": { "5": 85, "4": 7, "3": 3, "2": 1, "1": 4 },
        "reviews": [
            {
                "review_id": "R20F2R35NH8QSK",
                "title": "The straw won't stay in place",
                "rating": 3.0,
                "author": "Ldterry",
                "date": "Reviewed in the United States on August 9, 2026",
                "date_iso": "2026-08-09",
                "verified": true,
                "vine": false,
                "helpful_votes": 0,
                "variation": "B0F359FRH8",
                "text": "Love the bottle overall but the straw ...",
                "images": [],
                "videos": []
            }
        ]
    }
}

Lists the delivery codes that keyword_rank and buybox accept as an optional zip (unsupported codes are rejected). Returns { zip, delivery } rows for the marketplace. Not metered — it doesn't spend credits. The full list is also browsable at /docs/zip-codes.

Un-metered. Use it to pick a valid zip before calling a tool that takes one.

Example request

curl "https://rankgeniusapp.com/api/v1/supported_zips" \
  -H "Authorization: Bearer <your-api-key>"

Example response

{
    "status": "ok",
    "error": "",
    "data": {
        "marketplace": "us",
        "count": 308,
        "zips": [
            { "zip": "10001", "delivery": "NEW YORK - 10001" },
            { "zip": "30303", "delivery": "ATLANTA - 30303" },
            { "zip": "90001", "delivery": "LOS ANGELES - 90001" }
        ]
    }
}

Returns your account identity and current usage. This call is not metered — use it to verify your key and check where you stand against your plan.

Example request

curl "https://rankgeniusapp.com/api/v1/whoami" \
  -H "Authorization: Bearer <your-api-key>"

Example response

{
    "status": "ok",
    "error": "",
    "data": {
        "account_id": "A1B2C3D4",
        "name": "Acme Co.",
        "plan": "free",
        "credit_balance": 8740,
        "usage_rate": 10,
        "usage_this_month": 142
    }
}