Docs menu

AliExpress API endpoint

List AliExpress search filters API

Returns every sort value and boolean filter the search endpoint accepts, plus the product-attribute filters (brand, color, style, and so on) AliExpress offers for the keyword, as ready-to-use attr values. Attribute filters differ per keyword, so call this with the same q as the search.

GETapiKey3 credits/requestAliExpressaliexpress.filtersResponseDoc/aliexpress/search-filters

Endpoint facts

Method: GET
API path: /aliexpress/search-filters
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: AliExpress
Response schema: #/definitions/aliexpress.filtersResponseDoc

AliExpress Scraper API Try List AliExpress search filters API in Playground AliExpress API documentation

How this endpoint behaves

Parameters

q (required): free-text product keywords. Use the same q you will pass to /aliexpress/search, because attribute filters differ per keyword.

Response behavior

sort_options lists the accepted sort values: best_match, orders, price_asc, price_desc.
switches lists the accepted boolean filter parameters: free_shipping, choice.
attribute_groups lists the keyword's attribute facets (brand, color, style, and so on). Each values[].value is ready to pass as attr to the search endpoint. Pick at most one value per group.
attribute_groups can be empty when AliExpress offers no facets for a keyword.
total_results is AliExpress's own estimate for the unfiltered keyword and varies between requests.

Price ranges, ships-from, and the 4-star-and-up switch are not exposed: price bounds are separate min_price and max_price parameters, and the other two did not behave reliably when tested.

Responses are cached for up to 1 hour per q; fetched_at is when AliExpress was last queried.

Live monitoring

Monitored request: GET /aliexpress/search-filters?q=wireless+earbuds
Checks passed, 7 days to 14 Oct 2026: 99.7%
Median response time: 3.34 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /aliexpress/search-filters?q=wireless+earbuds
Items in attribute_groups: 17
Fields filled in every checked item: 3

Field	Filled in, of 17 checked	Values in the sample
attribute_id	17
title	17	“Brand” and 16 other values
values	17	median 7 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
q	string	Yes		Free-text search keywords	wireless earbuds
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/aliexpress/search-filters?q=wireless+earbuds" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "wireless earbuds",
    "total_results": 16889,
    "sort_options": [
      {
        "value": "best_match",
        "label": "Best matches (default)"
      },
      {
        "value": "orders",
        "label": "Most sold"
      },
      {
        "value": "price_asc",
        "label": "Price (low to high)"
      },
      {
        "value": "price_desc",
        "label": "Price (high to low)"
      }
    ],
    "switches": [
      {
        "param": "free_shipping",
        "label": "Free shipping"
      },
      {
        "param": "choice",
        "label": "Choice"
      }
    ],
    "attribute_groups": [
      {
        "attribute_id": "3079",
        "title": "Main color",
        "values": [
          {
            "value": "3079-4148335",
            "label": "Black"
          },
          {
            "value": "3079-4148343",
            "label": "White"
          }
        ]
      }
    ],
    "source_url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html?SearchText=wireless+earbuds&catId=0",
    "fetched_at": "2026-10-02T00:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/aliexpress.filtersResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	aliexpress.FiltersResponse	No
data.attribute_groups	array	No
data.attribute_groups[].attribute_id	string	No	3079
data.attribute_groups[].title	string	No	Main color
data.attribute_groups[].values	array	No
data.attribute_groups[].values[].label	string	No	Black
data.attribute_groups[].values[].value	string	No	3079-4148335
data.fetched_at	string	No
data.query	string	No	wireless earbuds
data.sort_options	array	No
data.sort_options[].label	string	No	Price (low to high)
data.sort_options[].value	string	No	price_asc
data.source_url	string	No
data.switches	array	No
data.switches[].label	string	No	Free shipping
data.switches[].param	string	No	free_shipping
data.total_results	integer	No	16912
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/aliexpress/search-filters?q=wireless+earbuds" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More AliExpress endpoint docs AliExpress Scraper API List AliExpress category navigation API documentation Discover AliExpress web category ids API documentation AliExpress Category Products API documentation Get AliExpress product reviews API documentation Search AliExpress products API documentation Suggest AliExpress search keywords API documentation

