AliExpress Keyword Search

CostAt least 10 credits / call

POST · https://api.nexscope.ai/aliexpress/productSearch

What this API does

Search public AliExpress product listings by keyword. Send a keyword of up to 120 normalized characters; use pageNum (1–20) and limit (1–100) to bound the search. The response provides a taskId. Poll GET /aliexpress/tasks/{taskId} with the same Nexscope API key to retrieve the completed product results. The request accepts keyword, pageNum, limit. Generation runs as a task: retain the task ID and retrieve the completed result before using the output.

AliExpress Keyword Search API use cases

Submit a AliExpress Keyword Search request

Search public AliExpress product listings by keyword. Send a keyword of up to 120 normalized characters; use pageNum (1–20) and limit (1–100) to bound the search.

Retrieve the completed result

Keep the taskId from the initial response. Poll GET /aliexpress/tasks/{taskId} with the same Nexscope API key to retrieve the completed product results.

AliExpress Keyword Search API FAQ

What does the AliExpress Keyword Search API return?

Search public AliExpress product listings by keyword. The initial response includes a taskId and status. Use the task result endpoint to retrieve the completed result.

How many credits does the AliExpress Keyword Search API cost?

Published rate: At least 10 credits / call. Actual credits depend on the request; review API usage records after completion. Looking up a task result does not start another collection.

How do I call the AliExpress Keyword Search API?

Send a POST request to https://api.nexscope.ai/aliexpress/productSearch with your Nexscope API key in the Authorization Bearer header and the documented JSON inputs. Poll GET /aliexpress/tasks/{taskId} with the same Nexscope API key to retrieve the completed product results.

View plans and credits

Try this API

Endpoint

https://api.nexscope.ai/aliexpress/productSearch

Step 1 of 3 · Authenticate

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Missing or invalid API keys return an authentication error. Manage keys from .

Task result

Poll the returned task ID with the same Nexscope API key.

GET /aliexpress/tasks/{taskId}

Step 2 of 3 · Send a request

POSThttps://api.nexscope.ai/aliexpress/productSearch

Run an API

Send a JSON request body using the parameters described below.

Example request

Replace YOUR_API_KEY, then run this command in your terminal.

curl -X POST 'https://api.nexscope.ai/aliexpress/productSearch' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "wireless earbuds",
  "pageNum": 1,
  "limit": 1
}'

Code example

{
  "keyword": "wireless earbuds",
  "pageNum": 1,
  "limit": 1
}

Step 3 of 3 · Inspect the result

Check the response

Read code for the request status and data for the result. Open the parameter and response reference for the full field definitions.

HTTP status codes

Code	Description
200	Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429	Execution admission rate limit; honor Retry-After when present.
503	Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-in	X-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses.

View parameters & response Try online

All categories/ AliExpress

POSThttps://api.nexscope.ai/aliexpress/productSearch

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Open tester

Endpoint

Method	`POST`
Path	`https://api.nexscope.ai/aliexpress/productSearch`
Auth	`Bearer API key`
Content-Type	`application/json`

Request parameters

Name	Type	Required	Description
`keyword`	`string`	required	required string, up to 120 normalized characters
`pageNum`	`integer`	optional	integer 1–20, default 1
`limit`	`integer`	optional	integer 1–100, default 20.

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

{
  "code": 0,
  "data": {
    "taskId": "TASK_ID",
    "status": "SUBMITTING",
    "result": null,
    "usage": {
      "billingStatus": "PENDING",
      "chargedCredits": 0
    },
    "error": null
  }
}

Response fields

Response field reference (0 fields)

No required request fields are defined for this API.

Responses

Code	Description
200	Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429	Execution admission rate limit; honor Retry-After when present.
503	Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-in	X-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Data Example

Sample request and response

Request parameters

{
  "keyword": "wireless earbuds",
  "pageNum": 1,
  "limit": 1
}

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "taskId": "EXAMPLE_TASK_ID",
    "status": "SUCCEEDED",
    "result": {
      "items": [
        {
          "url": "https://www.aliexpress.com/item/3256811621288203.html",
          "price": null,
          "title": "2026 New Air 3【 Pro3 】 Bluetooth Wireless Earbuds With Heart Rate Monitoring, Active Noise Cancellation Headphones, Waterproof for Daily Use, For IPhone IOS Smartphone, Gaming /Sports /Fitness Earphones.",
          "images": [],
          "currency": null,
          "priceType": null,
          "productId": "3256811621288203",
          "variantId": null,
          "collectedAt": null,
          "availability": null,
          "missingFields": [
            "images",
            "collectedAt",
            "variantId",
            "availability",
            "completeSkuMatrix",
            "price",
            "currency"
          ],
          "variantAttributes": [],
          "listingHasVariations": null,
          "variantGroups": []
        }
      ],
      "discovered": [],
      "retrievedAt": "1793687830552",
      "errorRecords": 0,
      "limitReached": true,
      "variantCoverage": "NOT_REQUESTED"
    },
    "usage": {
      "billingStatus": "CHARGED",
      "chargedCredits": "10"
    },
    "error": null
  }
}

Online test

Execute the current API with your API key and JSON payload. Online tests use this site's configured API environment; the Endpoint and copyable examples use the public integration address.

Submitting a request can use credits. The task result lookup does not submit the request again. Review the final charge in API usage records.

At least 10 credits / callAPI usage records

Try it

Send a real request with the same contract shown in the reference.

Endpoint

/aliexpress/productSearch

Task result endpoint

/aliexpress/tasks/{taskId}

API key*

JSON payload*

cURL

curl -X POST \
  https://api.nexscope.ai/aliexpress/productSearch \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "wireless earbuds", "pageNum": 1, "limit": 1 }'

Response

No response yet. Run the request to see the response here.

Task result

Results are checked automatically after Run request. You can also enter a task ID and check it manually; completed resources use Nexscope URLs and show actual charged credits.

Task ID

Result response

No task result yet. Query the task to see the generated output here.

Related APIs

AliExpress Product Detail

Collect public product details from an AliExpress product URL. Submit a supported HTTPS AliExpress product URL in url; this operation has no limit parameter. The response provides a taskId. Poll GET /aliexpress/tasks/{taskId} with the same Nexscope API key to inspect the completed product details.

AliExpress Category Discovery

Discover products from a public AliExpress category navigation URL. Submit a supported category navigation URL in url and optionally set limit (1–100, default 20) to bound the returned products. The response provides a taskId. Poll GET /aliexpress/tasks/{taskId} with the same Nexscope API key for the completed discovery results.

AliExpress Category Variants

Collect observed product variants from a public AliExpress category navigation URL. Submit a supported category URL in url; limit (1–100, default 20) bounds product groups, and one product may return several variant rows. The response provides a taskId. Poll GET /aliexpress/tasks/{taskId} with the same Nexscope API key to review the completed variant results.

AliExpress Google Organic Search

Retrieve structured Google organic search results for AliExpress research. Send a UUID requestId and keyword; pageNum (1–10) and limit (1–10) bound the result set. The response provides a taskId. Poll GET /aliexpress/accessTasks/{taskId} with the same Nexscope API key to retrieve the completed search results.