Piloterr

Newegg Search

GET
/v2/newegg/search

Newegg Search API: search product listings by keyword or URL on Newegg. Returns prices, ratings, stock flags, marketplace/combo signals and pagination via browser rendering.

Credit cost: 2 credits per call

Autorisierung

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Abfrageparameter

query*string

Search keyword or full Newegg search URL.

Examples:

ryzen 5 9600x
https://www.newegg.com/p/pl?d=ryzen+5+9600x
https://www.newegg.com/p/pl?d=laptops&page=2

Use Newegg Product on any result url or product_id for PDP details.

page?number

1-based page number (default: 1).

Range1 <= value <= 500
return_page_source?boolean

When true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.

Antworttext

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/newegg/search?query=string"
{  "results": [    {      "url": "https://www.newegg.com/amd-ryzen-5-9000-series-ryzen-5-9600x-granite-ridge-socket-am5-desktop-cpu-processor/p/N82E16819113844",      "brand": "AMD",      "model": "100-100001405WOF",      "price": 189.99,      "title": "AMD Ryzen 5 9600X - Ryzen 5 9000 Series Granite Ridge (Zen 5) 6-Core 3.9 GHz - Socket AM5 65W - Radeon Graphics Processor - 100-100001405WOF",      "rating": 4.8,      "currency": "USD",      "in_stock": true,      "is_combo": false,      "image_url": "https://c1.neweggimages.com/ProductImageCompressAll300/19-113-844-05.jpg",      "product_id": "N82E16819113844",      "item_number": "19-113-844",      "availability": "in_stock",      "review_count": 484,      "is_marketplace": false,      "is_refurbished": false,      "original_price": 279,      "promotion_text": "+ $10 off w/ promo code SSF69677, limited offer"    }  ],  "pagination": {    "next": null,    "page": 1,    "keyword": "ryzen 5 9600x",    "per_page": 20,    "total_pages": 1,    "total_results": 8  }}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}