docs / newegg

Newegg Electronics API

base /newegg/v112 endpoints

post/newegg/v1/search1 credit

keyword product search with page pagination; optional sort and N-value filter

Parameter		Allowed / range	Description
query	required	—	Search keyword.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.
sort	optional	—	Sort order (Newegg 'Order' value). Discover valid values from the filters action's sort_options.
n_value	optional	—	Newegg 'N' facet filter value (from the filters action).
min_price	optional	—	Minimum price (USD).
max_price	optional	—	Maximum price (USD).

Try in playground →

post/newegg/v1/product1 credit

full product detail (price/brand/specs/images/rating) by item_id or url

Parameter		Allowed / range	Description
item_id	optional	—	Newegg item id (the N82E... code in a /p/ URL).
url	optional	—	Full Newegg product URL (overrides item_id when both are given).

Try in playground →

post/newegg/v1/reviews1 credit

Customer reviews for a Newegg product — returns rating, title, review text, author, and verified-purchase status (~8 reviews per page; total count included)

Parameter		Allowed / range	Description
item_id	required	—	Newegg item id (the N82E... code in a /p/ URL).
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.
url	optional	—	Full Newegg product URL (overrides item_id when both are given).

Try in playground →

post/newegg/v1/qna1 credit

product Q&A questions and answers from PDP initial state

Parameter		Allowed / range	Description
item_id	required	—	Newegg item id (the N82E... code in a /p/ URL).
url	optional	—	Full Newegg product URL (overrides item_id when both are given).

Try in playground →

post/newegg/v1/category1 credit

browse subcategory listing by subcategory_id (+ optional slug path), paginated

Parameter		Allowed / range	Description
subcategory_id	required	—	Newegg subcategory id (from categories / category_tree).
subcategory_slug	optional	—	Optional category slug for a cleaner URL.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/newegg/v1/browse1 credit

alias of category

Parameter		Allowed / range	Description
subcategory_id	required	—	Newegg subcategory id (alias of the category action).
subcategory_slug	optional	—	Optional category slug.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/newegg/v1/deals1 credit

Shell Shocker daily deal items

Parameter		Allowed / range	Description
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/newegg/v1/categories1 credit

top-level store/category nodes from homepage RolloverMenu

Try in playground →

post/newegg/v1/filters1 credit

search facets, department navigation, and sort options for a query

Parameter		Allowed / range	Description
query	required	—	Keyword to get facets/sort options for.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.

Try in playground →

post/newegg/v1/similar1 credit

related product cards from a product detail page

Parameter		Allowed / range	Description
item_id	required	—	Newegg item id (the N82E... code in a /p/ URL).
url	optional	—	Full Newegg product URL (overrides item_id when both are given).
limit = 12	optional	1–36	Max related items (1-36, default 12).

Try in playground →

post/newegg/v1/category_tree1 credit

nested category navigation tree from a Newegg store landing page

Parameter		Allowed / range	Description
store_id = 1	optional	—	Newegg store id (default 1; from the categories action).
store_slug	optional	—	Optional store slug for the landing page.

Try in playground →

post/newegg/v1/variants1 credit

product family/variant nodes from PDP FamilyTree and related state

Parameter		Allowed / range	Description
item_id	required	—	Newegg item id (the N82E... code in a /p/ URL).
url	optional	—	Full Newegg product URL (overrides item_id when both are given).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/newegg/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"ssd"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}