ScrapeIN Amazon Search API Response Description
When making a request with the /search endpoint, ScrapeIN returns results from the search results page on the specified Amazon domain, which can be determined by either the asin and amazon_domain parameters or the url parameter.
ScrapeIN retrieves results from the search results page on Amazon with the following properties:
JSON Example
{
"request_parameters" : {},
"request_metadata" : {},
"search_results" : [
{
"position" : 1,
"title" : "Samsung Galaxy S10e, 128GB, Prism Black - Unlocked (Renewed)",
"asin" : "B082T4F34B",
"link" : "https://www.amazon.com/Samsung-Galaxy-128GB-Prism-Black/dp/B082T4F34B/ref=sr_1_1?keywords=android+phone&qid=1687952322&sr=8-1",
"availability" : {
"raw" : "Only 1 left in stock - order soon."
},
"categories" : [
{
"name" : "All Departments",
"id" : "aps"
}
],
"image" : "https://m.media-amazon.com/images/I/71bK3oKRCOL._AC_UY218_.jpg",
"rating" : 4.3,
"ratings_total" : 12766,
"prices" : [
{
"symbol" : "$",
"value" : 129.5,
"currency" : "USD",
"raw" : "$129.50",
"asin" : "B082T4F34B",
"link" : "https://www.amazon.com/Samsung-Galaxy-128GB-Prism-Black/dp/B082T4F34B/ref=sr_1_1?keywords=android+phone&qid=1687952322&sr=8-1"
}
],
"price" : {
"symbol" : "$",
"value" : 129.5,
"currency" : "USD",
"raw" : "$129.50",
"asin" : "B082T4F34B",
"link" : "https://www.amazon.com/Samsung-Galaxy-128GB-Prism-Black/dp/B082T4F34B/ref=sr_1_1?keywords=android+phone&qid=1687952322&sr=8-1"
}
},
{
"position" : 2,
"title" : "Moto G 5G | 2022 | 2-Day Battery | Unlocked | Made for US by Motorola | 6/256GB | 50 MP Camera | Moonlight Gray",
"asin" : "B09TZ5ZBJT",
"link" : "https://www.amazon.com/Battery-Unlocked-Motorola-Camera-Moonlight/dp/B09TZ5ZBJT/ref=sr_1_2?keywords=android+phone&qid=1687952322&sr=8-2",
"categories" : [
{
"name" : "All Departments",
"id" : "aps"
}
],
"image" : "https://m.media-amazon.com/images/I/61VnjlIm+zL._AC_UY218_.jpg",
"is_prime" : true,
"rating" : 4.3,
"ratings_total" : 588,
"prices" : [
{
"symbol" : "$",
"value" : 199.99,
"currency" : "USD",
"raw" : "$199.99",
"name" : "Primary",
"is_primary" : true
},
{
"symbol" : "$",
"value" : 399.99,
"currency" : "USD",
"raw" : "$399.99",
"name" : "Original",
"is_rrp" : true
}
],
"price" : {
"symbol" : "$",
"value" : 199.99,
"currency" : "USD",
"raw" : "$199.99",
"name" : "Primary",
"is_primary" : true
}
}
],
"category_information" : {
"is_landing_page" : false
},
"related_searches" : [
{
"query" : "android phone unlocked",
"link" : "https://www.amazon.com/s/?k=android+phone+unlocked&ref=sugsr_0&pd_rd_w=fOD8Y&content-id=amzn1.sym.1b55e175-aab2-4228-be7e-b2330901df8b:amzn1.sym.1b55e175-aab2-4228-be7e-b2330901df8b&pf_rd_p=1b55e175-aab2-4228-be7e-b2330901df8b&pf_rd_r=VASC402JC0ENJJ48PMW3&pd_rd_wg=UP6zP&pd_rd_r=3f8130e0-f790-4a08-862f-3cb7f1ee1853&qid=1687952322"
},
{
"query" : "iphone",
"link" : "https://www.amazon.com/s/?k=iphone&ref=sugsr_3&pd_rd_w=fOD8Y&content-id=amzn1.sym.1b55e175-aab2-4228-be7e-b2330901df8b:amzn1.sym.1b55e175-aab2-4228-be7e-b2330901df8b&pf_rd_p=1b55e175-aab2-4228-be7e-b2330901df8b&pf_rd_r=VASC402JC0ENJJ48PMW3&pd_rd_wg=UP6zP&pd_rd_r=3f8130e0-f790-4a08-862f-3cb7f1ee1853&qid=1687952322"
}
],
"related_brands" : [
{
"image" : "https://m.media-amazon.com/images/S/al-na-9d5791cf-3faf/672fa057-73da-4685-97fd-2ef45c1ba39e._CR0,0,1200,628_SX460_QL70_.jpg"
},
{
"image" : "https://m.media-amazon.com/images/S/al-na-9d5791cf-3faf/685aa1b6-2683-4e8c-b865-01b5f7ca1caa._CR0,0,1200,628_SX460_QL70_.jpg"
}
],
"pagination" : {
"total_results" : 4000,
"current_page" : 1,
"next_page_link" : "https://www.amazon.com/s?k=android+phone&page=2&qid=1687952322&ref=sr_pg_2",
"total_pages" : 20
},
"refinements" : {
"prime" : [
{
"name" : "Free Shipping by Amazon",
"value" : "n:2335752011||p_76/2491146011",
"link" : "https://www.amazon.com/s?k=android+phone&rh=n%3A2335752011%2Cp_76%3A2491146011&dc&qid=1687952322&rnid=2491144011&ref=sr_nr_p_76_1&ds=v1%3Awf2JUNs%2BO4ZrVgdv8s5YE4zjOlyC0DzN5yKLO3T29VY",
"refinement_display_name" : "Prime"
}
],
"delivery" : [
{
"name" : "Get It by Tomorrow",
"value" : "p_90/8308921011",
"link" : "https://www.amazon.com/s?k=android+phone&rh=p_90%3A8308921011&dc&qid=1687952322&rnid=8308919011&ref=sr_nr_p_90_1&ds=v1%3AXcm5C3IMS%2BNVTHf9a7rzs2fXAFiMF9XjF2FKdZDAILg",
"refinement_display_name" : "Delivery"
}
]
},
"video_blocks" : [
{
"video_link" : "https://m.media-amazon.com/images/S/al-na-9d5791cf-3faf/1167c146-5b6a-4be3-91a2-5685c29f8ac7.mp4/productVideoOptimized.mp4",
"thumbnail_link" : "https://d1f0esyb34c1g2.cloudfront.net/transcode/AssetLibrary/AssetLibrary/amzn1.assetlibrary.asset1.9e5fa6b1df450514c4fac0ed5bfc0eb9:version_v1/3be0c049-987f-4ef0-a29a-082d7ef37628/1674769309044_THUMBNAIL-360P-FRAME-3-CAPTURE-2.0000001.jpg",
"campaign_id" : "200029137695598",
"advertiser_id" : "151099998202"
},
{
"video_link" : "https://m.media-amazon.com/images/S/al-na-9d5791cf-3faf/45528e11-d176-4d73-a7f0-ced7c4005957.mp4/productVideoOptimized.mp4",
"thumbnail_link" : "https://m.media-amazon.com/images/S/al-na-9d5791cf-3faf/45528e11-d176-4d73-a7f0-ced7c4005957.mp4/r/THUMBNAIL_1080P_FRAME_3_CAPTURE_2.JPG",
"campaign_id" : "200031845644098",
"advertiser_id" : "107561342502",
"has_audio" : true
}
]
}
JSON Structure
The JSON structure returned by the Amazon API includes required elements, such as request_parameters, request_metadata, pagination, as described in the Results Amazon Data API section, as well as those specific to Amazon search queries, which are described below.
search_results
When retrieving Amazon Search data, the array provides information about individual product listings that match the search query. Here's a breakdown of the parameters within the example you provided:
position: Indicates the position or ranking of the product listing within the search results. For example, it is "1," meaning the product appears as the top result.title: Represents the title or name of the product listing.brand: Indicates the product brand. It specifies the brand name associated with the product if it is provided separately from the title. This property may not be available for all products.is_prime: Determines whether the product is Prime-eligible or not.kindle_unlimited: Boolean set to true when the "Kindle Unlimited" badge was shown next to the search result.prime_video: Determines whether the product is an Amazon Prime Video product or not.is_amazon_brand: Set to true when the "Amazon Brand" banner is shown next to the search result.is_exclusive_to_amazon: Set to true when the "Exclusive to Amazon" banner is shown next to the search result.is_small_business: Set to true when the "Small Business" banner is shown next to the search result.is_amazon_fresh: Determines whether the product is an Amazon Fresh product or not.is_whole_foods_market: Determines whether the product is a Whole Foods Market product or not.coupon: An object is present when the "Coupon" badge is shown next to the search result. Contains the following properties:badge_text: The text shown inside the coupon badge (i.e., "Save 5%").text: The text shown next to the coupon badge (i.e., "with coupon").
profile: An object contains information about the author or content provider of the shopping advisor's Amazon profile.name: The name of the profile's author.link: A link to the author's Amazon profile.id: The Amazon profile ID of the author or content provider.
article: An object represents an article provided by the author or content provider accompanying the shopping advisor section.title: The title of the article.body: The body text of the article.link: A link to the article.date: The publication date of the article.total: Indicates the total number of product recommendations shown in the shopping advisor section.
asin: A unique identifier assigned to each product on Amazon's platform. Theasinparameter provides the ASIN for the listed product, which helps identify it within Amazon's catalog. For example, the ASIN is "B0BTTVRWPR".link: Contains the URL link to the product's detail page. Clicking on this link directs users to a specific page where they can view additional information about the product, such as pricing, product details, customer reviews, and the option to add it to their cart.categories: An array contains details of the categories shown with the product.name: The name of the category (e.g., "All Departments").id: The ID of the category ("aps")
image: A link to the image of the product.climate_pledge_friendly: An object is present when the "Climate Pledge Friendly" badge is shown next to the search result. Contains the following properties:link: A link to the product landing page showing more detail on the Climate Pledge Friendly messaging.text: The text of the Climate Pledge Friendly certification.image: An image URL to the logo of the Climate Pledge Friendly certification logo if shown.
gift_guide: An object is present when the "Gift Guide" badge is shown next to the search result. Contains the following properties:link: A link to the deal landing page.badge_text: The text shown inside the gift guide badge (i.e., "Holiday gift guide"). Can be useful in determining the "type" of gift guide the search result appears in.
amazons_choice: An object is present when the product page displays the "Amazon's Choice" badge. Has two properties:keywordsandlink.brand_store: An object is present when a link to the product's Brand Store is shown on the product page. It has two properties:idandlink.bestseller: An object is present when the "Bestseller" badge is shown next to the search result. More detailed bestseller information can be retrieved from the product page by utilizing a product request specifying this search results ASIN. Contains the following properties:link: A link to the Bestsellers page to which this bestseller badge relates.category: The category name for which this product is a bestseller, i.e., "LED & LCD TVs".
deal: Deal object is present when the "Deal" badge is shown next to the search result. Contains the following properties:link: A link to the deal landing page.text: It is a string that typically provides a brief description or tagline associated with the deal.badge_text: The text shown inside the deal badge (i.e., "Limited time deal").
rating: The overall rating of the product (out of 5).ratings_total: The total number of customer ratings the product has received.delivery: An object contains delivery information displayed next to the search result.tagline: A string describing the delivery option (e.g., "Get it as soon as Sat, Oct 3").price: An object represents the price and currency of the delivery option (same properties as the price objects in the prices array).
is_carousel: Indicates if the search result is part of a carousel (horizontally scrolling row of search results).carousel: An object contains details of the carousel that the search result is part of.title: The title of the carousel (e.g., "Highly Rated").sub_title: The subtitle of the carousel (e.g., "Based on the star rating and a number of customer ratings").sponsored: Indicates if the carousel is sponsored.id: The ID of the carousel.total_items: The total number of items in the carousel.
sponsored: Set totrueorfalsedepending on whether the search result is a sponsored listing or not.featured_from_our_brands: Set totruewhen the product is flagged as "Featured from our Brands", omitted otherwise.authors: The array property contains the authors or artists of the product. Mainly applies to books, music, and video products. It has the following properties:name: The name of the author or artist.link: The link to the author or artist on the Amazon domain if present.
narrated_by: An array contains the narrators of the product (applies to Audible Amazon Domains).name: The name of the narrator.link: The link to the narrator on the Audible Amazon domain, if available.
runtime: An object contains the runtime of the podcast (applies to Audible Amazon Domains).raw: The raw runtime as displayed on the Audible domain.
add_on_item: The presence of the add-on item object indicates that the item is included in Amazon's "add-on item" program. If the product is not an add-on item, this property will be omitted.is_add_on_item: Indicates whether the product is an add-on item (true/false).
availability: An object contains availability information displayed next to the search result.raw: The raw availability text, such as "Only 1 left in stock - order soon".
prices: An array contains details about the pricing of the product shown under the product title. An array of price objects has the following properties:symbol: The currency symbol, i.e.,$for USD.value: The price of the offer.currency: The currency of the offer as an ISO 4217 currency code ("USD").raw: The raw price as displayed on the offer listing.name: The name of the offer if applicable, for example, "Limited time deal".is_primary: Indicates whether the price is the primary or main price for the product.
price: A price object representing the first item in thepricesarray. This is normally the "main" price for the product and is included as a convenience to make extracting the main price easier.information: The information text, typically shown in bold below the product title and showing the pack quantity.unit_price: The product unit price, where shown.other_formats: An array of objects containingasin,link, andtitleproperties showing the 'other format' links shown next to the search result. Typically found in books or music categories.recent_sales: The product's recent sales, where shown. For example, 200+ were bought in the past week.recent_views: The product's recent views, where shown. For example, 300+ views in the past week.
search information
An object contains details about the current page of search results and has the following properties.
spelling_correction: Displays the corrected spelling suggestion when a misspelledqis entered. You can choose whether to automatically apply the spelling correction by using thedirect_search=truerequest parameter.original_search_term: Shows the spelling correction displayed when a misspelledqis entered.did_you_mean: Shows the "did you mean" spelling correction suggestion when a misspelledqis entered and thedirect_search=truerequest parameter is set.no_results_found: Set totruewhen the search result page displays a banner saying "no results found, showing results from all departments."
related_searches
An array of "related_search" objects that provide information about related searches is displayed at the bottom of the search results page. Each object includes details about a specific related search.
link: The hyperlink leading to the related search results. Clicking on this link will take you to the related search results page.query: The text representing the related search query. This query can be utilized in the future Search requests to retrieve the related search results associated with it.
related_brands
An array that contains objects representing sponsored related brands shown at the bottom of the search results page. Each object within the array has the following parameters:
logo: A link to the brand logo image of the related brand, if shown.image: A link to the product image shown in the related brand, if shown.title: The title text of the related brand.link: The link is shown in the related brand section.store_name: The name of the store of the related brand, if shown ("FIVE STAR").store_id: The ID of the store of the related brand, if shown. It can be used in thestore_idparameter of subsequent store request to retrieve listings from the store ("861405EC-B611-4A8B-A32D-FF6A0862C476").store_link: A link to the store of the related brand, if shown.
pagination
An object containing details of the current search results page and the total number of pages that are available. To paginate, you should specify the page number in the page parameter of your request.
total_results: The total number of results Amazon shows in the header bar. Note that it will not normally be possible to paginate through to very high page numbers; however,total_resultsis useful as an indication of market size.current_page: The current page number.total_pages: The total number of pages available.next_page_link: Provides the URL of the next page of search results, allowing navigation to the next set of results.
refinements
An object contains details of available refinements for search results on Amazon. Refinements help you narrow down your search by applying specific filters like "Reviews" "Prime", "Brand", or "Departments", etc.
Note on Refinements
Refinement values vary depending on the category or search term used. To retrieve a list of available refinements, utilize the
/searchendpoint without specifying any refinements. Then to refine your search, you can specify refinement values (comma-separated) in therefinementsparameter of your request. See for more details.You can then cache these values for future requests.
The object has properties for each available refinement and includes:
name: The full-text name of the refinement (e.g., "Free Shipping by Amazon") for the "Prime" refinement.valueThe value of the refinement ("n:172282||p_76/1249137011").link: A link associated with the refinement. You can use this link in your new request as theurlparameter to navigate to the search results filtered by this refinement.refinement_display_name: The display name of the refinement, for example "Prime". This indicates that the refinement corresponds to products eligible for Prime shipping.
ad_blocks
An array refers to a collection of sponsored advertisements or promotional blocks displayed within the Amazon search results page.
creative_id: The ID of the creative shown in the ad block.campaign_id: Represents the unique identifier for the advertising campaign associated with the ad block ("200029215528498").advertiser_id: Indicates the unique identifier for the advertiser who created the ad block ("200125365775498").ad_id: Represents the unique identifier for the specific ad within the ad block ("200125365775498").brand_logo: A link to the brand logo image of the ad block, if shown.background_image: A link to the background image of the ad block, if shown.creative_type: The name of the type of creative used in the ad block.link: Contains the URL link associated with the ad, which directs users to a specific webpage when clicked.title: Provides the title or headline of the ad, describing the product or service being promoted ("Upgrade Space with Quality Mount").sub_title: The subtitle of the ad block, if shown.date: An date object that contains details about the launch date of an ad block (if shown).raw- A number represents the raw date in Unix EPOCH format.utc- Represents the parsed date from the raw date in ISO 8601 format. If the raw date cannot be parsed, this property will be null.products: An array of objects containing details of the products displayed in the ad block.asin: The ASIN of the product shown.link: The link to the product page of the product.is_prime: Indicates whether the Amazon Prime indicator is displayed next to the product.image: A link to the image representing the product shown in the ad block.title: The title or name of the product.rating: The rating of the product, on a scale of 1 to 5.rating_total: The total number of ratings received by the product shown in the ad block.price: A price object providing details about the price of the product shown in the ad block, if available.
store_link: Contains the URL link to the Amazon store or page associated with the advertised product or service.store_id: Represents the unique identifier for the Amazon store where the advertised product or service is listed ("0672580F-985F-4075-A739-ACAF19C1039C").store_name: Provides the name or title of the Amazon store associated with the ad block ("the Mounting Dream Store on Amazon").
video_blocks
An array of objects that provide information about full-row sponsored video sections are displayed on the search results page. These video blocks typically include a video and a link to one or more related products.
video_link: A link to the video file (usually in MP4 format) that plays within the video block.thumbnail_link: A link to the thumbnail image that is displayed before the video starts playing (usually while the video is buffering).campaign_id: The unique identifier of the campaign to which the video block belongs.advertiser_id: The unique identifier of the advertiser associated with the video block.has_audio: Indicates whether the video includes audio. It is set to true if audio is present.store_name: The name of the advertiser's store, if shown in the video block.store_id: The identifier of the advertiser's store, which can be used in subsequent requests to retrieve listings from the store using the store_id parameter.store_link: A link to the advertiser's store, if shown in the video block.products: An array of objects containing details of the products displayed in the video block.asin: The ASIN (Amazon Standard Identification Number) of the product shown in the video block.link: The link to the product page of the product shown in the video block.is_prime: Indicates whether the Amazon Prime indicator is displayed next to the product in the video block.image: A link to the image representing the product shown in the video block.title: The title or name of the product shown in the video block.rating: The rating of the product shown in the video block, on a scale of 1 to 5.rating_total: The total number of ratings received by the product shown in the video block.price: A price object providing details about the price of the product shown in the video block, if available.
shopping_advisors
An array contains objects with details about sections shown in search results, which provide editorial recommendations and a selection of recommended products.
position: Indicates the position of the shopping advisor within the search results. For example,position=5means the shopping advisor appears after the product atposition=4in the search results.title: Represents the title of the shopping advisor section, such as "Editorial recommendations" or "Highly rated and well-priced products".profile: An object containing information about the author or content provider of the shopping advisor's Amazon profile.name: The name of the profile's author.link: A link to the author's Amazon profile.id: The Amazon profile ID of the author or content provider.
article: An object representing an article provided by the author or content provider accompanying the shopping advisor section.title: The title of the article.body: The body text of the article.link: A link to the article.date: The publication date of the article.total: Indicates the total number of product recommendations shown in the shopping advisor section.
recommendations: An array contains a list of recommended products within the shopping advisor section.position: The position of the recommended product within the shopping advisor.title: A title provided by the author or content provider explaining why the product is recommended, e.g., "Good Value".sub_title: The subtitle of the recommendation, e.g., "Durable Design".body: The description text of the recommendation.product: An object representing the recommended product, with properties similar to objects in the mainsearch_resultsarray (e.g.,title,asin,link,image,price,is_prime,rating, andratings_total).