The Newegg Search API returns product listings from Newegg. Pass a keyword or a full search URL and receive structured JSON with prices, ratings, stock flags, marketplace/combo signals, and pagination.
Piloterr uses browser rendering and parses embedded window.__initialState__ JSON from the search results page.
Use each result url or product_id with Newegg Product for full PDP data (specs, images, promo codes, seller info).
GET https://api.piloterr.com/v2/newegg/search?query=ryzen+5+9600x
GET https://api.piloterr.com/v2/newegg/search?query=https://www.newegg.com/p/pl?d=ryzen+5+9600x
GET https://api.piloterr.com/v2/newegg/search?query=laptops&page=2
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Keyword or full Newegg search URL (/p/pl?d=…) |
page |
integer |
no |
1-based page number (default: 1) |
return_page_source |
boolean |
no |
Raw HTML as {"result": "..."} (default: false) |
| Format |
Example |
| Keyword |
ryzen 5 9600x → https://www.newegg.com/p/pl?d=ryzen+5+9600x |
| Full URL |
https://www.newegg.com/p/pl?d=ryzen+5+9600x |
| Paginated URL |
https://www.newegg.com/p/pl?d=laptops&page=2 |
| Field |
Type |
Description |
product_id |
string |
N82E168… (Newegg catalog), 9SI… (marketplace), or combo ID |
item_number |
string |
Internal Newegg item number |
title |
string |
Product or combo title |
url |
string |
PDP or combo page URL |
price |
number |
Final price |
original_price |
number |
Strikethrough / MSRP |
currency |
string |
USD on www.newegg.com |
brand |
string | null |
Brand name |
model |
string | null |
Manufacturer model / MPN |
rating |
number | null |
Rating out of 5 |
review_count |
integer | null |
Review count |
image_url |
string | null |
Main thumbnail |
in_stock |
boolean | null |
Raw availability flag |
availability |
string | null |
in_stock / out_of_stock |
promotion_text |
string | null |
Display promo text |
is_combo |
boolean |
Bundle listing |
is_marketplace |
boolean |
Third-party seller (9SI…) |
is_refurbished |
boolean |
Newegg Refreshed (T suffix) |
| Field |
Type |
Description |
page |
integer |
Current page |
per_page |
integer |
Page size (20 default) |
total_results |
integer | null |
Total matches |
total_pages |
integer | null |
Total pages |
next |
string | null |
Next page URL |
keyword |
string |
Search term (d= param) |
- Newegg Search: discover listings by keyword or URL (this endpoint)
- Newegg Product: fetch full PDP JSON from
product_id, item number, or URL
| Code |
Meaning |
400 |
Missing or invalid query |
404 |
Page without __initialState__ or no parseable results |
500 |
Rendering or parsing error |
- Combo deals appear in search results but are not supported by Newegg Product yet.
- Costs 2 credits per call (browser rendering).
- Price monitoring: track Newegg first-party vs marketplace offers
- Catalog discovery: harvest
product_id and URLs at scale
- Promo tracking: capture
promotion_text and discount deltas
