---
title: "Product Search"
method: GET
path: "/api/aliexpress/search-products/v1"
tags: ["AliExpress"]
---

# Product Search

`GET /api/aliexpress/search-products/v1`

## Request

- Base URL: `https://api.justoneapi.com`
- URL: `https://api.justoneapi.com/api/aliexpress/search-products/v1`
- Auth: none declared

Searches AliExpress products with optional query, page, sort, category, brand, location, attribute, price, locale, region, and currency controls. Use it for product discovery, catalog research, and marketplace assortment analysis.

## Query parameters

- `token` string, required
- `q` string
- `page` string
- `sort` 'default' | 'salesDesc' | 'priceAsc' | 'priceDesc': AliExpress product search sort order
- `catId` string
- `brandId` string
- `loc` string
- `switches` string
- `attr` string
- `startPrice` number, double
- `endPrice` number, double
- `locale` string
- `region` string
- `currency` string

## Response `200`

OK

- object
  - `code` 0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602, required
  - `message` string, nullable, required
  - `data` unknown, required
  - `recordTime` string, nullable, required
  - `requestId` string
  - `reason` string
  - `requestParams` object
    - `query` object
    - `body` object
      - `empty` boolean
      - `array` boolean
      - `null` boolean
      - `object` boolean
      - `float` boolean
      - `integralNumber` boolean
      - `floatingPointNumber` boolean
      - `bigDecimal` boolean
      - `bigInteger` boolean
      - `textual` boolean
      - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
      - `string` boolean
      - `missingNode` boolean
      - `valueNode` boolean
      - `container` boolean
      - `pojo` boolean
      - `short` boolean
      - `int` boolean
      - `long` boolean
      - `double` boolean
      - `boolean` boolean
      - `binary` boolean
      - `number` boolean
      - `embeddedValue` boolean

## Other responses

- `400`: Invalid request parameters or body
- `401`: Invalid or inactive access token
- `403`: Permission denied
- `429`: Request rate or daily quota limit exceeded
- `500`: Internal server error
- `503`: Service temporarily unavailable

## Changes

- **2026-10-31** `4f43dc260e5b`: 7 info
  - added the optional property `requestParams` to the response with the `200` status
  - added the optional property `requestParams` to the response with the `400` status
  - added the optional property `requestParams` to the response with the `401` status
  - added the optional property `requestParams` to the response with the `403` status
  - …3 more
- **2026-10-02** `9c931cc01324`: 7 info
  - added the optional property `reason` to the response with the `200` status
  - added the optional property `reason` to the response with the `400` status
  - added the optional property `reason` to the response with the `401` status
  - added the optional property `reason` to the response with the `403` status
  - …3 more
- **2026-09-05** `1165c001e930`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/justoneapi/apis/justoneapi-api/changes/api/aliexpress/search-products/v1/get.md)

---

[API](https://skmtc.dev/justoneapi/apis/justoneapi-api.md) - [All operations](https://skmtc.dev/justoneapi/apis/justoneapi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/justoneapi/apis/justoneapi-api/revisions/4f43dc260e5b?raw)