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

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())

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();

<?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);

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))
}

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);
        }
    }
}

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();
    }
}

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

PreviousBest Sellers NextQuestions & Answers

Last updated 8 months ago

Was this helpful?

Good afternoon

Request samples

Request parameter values

Generic

Localization

Pagination and sorting

Sorting behavior

Content limitations

Code example

Structured data

Data dictionary

HTML Sample

JSON structure

Reviews