Reviews

The amazon_reviews data source is designed to retrieve Amazon product review pages of an ASIN of your choice. To see the response example with retrieved data, download this sample output file in HTML format or check structured data output here.

Explore output data dictionary for Reviews, offering a brief description, screenshot, parsed JSON code snippet, and a table defining each parsed field. Navigate through the details using the right-side navigation or scrolling down the page.

Request samples

In the code examples below, we make a request to retrieve product reviews for ASIN B08238V32L on amazon.nl marketplace.

cURL

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "amazon_reviews", 
        "domain": "nl", 
        "query": "B08238V32L",
        "parse": true
    }'

Python

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'amazon_reviews',
    'domain': 'nl',
    'query': 'B08238V32L',
    'parse': True,
}


# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

Node.js

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "amazon_reviews",
    domain: "nl",
    query: "B08238V32L",
    parse: true,
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();

HTTP

https://realtime.oxylabs.io/v1/queries?source=amazon_reviews&domain=nl&query=B08238V32L&parse=true&access_token=12345abcde

PHP

<?php

$params = array(
    'source' => 'amazon_reviews',
    'domain' => 'nl',
    'query' => 'B08238V32L',
    'parse' => true
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");

$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

Golang

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	payload := map[string]interface{}{
		"source": "amazon_reviews",
		"domain": "nl",
		"query":  "B08238V32L",
		"parse":  true,
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

C#

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "amazon_reviews",
                domain = "nl",
                query = "B08238V32L",
                parse = true
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

Java

package org.example;

import okhttp3.*;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "amazon_reviews");
        jsonObject.put("domain", "nl");
        jsonObject.put("query", "B08238V32L");
        jsonObject.put("parse", true);

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

JSON

{
    "source": "amazon_reviews", 
    "domain": "nl", 
    "query": "B08238V32L",
    "parse": true
}

We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.

Request parameter values

Generic

Basic setup and customization options for scraping Amazon product review pages.

Parameter	Description	Default Value
source	Sets the scraper.	amazon_reviews
query	10-symbol ASIN code.	-
render	Enables JavaScript rendering when set to html. More info.	-
parse	Returns parsed data when set to true. Explore output data dictionary.	false
callback_url	URL to your callback endpoint. More info.	-
user_agent_type	Device type and browser. The full list can be found here.	desktop

- mandatory parameter

Localization

Adapt results to specific geographical locations, domains, and languages.

Parameter	Description	Default Value
geo_location	The Deliver to location. See our guide to using this parameter here.	-
domain	Domain localization for Amazon. The full list of available domains can be found here.	com
locale	Accept-Language header value, which sets the interface language of the Amazon page. More info.	-

IMPORTANT: On most page types, Amazon tailors the returned results based on the delivery location of their customers. Therefore, we advise using the geo_location parameter to set your preferred delivery location. You can read more about using geo_location with Amazon here.

Pagination and sorting

Controls for managing the pagination, retrieval, and sorting of search results.

Parameter	Description	Default Value
start_page	Starting page number.	1
pages	Number of pages to retrieve.	1
context: sort_by	Sort reviews by top, recent or helpful.	recent

Sorting behavior

• Top: high-value reviews, no pagination support;

• Helpful: similar to top with pagination support;

• Recent: default, chronological order with pagination.

Content limitations

• 8 reviews per API page (vs. 10 in Amazon's UI);

• The response includes only pages with actual reviews. For example, if you request 5 pages, but only 10 reviews exist, the response will consist of only pages 1 and 2

Code example

{
    "source": "amazon_reviews",
    "query": "B07MLFBJG3",
    "pages": 5,
    "context": [
        {
            "key": "sort_by",
            "value": "helpful"
        }
    ]
}

Structured data

Below you can find a structured output example for amazon_reviews.

amazon_reviews structured output

{
    "results": [
        {
            "content": {
                "url": "https://www.amazon.com/product-reviews/B07VGRJDFY?reviewerType=all_reviews&pageNumber=1",
                "asin": "B07VGRJDFY",
                "page": 1,
                "pages": 1,
                "reviews": [
                    {
                        "id": "R207LFMJD00CZD",
                        "title": "Reselling at higher prices",
                        "author": "Tsumni",
                        "rating": 1,
                        "content": "Mass buying and reselling at high prices should be frowned upon",
                        "timestamp": "Reviewed in the United States March 15, 2020",
                        "is_verified": false,
                        "product_attributes": "Style: ConsoleColor: Green and Blue"
                    },
                    {
                        "id": "R2EMKIO40ML7X4",
                        "title": "Dont waste your money",
                        "author": "Amazon Customer",
                        "rating": 1,
                        "content": "Way overpriced. Joycons are flimsy. Standard Switch is $300 and yet it can only be bought for $500. Nintendo get your act together.",
                        "timestamp": "Reviewed in the United States March 14, 2020",
                        "is_verified": false,
                        "product_attributes": "Style: ConsoleColor: Green and Blue"
                    },
                    {
                        "id": "R2QMXWW8UO9S4J",
                        "title": "Gross",
                        "author": "Leticia Perez",
                        "rating": 1,
                        "content": "The price is disgusting!",
                        "timestamp": "Reviewed in the United States March 15, 2020",
                        "is_verified": false,
                        "product_attributes": "Style: ConsoleColor: Green and Blue"
                    },
                    {
                        "id": "R1GC2P7OQBVZ2H",
                        "title": "Good Console at $299. Junk at This Price Gouge",
                        "author": "DNA B",
                        "rating": 1,
                        "content": "I like the Switch Console and even with its quirks, at $299 it's fairly priced and hopefully will be again when the demand goes down. It's nowhere nearly as powerful as what Playstation and Xbox offer but it's so much more flexible that it can get away with a $300 price tag. $450 though? No, not worth it at all.",
                        "timestamp": "Reviewed in the United States April 3, 2020",
                        "is_verified": false,
                        "product_attributes": "Style: ConsoleColor: Gray"
                    },
                    {
                        "id": "R14GJM67DWKWGF",
                        "title": "I got price gouged",
                        "author": "robert a acord",
                        "rating": 1,
                        "content": "The Nintendo is cool and all but I got price gouged hard on it. I promised my kid one for Quarantine. Apparently people have been buying them out to resell on ebay and Amazon. I am one of those victims.",
                        "timestamp": "Reviewed in the United States April 9, 2020",
                        "is_verified": true,
                        "product_attributes": "Style: ConsoleColor: Gray"
                    },
                    {
                        "id": "R2TR8S17J2RSUC",
                        "title": "The device is great. The everything else is not.",
                        "author": "DWBelfils",
                        "rating": 2,
                        "content": "Everything about the physical device, i feel like is pretty well made. Good set up, some minor future issues that are mitigated by screen protectors and similar. Several easy to work with ways to play it, kinda fun in its novelties on its build.My issue?1) games are ridiculously expensive. So many are over priced.2) Online play required by Nintendo for a not good service is poor. Especially for things like minecraft.3) Where are any older games. The games that Nintendo has no need to keep out of the store. The old pokemon, Zelda games, or any games really. Like, great you are putting witcher 3 on there...But not Orignal Zelda and Ocherina of time?Physical? Great! Nintendo online and games? Bad. 1 or 2 games does not make the switch worth buying. PC has better prices, easier to work with, and you can play almost any game out there.",
                        "timestamp": "Reviewed in the United States August 23, 2019",
                        "is_verified": true,
                        "product_attributes": "Style: ConsoleColor: Gray"
                    },
                    {
                        "id": "RZ1W473GBJETH",
                        "title": "Love the Switch - A Casual Gamer's Best Console",
                        "author": "Sherlockian",
                        "rating": 5,
                        "content": "This is my review of the 'V2' (2019) version of the Nintendo Switch (model #HAC-001(-01)).So a little background, I was a enthusiastic PC gamer in college who built my own PCs for the purpose and am now - due to the demands of adulthood - someone who only plays the occasional game. My last handheld Nintendo console was the black and white Game Boy Pocket in the early 90's, so I've been away from the platform ---- a while.I bought the Switch purely because I learned they had ported Skyrim to it, and as a huge fan of the Elder Scrolls genre I was hoping to devote some of my train commute to questing around Tamriel. In this sense, the Switch does not disappoint. I am not a graphics connoisseur, but - compared to the PC version - Skryim plays really well on the Switch. No perceptible lag, colors are crisp. Yes, it's missing the expansions and yes, the text can be a little small, but that's a fair trade-off for the portability this platform brings.So far, I only own 2 games - Skyrim and MarioKart 8 (another throwback to my college dorm days on the N64), and I love playing both on the Switch, MaroKart is obviously the newer game and so the graphics and gameplay are much better but I'm a still a sucker for Skyrim (at least until the next ES is released, hopefully in my lifetime).Anyway, all this to say the Nintendo Switch is a great console for busy adults who want to reminisce about the fun they had 10, 20, or even 30 years ago. The Switch doesn't take itself too seriously (which I love) but that means it might not be the right choice for people concerned with the perfect graphic or gameplay experience - there are dedicated consoles that do this much better. What the Switch does is make gaming on the go effortless, fun for the average busy person and something you can really enjoy with your whole family - which I think was Nintendo's real goal here all along.",
                        "timestamp": "Reviewed in the United States September 6, 2019",
                        "is_verified": true,
                        "product_attributes": "Style: ConsoleColor: Gray"
                    },
                    {
                        "id": "RZHLHOZG9QKHF",
                        "title": "Disappointing",
                        "author": "zoconnies",
                        "rating": 1,
                        "content": "Wow how disappointing dont buy this until they get this improved, older version of this is better in my opinion. The newer version gave me 8+ crashes of system and game crashes leading up to finally unable to play this system having to return this system ,what a horrible experience this was. Being a big Nintendo switch player what a great disappointment this was. Hopefully they improve this newer version system to where this does not happen again or to someone else.",
                        "timestamp": "Reviewed in the United States September 7, 2019",
                        "is_verified": true,
                        "product_attributes": "Style: ConsoleColor: Gray"
                    },
                    {
                        "id": "R3MVQRLB73SMCS",
                        "title": "Great buy!",
                        "author": "Pedro Sarmiento",
                        "rating": 5,
                        "content": "Good Seller, Console came with everything as specified on description. I'll upload some pictures so you can see the box and hardware quality.",
                        "timestamp": "Reviewed in the United States August 23, 2019",
                        "is_verified": true,
                        "product_attributes": "Style: ConsoleColor: Gray"
                    },
                    {
                        "id": "RO3U8SKQMVYOO",
                        "title": "(New) Nintendo Switch HAC-001(-01)",
                        "author": "Sam Lilly",
                        "rating": 5,
                        "content": "This revised model of the Switch comes with a number of features that I honestly can't fully appreciate as someone who didn't own the previous model. The big thing that drew me in was the extended battery life, even though so far I haven't played much in handheld mode and not at all in tabletop, but they use the same amount of battery either way I would imagine. The reason I'm giving this system five stars probably say more about how good it is than anything else. But I pretty much expected as much. I'm sure by now you can go online and find more detailed reviews for the gaming system, but in case you're wondering here, this one comes with the system, two gray joycons, two attachments to turn each joycon into its own controller, a base to connect both joycons into the formation of a singular controller, the required cables, and the Switch dock. So you'll probably want to buy a few things alongside this such as an SD card for reasonable storage space, a pro controller for a more standard controller experience, maybe a dock sleeve to prevent the possibility of scratching the screen from insertion and ejection of the system, an online pass if you plan to play any games with online features... just basically a lot of things that would be nice if they came with the system itself. This will inflate the price further, but the thing here is that this is going to replace the old models of the Switch and simply make this the main one manufactured now. So... basically, if you want a cheaper Switch you'll want to get a Switch Lite and this one will still cost about 300 bucks like the 2.5+ year-old original variant still costs. That is, unless you want to go used. I'm only bringing up these points because while this is a great system, I do think you should be aware of what is likely to happen with prices and availability going forward and plan accordingly. Once I realize a Switch was still going to cost the same if I wanted the ability to do on and off TV play I decided I might as well just hop on board with this newer variant. I'd recommend you do the same as it has had tweaks to make it just a slightly better version all around than the previous model. Otherwise, if price is a concern, wait for the Switch Lite and see how it tickles your fancy. Also, here's tip. If you want to turn the system off as opposed to leaving it in sleep mode, simply hold down the power button on the system for a few seconds and then a menu will appear with the option to restart or shut down. Also note that you cannot play on the TV off of the Switch's battery power. The dock needs to be plugged in for the dock to function. I hope something in here was helpful.",
                        "timestamp": "Reviewed in the United States September 15, 2019",
                        "is_verified": true,
                        "product_attributes": "Style: ConsoleColor: Gray"
                    }
                ],
                "page_type": "Question",
                "asin_in_url": "B07VGRJDFY",
                "product_name": "Nintendo Switch with Neon Blue and Neon Red Joy‑Con - HAC-001(-01)",
                "parse_status_code": 12000
            },
            "created_at": "2022-05-09 06:56:49",
            "updated_at": "2022-05-09 06:56:52",
            "page": 1,
            "url": "https://www.amazon.com/product-reviews/B07VGRJDFY?reviewerType=all_reviews&pageNumber=1",
            "job_id": "6929323275730300929",
            "status_code": 200,
            "parser_type": ""
        }
    ]
}

Data dictionary

HTML Sample

JSON structure

The amazon_reviews provides a collection of user-generated reviews for a specific product listed on Amazon. The table below presents a detailed list of each field we parse, along with its description and data type. The table also includes some metadata.

Key	Description	Type
url	The URL of the Amazon reviews page for a selected product.	string
asin	Amazon Standard Identification Number.	string
page	The current page number.	integer
pages	Number of pages to retrieve.	integer
reviews	A list of reviews with their respective details.	array
page_type	The type of the Amazon page.	string
asin_in_url	Amazon Standard Identification Number retrieved from the URL.	string
product_name	The name of the Amazon product.	string
parse_status_code	The status code of the parsing job. You can see the parser status codes described here.	integer
created_at	The timestamp when the scraping job was created.	timestamp
update_at	The timestamp when the scraping job was finished.	timestamp
job_id	The ID of the job associated with the scraping job.	string
status_code	The status code of the scraping job. You can see the scraper status codes described here.	integer
parser_type	The type of parser used for parsing the data.	string

In the following sections, parsed JSON code snippets are shortened where more than one item for the result type is available.

Reviews

reviews contains multiple reviews submitted by users for a particular product, each with its own details such as title, author, rating, content, timestamp, and verification status. Additionally, each review may include product attributes.

...
"reviews": [
    {
        "id": "R24D8CAAD3AQM9",
        "title": "5.0 out of 5 stars Great gaming system, but the Asurion plan isn't worth buying",
        "author": "shirley campbell",
        "rating": 5,
        "content": "My grandson loves it! Worked like a charm for a year and half until the battery stopped holding a charge. I purchased the Asurion protection plan because it said it would cover all malfunctions. However, when I tried to submit a claim, it said it wasn't covered. So, the gaming system is worth buying, but don't waste your money on the protection plan. (Game Stop's protection plan is way better!)",
        "timestamp": "Reviewed in the United States December 10, 2023",
        "profile_id": "AF3CF2THPLBI23VSYV7EJOPO4SOA",
        "is_verified": true,
        "helpful_count": 3,
        "product_attributes": ""
    },
]
...

Key (reviews)	Description	Type
id	An alphanumeric identification for the Amazon Review.	string
title	The rating and the title of the review.	string
author	The user by whom the review has been submitted.	string
rating	The star rating assigned when submitting the review.	integer
content	The content of the review.	string
timestamp	Identifies when the review has been submitted.	timestamp
profile_id	An identification number assigned to the user who left the review.	string
is_verified	Identifies whether the user has bought the product via Amazon marketplace.	boolean
helpful_count	Number of helpful votes received for the review.	integer
product_attributes	Identifies the characteristics of the product.	string