# Newegg Reviews API Documentation

<p><strong>Newegg Reviews API Documentation</strong> Read the customer reviews of one Newegg item. Sort by newest, most helpful, highest rating or lowest rating and filter by star count. Each review has the rating, title, comments, pros, cons, the date as ISO 8601 (Newegg writes times in Pacific time), the author name, helpful votes, verified purchase flag, the seller or maker reply and the number of photos. The summary has the average rating and the count and percent per star. Some items share their reviews with a product group. For them the review list and the summary counts are group-wide and can be higher than the item rating count. An item without reviews returns an empty list and is not billed. Cost: 2 credits per request. Failed requests are not billed. Not affiliated with Newegg.</p>

- **Documentation:** [https://scrappa.co/docs/newegg-api/newegg_reviews](https://scrappa.co/docs/newegg-api/newegg_reviews)
- **API group:** Newegg API
- **Endpoint:** `GET https://scrappa.co/api/newegg/reviews`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `item_number` | string | Yes | Newegg item number as search returns it: 14-137-771, N82E16814137771 or 9SIB3T1KEH4255. |
| `sort` | string | No | helpful (default), newest, highest_rating or lowest_rating. |
| `rating` | integer | No | Only reviews with this star count, 1 to 5. |
| `page` | integer | No | Page number, 1 or higher. |
| `per_page` | integer | No | Reviews per page, 1 to 25. Default 10. |
| `site` | string | No | com (default) or ca. |

## Example response

```json
{
    "data": {
        "site": "com",
        "filters": {
            "sort": "helpful",
            "rating": null
        },
        "reviews": [
            {
                "id": 11701047,
                "cons": "price sucks but the 2020/21 ampere gpus with similar performance are all above (in some cases almost twice) what this costs, and its price will only fall as more time passes. not to mention they all will draw considerably more than 260-270W to get the same performance.",
                "date": "2023-02-14T21:16:42-08:00",
                "pros": "love the design once rgb is turned off. the 16pin adapter is a much more modest look here with 2 pins and not 3/4.\n\nlots of cooling headroom as well when you consider the power draw, this thing will never ever ask for more than 280W in my experience, 100% utilization furmark stress tests average at 275W for me (with some 280W peaks) and in gaming loads temps level out at 66-67\u00b0C, with average power draw closer to 260W than 270W.\n\nthis thing crushed 1440p ultrawide as well: in forspoken & c77 @ uw-1440p with all graphics settings on highest consistently delivered at least 75fps (90fps in forspoken). fans do their job and are never noticeably loud.",
                "title": "Does the Job \ud83d\udc4d\ud83c\udffe",
                "author": "ParaCaspari",
                "rating": 5,
                "comments": "efficient and elegant, generous boost clock on this oc as well @ 2745mhz.",
                "media_count": 0,
                "total_votes": 5,
                "vendor_reply": "Dear Valued Customer,\n\nThank you for sharing your experience with the MSI RTX 4070Ti GAMING X TRIO 12G. Your rating and review is greatly appreciated and we sincerely hope you enjoy your new graphics card! If you ever have any technical questions in regards to the card, please feel free to contact us directly at 1 (626) 271-1004 Monday - Friday 9AM - 6PM Pacific Standard Time.\n\nThank you for choosing MSI!\n\nBest Regards,\nMSI Review Team | usreview@msi.com",
                "helpful_votes": 5,
                "verified_purchase": true
            }
        ],
        "summary": {
            "stars": [
                {
                    "count": 90,
                    "stars": 5,
                    "percent": 81
                },
                {
                    "count": 14,
                    "stars": 4,
                    "percent": 13
                },
                {
                    "count": 3,
                    "stars": 3,
                    "percent": 3
                },
                {
                    "count": 0,
                    "stars": 2,
                    "percent": 0
                },
                {
                    "count": 3,
                    "stars": 1,
                    "percent": 3
                }
            ],
            "total_ratings": 110,
            "average_rating": 4.7
        },
        "pagination": {
            "has_more": true,
            "per_page": 3,
            "total_pages": 16,
            "current_page": 1,
            "total_reviews": 46
        },
        "item_number": "14-137-771"
    },
    "meta": {
        "credits": 2,
        "billable": true,
        "endpoint_family": "reviews"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 503 | Upstream Unavailable | Newegg did not answer or sent a page Scrappa cannot read. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)