Piloterr

Newegg Search

GET
/v2/newegg/search

Search Newegg by keyword or search URL. Returns item numbers, dollar prices, stock, and pagination.

Credit cost: 2 credits per call

Autorización

ApiKeyAuth
headerx-api-key<token>

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

Parámetros de consulta

query*string

Keyword or a newegg.com search URL.

Examples:

logitech keyboard
https://www.newegg.com/p/pl?d=logitech+keyboard
page?number

Page number, starting at 1. Example: 2.

return_page_source?boolean

When true, return the raw HTML. The string false stays false.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Cuerpo de la respuesta

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/newegg/search?query=string'
Example Response
{  "results": [    {      "url": "https://www.newegg.com/logitech-mk320-920-002836-usb-rf-wireless/p/N82E16823126188",      "brand": "Logitech",      "price": 36.99,      "title": "Logitech MK320 Wireless Desktop Keyboard and Mouse Combo",      "rating": 3.7,      "currency": "USD",      "in_stock": true,      "product_id": "N82E16823126188",      "item_number": "23-126-188",      "review_count": 289,      "price_display": "$36.99"    }  ],  "pagination": {    "next": "https://www.newegg.com/p/pl?d=logitech+keyboard&page=2",    "page": 1,    "keyword": "logitech keyboard",    "per_page": 44,    "total_pages": 20,    "total_results": 1529  }}