Open in Playground Back to group

Docs menu

AliExpress API endpoint

List AliExpress search filters API

GETapiKey3 credits/requestAliExpressaliexpress.filtersResponseDoc/aliexpress/search-filters

Endpoint facts

Method: GET
API path: /aliexpress/search-filters
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: AliExpress
Response schema: #/definitions/aliexpress.filtersResponseDoc

AliExpress Scraper API Try List AliExpress search filters API in Playground AliExpress API documentation

How this endpoint behaves

Parameters

q (required): free-text product keywords. Use the same q you will pass to /aliexpress/search, because attribute filters differ per keyword.

Response behavior

sort_options lists the accepted sort values: best_match, orders, price_asc, price_desc.
switches lists the accepted boolean filter parameters: free_shipping, choice.
attribute_groups lists the keyword's attribute facets (brand, color, style, and so on). Each values[].value is ready to pass as attr to the search endpoint. Pick at most one value per group.
attribute_groups can be empty when AliExpress offers no facets for a keyword.
total_results is AliExpress's own estimate for the unfiltered keyword and varies between requests.

Price ranges, ships-from, and the 4-star-and-up switch are not exposed: price bounds are separate min_price and max_price parameters, and the other two did not behave reliably when tested.

Responses are cached for up to 1 hour per q; fetched_at is when AliExpress was last queried.

Live monitoring

Monitored request: GET /aliexpress/search-filters?q=wireless+earbuds
Checks passed, 7 days to 14 Oct 2026: 99.7%
Median response time: 3.34 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /aliexpress/search-filters?q=wireless+earbuds
Items in attribute_groups: 17
Fields filled in every checked item: 3

Field	Filled in, of 17 checked	Values in the sample
attribute_id	17
title	17	“Brand” and 16 other values
values	17	median 7 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
q	string	Yes		Free-text search keywords	wireless earbuds
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/aliexpress/search-filters?q=wireless+earbuds" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "wireless earbuds",
    "total_results": 16889,
    "sort_options": [
      {
        "value": "best_match",
        "label": "Best matches (default)"
      },
      {
        "value": "orders",
        "label": "Most sold"
      },
      {
        "value": "price_asc",
        "label": "Price (low to high)"
      },
      {
        "value": "price_desc",
        "label": "Price (high to low)"
      }
    ],
    "switches": [
      {
        "param": "free_shipping",
        "label": "Free shipping"
      },
      {
        "param": "choice",
        "label": "Choice"
      }
    ],
    "attribute_groups": [
      {
        "attribute_id": "3079",
        "title": "Main color",
        "values": [
          {
            "value": "3079-4148335",
            "label": "Black"
          },
          {
            "value": "3079-4148343",
            "label": "White"
          }
        ]
      }
    ],
    "source_url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html?SearchText=wireless+earbuds&catId=0",
    "fetched_at": "2026-10-02T00:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/aliexpress.filtersResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	aliexpress.FiltersResponse	No
data.attribute_groups	array	No
data.attribute_groups[].attribute_id	string	No	3079
data.attribute_groups[].title	string	No	Main color
data.attribute_groups[].values	array	No
data.attribute_groups[].values[].label	string	No	Black
data.attribute_groups[].values[].value	string	No	3079-4148335
data.fetched_at	string	No
data.query	string	No	wireless earbuds
data.sort_options	array	No
data.sort_options[].label	string	No	Price (low to high)
data.sort_options[].value	string	No	price_asc
data.source_url	string	No
data.switches	array	No
data.switches[].label	string	No	Free shipping
data.switches[].param	string	No	free_shipping
data.total_results	integer	No	16912
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/aliexpress/search-filters?q=wireless+earbuds" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

List AliExpress search filters API

Endpoint facts

How this endpoint behaves

Parameters

Response behavior

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

List AliExpress search filters API

Endpoint facts

How this endpoint behaves

Parameters

Response behavior

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related