Newegg US and Canada product search and detail API & Scraper
The Newegg Electronics API returns product data from Newegg as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns products with title, brand, price, list price, rating, review count, image and URL plus pagination, and you can pull a product, reviews, best_sellers, a Q&A, a category, browse, deals and filters. It is built for price intelligence, catalog enrichment and electronics-market analytics that need Newegg data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Newegg item numbers, who is really selling, and three review counts
Newegg prints two different item numbers for the same product and the API returns both. The seller field is how you tell a Newegg-shipped item from a marketplace one, and the review block deliberately reports more than one count instead of picking a favourite. Measured on 2026-08-27 against N82E16814982011, an MSI RTX 5070 Ti, and a 36-row search.
| Field | What it is | Measured value |
|---|---|---|
| item_id | Newegg's native code: N82E168 followed by the digits of product_number | "N82E16814982011" |
| product_number | The same digits hyphenated, as printed on the listing | "14-982-011" |
| gtin | Retail barcode as a digit string, check-digit validated, null when there is none | "824142452837" |
| mpn / model | Manufacturer part number and model | "RTX 5070 Ti 16G FRIEREN EDITION OC" |
| seller | null when Newegg sells the item, an object when a marketplace seller does | null here; {"seller_id": "ABU5", "name": "Nippon Labs", "rating": 4.6, "review_count": 406} on N82E16812356314 |
| shipped_by | Who ships it, as a name | "Newegg", or "Nippon Labs" on the marketplace item above |
| availability / in_stock | "in_stock" or "out_of_stock" plus the matching boolean, and the two always agree | 35 in_stock and 1 out_of_stock across 36 search rows |
| weight / weight_unit / dimensions | Shipping weight in pounds and package size in inches | 6.4 lb, and 23.5 x 10.7 x 4.1 in |
| rating_summary.total_count | Reviews on this exact item | 237 |
| rating_summary.all_variants_count | Reviews pooled across every variant of the product | 392, and rating_distribution.scope reads "all_variants" |
| reviews[].rating | One review's score, an integer 1 to 5 | 5, alongside verified_purchase and helpful_votes |
| meta.sponsored_count | Paid tiles on the 36-row page Newegg served, not in your slice of it | 5, while a max_results=5 call returned 5 organic rows |
list_price is present on search rows and on the product action (1299.99 against a price of 1149.99) but came back null on the lightweight price action, so fetch product when you need the strike-through figure. The category and browse actions return sponsored false on every row, because Newegg sells placement on keyword search rather than on category listings.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/newegg/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "ssd"
}
}{
"ok": true,
"meta": {
"api": "newegg",
"endpoint": "search",
"mode": "live",
"latency_ms": 10834.8,
"record_count": 35,
"bytes": 922233,
"cache_hit": false,
"query": "ssd",
"page": 1,
"page_size": 36,
"has_more": true,
"next_page": 2,
"total": 76691,
"bytes_read": 922233,
"sponsored_count": 6,
"include_sponsored": true,
"charged_credits": 1,
"version": "1.0.0"
},
"data": {
"results": [
{
"item_id": "N82E16820331833",
"sponsored": true,
"title": "Team Group T-FORCE VULCAN Z 2.5\" 1TB SATA III 3D NAND Internal Solid State Drive (SSD) T253TZ001T0C101",
"brand": "Team Group",
"price": 129.99,
"list_price": 129.99,
"currency": "USD",
"rating": 4.4,
"review_count": 541,
"availability": "in_stock",
"in_stock": true,
"weight": 0.1,
"image": "https://c1.neweggimages.com/NeweggImage/ProductImageCompressAll300/20-331-833-01.jpg",
"url": "https://www.newegg.com/team-group-1tb-t-force-vulcan-z-sata/p/N82E16820331833",
"model": "Team Group T-FORCE VULCAN Z T253TZ001T0C101",
"product_number": "20-331-833"
},
{
"item_id": "N82E16820177156",
"sponsored": false,
"title": "PNY CS2241 M.2 2280 500GB PCI-Express 4.0 x4 3D NAND Internal Solid State Drive (SSD) M280CS2241-500-RB",
"brand": "SAMSUNG",
"price": 153.99,
"list_price": 153.99,
"currency": "USD",
"rating": 4.8,
"review_count": 22,
"availability": "in_stock",
"in_stock": true,
"weight": 0.07,
"image": "https://c1.neweggimages.com/NeweggImage/ProductImageCompressAll300/20-177-156-01.jpg",
"url": "https://www.newegg.com/pny-500gb-cs2241/p/N82E16820177156",
"model": "PNY CS2241 M280CS2241-500-RB",
"product_number": "9SIA2W0K1J4415"
},
{
"item_id": "N82E16820147903",
"sponsored": false,
"title": "SAMSUNG SSD 9100 PRO 2TB, PCIe 5.0x4 M.2 2280, Seq. Read Speeds Up to 14,700MB/s, Best for AI Computing, Gaming, and Heavy Duty Workstations (MZ-VAP2T0B/AM)",
"brand": "SAMSUNG",
"price": 399.99,
"list_price": 679.99,
"currency": "USD",
"rating": 4.9,
"review_count": 105,
"availability": "in_stock",
"in_stock": true,
"weight": 0.1,
"image": "https://c1.neweggimages.com/NeweggImage/ProductImageCompressAll300/20-147-903-05.jpg",
"url": "https://www.newegg.com/samsung-2tb-9100-pro-nvme-2-0/p/N82E16820147903",
"model": "SAMSUNG SSD 9100 PRO 2TB, PCIe 5.0x4 M.2 (MZ-VAP2T0B/AM)",
"product_number": "20-147-903"
}
],
"page": 1,
"page_size": 36,
"has_more": true,
"next_page": 2,
"total": 76691
}
}What the Newegg US and Canada product search and detail API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Newegg products by keyword with page pagination, sort (price/best-selling/rating), brand/facet filter, and a price range. Return up to 360 products in one call with `max_results` (36 per page, paged for you); `page` picks where that window starts. Paid placements are flagged `sponsored: true` and can be excluded with `include_sponsored: false` Canada: keyword query, page 1-2, local limit 1-60; source CAD prices. | Pricing teams call search to search Newegg products by keyword with page pagination, sort (price/best-selling/rating), bra…. | query, max_results, page, sort, n_value, ... |
| price | Live price and stock for ONE item — the cheap way to refresh products you already hold, without paying for the whole product page Canada is not qualified for this action; US behaviour is preserved. | Marketplace operators call price to get live price and stock for ONE item. | item_id, url, country |
| product | Full product detail by item_id or url — price, list price, promotion, brand, model, MPN, GTIN/UPC barcode, shipping weight and package dimensions, specifications, bullets, images, rating, stock, and marketplace seller Canada: item_id or Newegg.ca product URL; CAD detail. US remains default. | Catalog enrichment teams call product to get full product detail by item_id or url. | item_id, url, country |
| reviews | Customer reviews for a Newegg product — fully paginated through ALL reviews (20/page) with rating filter and sort, plus a rating distribution summary. Returns rating, title, body, pros/cons, author, verified-purchase, helpful votes, media, and merchant replies Canada is not qualified for this action; US behaviour is preserved. | Retail analysts call reviews to get customer reviews for a Newegg product. | item_id, page, rating, sort, url, ... |
| best_sellers | Top best-selling products for a keyword or category (Newegg's Best Selling sort), paginated. Same `max_results` (up to 300, 36/page) and `include_sponsored` controls as the search action Canada is not qualified for this action; US behaviour is preserved. | Pricing teams call best_sellers to get top best-selling products for a keyword or category (Newegg's Best Selling sort), paginated. | query, n_value, subcategory_id, subcategory_slug, max_results, ... |
| qna | product Q&A questions and answers from PDP initial state Canada is not qualified for this action; US behaviour is preserved. | Marketplace operators call qna to get product Q&A questions and answers from PDP initial state Canada is not qualified for this act…. | item_id, url, country |
| category | Browse a Newegg subcategory's product listing by subcategory_id, paginated. The slug is auto-resolved when omitted (pass subcategory_slug from category_tree to skip the lookup) Canada is not qualified for this action; US behaviour is preserved. | Catalog enrichment teams call category to get browse a Newegg subcategory's product listing by subcategory_id, paginated. | subcategory_id, subcategory_slug, page, country |
| browse | Alias of the category action — browse a subcategory's product listing, paginated Canada is not qualified for this action; US behaviour is preserved. | Retail analysts call browse to get alias of the category action. | subcategory_id, subcategory_slug, page, country |
| deals | Shell Shocker daily deal items Canada is not qualified for this action; US behaviour is preserved. | Pricing teams call deals to get shell Shocker daily deal items Canada is not qualified for this action; US behaviour is prese…. | page, country |
| categories | top-level store/category nodes from homepage RolloverMenu Canada is not qualified for this action; US behaviour is preserved. | Marketplace operators call categories to get top-level store/category nodes from homepage RolloverMenu Canada is not qualified for this ac…. | country |
| filters | search facets, department navigation, and sort options for a query Canada is not qualified for this action; US behaviour is preserved. | Catalog enrichment teams call filters to search facets, department navigation, and sort options for a query Canada is not qualified fo…. | query, page, country |
| similar | related product cards from a product detail page Canada is not qualified for this action; US behaviour is preserved. | Retail analysts call similar to get related product cards from a product detail page Canada is not qualified for this action; US…. | item_id, url, limit, country |
| category_tree | nested category navigation tree from a Newegg store landing page Canada is not qualified for this action; US behaviour is preserved. | Pricing teams call category_tree to get nested category navigation tree from a Newegg store landing page Canada is not qualified for…. | store_id, store_slug, country |
| variants | Product family/variant options from the PDP — size/capacity/colour family members, package bundles, and any combo-deal promotion Canada is not qualified for this action; US behaviour is preserved. | Marketplace operators call variants to get product family/variant options from the PDP. | item_id, url, country |
Call search from your stack
curl -X POST https://api.reefapi.com/newegg/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"ssd"}'import requests
r = requests.post(
"https://api.reefapi.com/newegg/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "ssd"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/newegg/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "ssd"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.newegg.search with {"query":"ssd"}.Who uses this API and why
- Pricing teams call search and deals to track Newegg electronics prices and promotions.
- Catalog-enrichment tools use product to fill listings with specs, images and availability.
- Market analysts use best_sellers and reviews to spot trending, well-rated components.
Questions developers ask before integrating
What is the difference between a Newegg item_id and a product_number?
They are the same identifier written two ways. item_id is the native code Newegg uses in URLs and in its own API, "N82E16814982011". product_number is the human-facing number printed on the listing, "14-982-011", which is the last eight digits of the item_id with hyphens. Every action accepts item_id or a full product URL; product_number is returned so you can match against what Newegg shows on the page.
How do I tell whether Newegg or a marketplace seller is selling an item?
Read seller on the product action. It is null when Newegg sells the item itself and an object when a third party does. N82E16814982011 returned seller null with shipped_by "Newegg", while N82E16812356314 returned seller {"seller_id": "ABU5", "name": "Nippon Labs", "rating": 4.6, "review_count": 406, "url_key": "Nippon-Labs"} with shipped_by "Nippon Labs". The seller_id is a short alphanumeric code and the seller's rating is a 0-5 score separate from the product's.
Why does one product report three different review counts?
Because Newegg pools reviews across variants and the response keeps the numbers apart rather than picking one. On N82E16814982011, rating_summary.total_count was 237 (reviews on this exact item), all_variants_count was 392 (every variant of the product), and rating_distribution carried scope "all_variants" with count 392, so its 5_star through 1_star buckets sum to 392, not 237. The search row for the same item reported review_count 393. Use total_count when you mean this listing.
What is the price action for, and what does it leave out?
It is the cheap refresh. It reads the small live-pricing module rather than the whole product page, so a daily price and stock sweep costs a fraction of a re-fetch. It returns item_id, price, currency, in_stock and stock_flag. It does not carry the strike-through list_price: that came back null on the price action while the product action returned 1299.99 for the same item, so fetch product when you need the discount.
What does availability mean when it is null?
It means Newegg published no stock signal for that row, not that the item is sold out. availability is the string "in_stock", "out_of_stock" or null, in_stock is the matching boolean, and the two always agree, so you can branch on either. Across a 36-row search for 'rtx 5070' the split was 35 in_stock and 1 out_of_stock with no nulls.
Are sponsored listings mixed into Newegg search results?
Yes, and they are flagged. sponsored is true when Newegg was paid for that grid position and false on organic rows, never null, and include_sponsored=false drops them. One thing to watch: meta.sponsored_count counts the whole 36-row page Newegg served, so a call with max_results=5 reported sponsored_count 5 while all five returned rows were organic. The category and browse actions carry no sponsored rows at all.
Can I get what a shipping quote needs?
Yes, from the product action: weight with weight_unit, and dimensions with unit. The RTX 5070 Ti returned 6.4 lb and 23.5 x 10.7 x 4.1 inches, which is the shipping package rather than the card itself. Both are null when the merchant left them unset, and items that never physically ship, such as gift cards and software downloads, still carry Newegg's placeholder figures rather than nothing.
Is the gtin field a real barcode?
Yes, and it is validated before it is returned. gtin is a digit string, 12 digits for a UPC-A or 13 for an EAN-13, such as "824142452837" on that graphics card and "810572028230" on a Nippon Labs cable. It is null when the product has no barcode on Newegg. A merchant's internal id that lands in that field fails the check digit and is dropped rather than handed back as a barcode.
What is the Newegg US and Canada product search and detail API?
Newegg US and Canada product search and detail API is a ReefAPI endpoint group for newegg us and canada product search and detail It returns live JSON through POST requests under /newegg/v1.
Is the Newegg US and Canada product search and detail API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Newegg US and Canada product search and detail calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Newegg US and Canada product search and detail login or account?
No login to Newegg US and Canada product search and detail is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Newegg US and Canada product search and detail data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Newegg US and Canada product search and detail API use?
Newegg US and Canada product search and detail actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Newegg US and Canada product search and detail from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call newegg actions with the same key, credit pool and JSON envelope used by normal REST requests.