{"uid":"cap_zvMJLAmIt1EQpVp8bL7ce","slug":"agents-openwebninja-com-amazon-scrape-by-url-4f119977","name":"Amazon Scrape By URL","description":"Scrape any Amazon page by providing a full URL. The API automatically detects the page type (product details, product reviews, deals, best sellers, seller profile, seller products, search results, etc.) and returns parsed, structured data accordingly.","url":"https://agents.openwebninja.com/realtime-amazon-data/scrape-by-url?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"The full Amazon URL to scrape. The API automatically detects the page type and returns the appropriate parsed data.\n\n  **Supported page types:**\n  - Product details (e.g. `https://www.amazon.com/dp/B0D1XD1ZV3`)\n  - Product reviews (e.g. `https://www.amazon.com/product-reviews/B0D1XD1ZV3`)\n  - Deals (e.g. `https://www.amazon.com/deals`)\n  - Best sellers (e.g. `https://www.amazon.com/Best-Sellers/zgbs`)\n  - Seller profile (e.g. `https://www.amazon.com/sp?seller=A1D09S7Q0OD6TH`)\n  - Seller products\n  - Search results\n  - Amazon Haul"},"cookie":{"type":"string","description":"Custom cookie string to use when scraping the URL."},"country":{"enum":["US","AU","BR","CA","CN","FR","DE","IN","IT","MX","NL","SG","ES","TR","AE","GB","JP","SA","PL","SE","BE","EG","ZA","IE"],"type":"string","default":"US","description":"Sets the Amazon domain, marketplace country, language and currency."},"language":{"type":"string","description":"The language of the results. In case not specified, results will be returned in the default domain language.\n\n  **Supported languages per country:**\n  `US`: en_US, es_US\n  `AU`: en_AU\n  `BR`: pt_BR\n  `CA`: en_CA, fr_CA\n  `FR`: fr_FR, en_GB\n  `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK\n  `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN\n  `IT`: it_IT, en_GB\n  `MX`: es_MX\n  `NL`: nl_NL, en_GB\n  `SG`: en_SG\n  `ES`: es_ES, pt_PT, en_GB\n  `TR`: tr_TR\n  `AE`: en_AE, ar_AE\n  `GB`: en_GB\n  `JP`: ja_JP, en_US, zh_CN\n  `SA`: ar_AE, en_AE\n  `PL`: pl_PL\n  `SE`: sv_SE, en_GB\n  `BE`: fr_BE, nl_BE, en_GB\n  `EG`: ar_AE, en_AE\n  `ZA`: en_ZA\n  `IE`: en_IE"},"return_html":{"enum":["true","false"],"type":"string","default":"false","description":"Include the raw HTML of the scraped page in the response.\n**Default:** `false`"},"delivery_country":{"type":"string","description":"Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delivery. Defaults to the marketplace country.  \n  Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`.  \n  Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"asin":{"type":"string","description":"Product ASIN (when page_type is product_details or product_reviews)."},"html":{"type":"string","description":"Raw HTML of the scraped page (only included when return_html=true)."},"deals":{"type":"array","items":{"type":"object"},"description":"List of deals (when page_type is deals)."},"domain":{"type":"string","description":"Amazon domain used for the request."},"country":{"type":"string","description":"Marketplace country where the data was fetched."},"currency":{"type":"string","description":"Currency of the listed price."},"is_prime":{"type":"boolean","description":"Whether the product is eligible for Prime."},"products":{"type":"array","items":{"type":"object"},"description":"List of products (when page_type is search, products_by_category, or seller_products)."},"page_type":{"type":"string","description":"The detected type of Amazon page. Determines the structure of the rest of the data object.\n**Possible values:** `product_details`, `product_reviews`, `deals`, `best_sellers`, `seller_profile`, `seller_products`, `haul`, `products_by_category`, `search`, `unknown`"},"seller_id":{"type":"string","description":"Seller identifier (when page_type is seller_profile or seller_products)."},"product_url":{"type":"string","description":"Canonical Amazon product URL."},"top_reviews":{"type":"array","items":{"type":"object"},"description":"Top customer reviews from the product page."},"best_sellers":{"type":"array","items":{"type":"object"},"description":"List of best seller products (when page_type is best_sellers)."},"product_slug":{"type":"string","description":"SEO-friendly slug derived from the product title."},"sales_volume":{"type":"string","description":"Sales velocity/volume label if present."},"about_product":{"type":"array","items":{"type":"string"},"description":"List of bullet point descriptions from the product page."},"product_photo":{"type":"string","description":"URL of the main product image."},"product_price":{"type":"string","description":"Displayed current price (product_details page type)."},"product_title":{"type":"string","description":"Full product title as shown on Amazon (product_details page type)."},"is_best_seller":{"type":"boolean","description":"Whether the product is flagged as a Best Seller."},"product_byline":{"type":"string","description":"Byline text (e.g., brand/store attribution)."},"product_photos":{"type":"array","items":{"type":"string"},"description":"List of product image URLs."},"product_videos":{"type":"array","items":{"type":"object"},"description":"List of product video objects."},"product_details":{"type":"object","description":"Technical details / specifications of the product.","additionalProperties":{"type":"string"}},"is_amazon_choice":{"type":"boolean","description":"Whether the product is marked as Amazon's Choice."},"product_condition":{"type":"string","description":"Product condition (New, Used, Renewed, etc.)."},"product_num_offers":{"type":"integer","description":"Count of available offers for this product."},"top_reviews_global":{"type":"array","items":{"type":"object"},"description":"Top global customer reviews."},"product_byline_link":{"type":"string","description":"Primary link behind the byline."},"product_description":{"type":"string","description":"Long-form product description."},"product_information":{"type":"object","description":"Key-value pairs from the product information section.","additionalProperties":{"type":"string"}},"product_num_ratings":{"type":"integer","description":"Total number of ratings."},"product_star_rating":{"type":"string","description":"Average star rating shown on the page."},"rating_distribution":{"type":"object","properties":{"1":{"type":"integer","description":"Percentage of 1-star ratings."},"2":{"type":"integer","description":"Percentage of 2-star ratings."},"3":{"type":"integer","description":"Percentage of 3-star ratings."},"4":{"type":"integer","description":"Percentage of 4-star ratings."},"5":{"type":"integer","description":"Percentage of 5-star ratings."}}},"product_availability":{"type":"string","description":"Availability status text."},"product_byline_links":{"type":"array","items":{"type":"string"},"description":"Links behind the byline (brand / author / store)."},"product_original_price":{"type":"string","description":"Original list price before discounts (product_details page type)."},"climate_pledge_friendly":{"type":"boolean","description":"Whether the product is marked Climate Pledge Friendly."}},"description":"The scraped and parsed data. The structure varies based on the detected page_type. The page_type field is always present and indicates what kind of Amazon page was scraped. For a product page (page_type `product_details`) the data object has every field of the Product Details endpoint response (for example best_sellers_rank, review_aspects_details, main_buy_box and frequently_bought_together); only the main ones are listed below."},"status":{"type":"string","description":"The status of the response."},"parameters":{"type":"object","properties":{"url":{"type":"string","description":"The Amazon URL that was scraped."},"country":{"type":"string","description":"Amazon marketplace country code used for the request."},"language":{"type":"string","description":"Language used to fetch/parse the page."}}},"request_id":{"type":"string","description":"A unique identifier for the request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_HXq1vgPQr2WlkKy_S3iTj","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Scrapes any Amazon page by URL and returns structured, parsed data automatically detecting the page type (product, reviews, deals, best sellers, seller, search, etc.)","exampleAgentPrompt":"Can you scrape the Amazon product page at https://www.amazon.com/dp/B0D1XD1ZV3 on the US marketplace and give me the structured details — price, title, reviews, Prime eligibility, and product description?","exampleUseCases":[{"title":"Product price and detail extraction","prompt":"Pull the full structured data from this Amazon listing: https://www.amazon.com/dp/B08N5WRWNW — I need the title, current price, ratings, Prime status, and bullet point descriptions for the US marketplace."},{"title":"Amazon search results scraping","prompt":"Scrape the Amazon search results page at https://www.amazon.com/s?k=wireless+headphones for the US and give me a list of all the products shown, including their prices and ratings."},{"title":"Amazon seller profile lookup","prompt":"Get me the seller profile data from this Amazon seller page: https://www.amazon.com/sp?seller=A1D09S7Q0OD6TH — I want to know their name, ratings, and any info shown on their storefront."}],"resultDescription":"A structured JSON object containing a page_type field indicating what kind of Amazon page was detected, plus the relevant parsed data for that type: product details (ASIN, title, price, ratings, Prime eligibility, photos, about bullets, top reviews, sales volume), search/category results (list of products), deals, best sellers, seller profile, or seller products. Optionally includes the raw HTML of the page.","failureModes":["Invalid or non-Amazon URL returns an error or unknown page_type","Unsupported country/delivery_country combination returns a 400 error","Geographically restricted pages may return incomplete data","Amazon anti-bot measures may cause occasional failures or incomplete results","Truncated responses if the page has many products or reviews","Rate limits or payment issues returning 402 or 429 errors"],"whenToPreferThis":"Use this endpoint when you have a specific Amazon URL and need structured, parsed data from it without knowing the page type in advance. It is ideal for flexible Amazon scraping workflows where the page type varies — product, search, seller, deals, best sellers — and you want a single endpoint to handle all cases. Prefer this over ASIN-specific or category-specific endpoints when the URL is already known or user-provided.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:10.168Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-amazon-scrape-by-url-4f119977"}