JUjustoneapi
JD.com

Product Search

Changed on

Search JD.com products by keyword, including products in advertising placements, with category filtering, pagination, sorting and price-range filters. Use it to research sponsored product visibility and discover products within a selected category.

get/api/jd/search-item-list/v3

Request

  • Base URL
    https://api.justoneapi.com
  • Auth
    none declared

Query parameters

tokenstring required

Access token for this API service.

keywordstring required

Search keyword. Required even when a category is selected.

cidstring

Numeric category ID used to filter the search results.

cidLevel'1' | '2' | '3'

JD.com category ID level

Category ID level: 1 for a first-level category, 2 for a second-level category, or 3 for a third-level category.

Available Values:

  • 1: First-level category
  • 2: Second-level category
  • 3: Third-level category
pagestring

Page number, starting at 1.

sort'0' | '1' | '2' | '3' | '6'

JD.com product search sort order

Sort order for the search results.

Available Values:

  • 0: Comprehensive sorting
  • 1: Sort by sales volume
  • 2: Price, highest first
  • 3: Price, lowest first
  • 6: Sort by comments
priceIntervalstring

Price range in minimum-maximum format, for example 0-100. Both values must be non-negative and the minimum must not exceed the maximum.

brandstring

Brand name, for example iQOO or iPhone.

Response

OK

code0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602 required
messagestring nullable required
dataunknown required
recordTimestring nullable required
requestIdstring
reasonstring

Changes