# AliExpress Search Scraper | Prices, Sold Count & Shipping (`genial_candlestand/aliexpress-search-scraper`) Actor

Get AliExpress search and category results: title, price, original price, discount, exact sold count, rating, Choice and ad flags, ships-from country, delivery days and rank. Keywords, category ids or search URLs; 20 delivery countries, 16 currencies, 11 languages. No login.

- **URL**: https://apify.com/genial_candlestand/aliexpress-search-scraper.md
- **Developed by:** [Flowo](https://apify.com/genial_candlestand) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.62 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## AliExpress Search Scraper | Prices, Sold Count & Shipping

![AliExpress Search Scraper | Prices, Sold Count & Shipping](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/aliexpress-com-product-search-category-listings-banner-26bd83be.png)

Get the product cards AliExpress shows for a keyword search, a category or a search URL pasted from your browser. Each product is one flat row with the title, sale price, original price and discount, exact sold count, star rating, Choice and ad flags, ships-from country, delivery days, category ids and rank in the results. You can pick any of 20 delivery countries, 16 currencies and 11 languages, and use AliExpress's own filters.

### What does AliExpress Search Scraper do?

You give it search keywords, AliExpress category ids or category URLs, or search and category page URLs copied from aliexpress.com. It goes through the results pages, up to the 60 pages AliExpress serves for one search, and saves every unique product it finds, with its position in the results. It is built for dropshippers and e-commerce sellers doing product research, analysts tracking prices and assortment in a niche or a market, and AI agents answering requests like "find X on AliExpress under $Y".

It does not open product detail pages. SKU variants, stock, specifications, reviews and store pages are not part of its output.

### How to scrape AliExpress search results

![AliExpress Search Scraper output example: Image, Title, Price, Original price, Currency](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/aliexpress-com-product-search-category-listings-output-9d9ff514.png)

![How AliExpress Search Scraper works: Requests AliExpress search or category pages with your filters and locale; Reads the product cards from the JSON embedded in each results page; Pages up to page 60](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/aliexpress-com-product-search-category-listings-how-c04e2154.png)

1. Open the actor in Apify Console.
2. Enter one or more **Search keywords** (e.g. `gaming mouse`), **Category IDs** (e.g. `44`), or **Start URLs** copied from AliExpress search or category pages.
3. Set **Max products per search** (default 100, at most 3,600).
4. Optionally choose **Sort by**, a **Min price** / **Max price**, **Free shipping only**, **Choice products only**, **4 stars & up only** and **Ships from**.
5. Pick the delivery **Country**, the **Currency** and the **Language** of titles.
6. Click **Start** and download the products as JSON, CSV, Excel or HTML, or read them through the API.

### How much does it cost to scrape AliExpress?

Price per event by Apify plan:

| Event | Free | Bronze | Silver | Gold and above |
|---|---|---|---|---|
| Product | $1.90 per 1,000 | $1.805 per 1,000 | $1.71 per 1,000 | $1.615 per 1,000 |
| Actor start | $0.00005 | $0.00005 | $0.00005 | $0.00005 |

A test run with the API example input below returned 100 rows in 11 s.

You pay for each **product** saved to the dataset: one unique AliExpress product from a search or category page. On top of that there is a small Actor start event, charged once per run.

These are free:

- duplicate cards, which are common on deep pages;
- the "similar products" suggestions AliExpress shows when a keyword has no real matches;
- cards skipped by the **Ships from** check or by the 4-stars rating check described below;
- pages that failed.

The Apify datacenter proxy is included in the price.

| Scenario | Product events | Cost on the Free plan |
|---|---|---|
| One keyword, default 100 products | 100 | about $0.19 |
| One category, 1,000 newest products | 1,000 | about $1.90 |
| 5 keywords × 300 best sellers | 1,500 | about $2.85 |
| 10,000 products for a price monitor | 10,000 | about $19.00 |

The start fee ($0.00005 per run at the default memory) is already included in these numbers.

### Input

![AliExpress Search Scraper input example: Search keywords, Max products per search, Sort by, Free shipping only, Choice products only, 4 stars & up only, Ships from](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/aliexpress-com-product-search-category-listings-input-4897f9f1.png)

At least one of **Search keywords**, **Category IDs** or **Start URLs** is required.

- **Search keywords** (`queries`): one search per keyword, in any language (e.g. `gaming mouse`, `handyhülle`, `手机壳`).
- **Category IDs** (`categoryIds`): numeric ids such as `44` (Consumer Electronics) or `100003109` (Women's Clothing), or category URLs like `https://www.aliexpress.com/category/44/consumer-electronics.html`. On their own, each category is listed. With keywords, each keyword is searched inside each category (keywords × categories searches).
- **Start URLs** (`startUrls`): search (`/w/wholesale-….html`) or category (`/category/<id>/….html`) URLs. The URL's filters `catId`, `attr` (brand, colour and other attributes), `SortType`, `minPrice`, `maxPrice` and `selectedSwitches` are kept, and the form fields below override them when you set them. `aliexpress.us` and language subdomains such as `de.aliexpress.com` are rewritten to `www.aliexpress.com`. Product (`/item/`) URLs, store pages and aliexpress.ru are not supported.
- **Max products per search** (`maxItemsPerSearch`): 1–3,600, default 100.
- **Max products in total** (`maxItems`): optional cap for the whole run.
- **Sort by** (`sort`): `relevance` (Best match, default), `orders` (most sold first), `priceAsc`, `priceDesc`, `newest`.
- **Min price** / **Max price** (`minPrice`, `maxPrice`): in the selected currency. Use one or both; Min price must not be greater than Max price.
- **Free shipping only** (`freeShipping`), **Choice products only** (`choiceOnly`), **4 stars & up only** (`fourStarsAndUp`): AliExpress's filters, which can be combined. AliExpress returns no products when its 4-stars filter is used with a price sort, so with **Sort by** `priceAsc` or `priceDesc` the actor sorts on AliExpress without that filter and keeps only cards with a `rating` of 4 or more; cards without a rating are skipped. This also applies to a 4-stars filter inside a start URL.
- **Ships from** (`shipFrom`): `any` (default), `local` (a warehouse in the delivery country) or `CN` (China).
- **Country** (`country`): delivery country, one of US, GB, DE, FR, ES, IT, NL, PL, SE, TR, IL, SA, BR, MX, CA, AU, NZ, KR, JP, UA (default US).
- **Currency** (`currency`): USD, EUR, GBP, CAD, AUD, NZD, BRL, MXN, JPY, KRW, PLN, SEK, TRY, ILS, SAR or UAH (default USD). It works with every country.
- **Language** (`language`): en, de, fr, es, it, pt, nl, pl, tr, ja or ko (default en).
- **Proxy** (`proxyConfiguration`): the default Apify datacenter proxy is enough.

```json
{
  "queries": ["led strip lights", "pet hair remover"],
  "sort": "orders",
  "shipFrom": "local",
  "country": "US",
  "currency": "USD",
  "maxItemsPerSearch": 300
}
```

### What data can you extract from AliExpress?

| Field | What it holds |
|---|---|
| `id` | AliExpress product id (global `1005…` form) |
| `url` | Product page URL |
| `title` | Product title in the selected language |
| `imageUrl`, `images` | Main image and all card images |
| `price`, `originalPrice`, `discountPercent` | Sale price, price before discount, discount in percent |
| `currency`, `priceText` | ISO currency code and the price as displayed (e.g. `US $57.89`) |
| `rating` | Average star rating, 0–5 |
| `soldCount`, `soldText` | Exact units sold (e.g. `1771`) and the displayed text (e.g. `1,000+ sold`) |
| `isAd`, `isChoice`, `freeShipping` | Sponsored card, AliExpress Choice product, Free shipping badge shown |
| `shipFrom` | 2-letter code of the ships-from country (UK is given as GB) |
| `deliveryDaysMin`, `deliveryDaysMax` | Estimated delivery days to the delivery country |
| `skuId` | Id of the SKU whose price is shown |
| `categoryId`, `categoryPath` | Leaf category id and the category ids from top to leaf |
| `author` | Store name, when the card carries it |
| `publishedAt` | Listing date (`YYYY-MM-DD`) |
| `tags` | Selling-point texts on the card |
| `query`, `searchUrl` | The input that found the product and the first results page URL |
| `country`, `page`, `position`, `totalResults` | Delivery country, results page (1–60), rank in the search, matches reported by AliExpress |
| `scrapedAt` | When the product was scraped |

A real row from a "gaming mouse" search in the US view (`images` shortened, the card has 6):

```json
{
  "id": "1005008740551369",
  "url": "https://www.aliexpress.com/item/1005008740551369.html",
  "title": "Gaming Mouse Ultra-Lightweight2.4GHz MCHOSE L7 Wireless Gaming Mouse L7 Ultra PAW3395 26K Sensor Dual 8K Polling 39g Ultra-Lightweight2.4GHz RF/BT/Wired Tri-Mode",
  "imageUrl": "https://ae-pic-a1.aliexpress-media.com/kf/Sb1dc1346ed0f4ca0b3c3c19415c152621.jpg",
  "images": ["https://ae-pic-a1.aliexpress-media.com/kf/Sb1dc1346ed0f4ca0b3c3c19415c152621.jpg"],
  "price": 57.89,
  "originalPrice": 76.18,
  "discountPercent": 24,
  "currency": "USD",
  "priceText": "US $57.89",
  "rating": 4.9,
  "soldCount": 1771,
  "soldText": "1,000+ sold",
  "isAd": true,
  "isChoice": true,
  "freeShipping": false,
  "shipFrom": "CN",
  "deliveryDaysMin": null,
  "deliveryDaysMax": null,
  "skuId": "12000057116536025",
  "categoryId": "70805",
  "categoryPath": ["7", "200001081", "200001082", "70805"],
  "author": "MCHOSE Official Store",
  "publishedAt": "2025-03-31",
  "tags": ["New shoppers save $18.29", "Top selling on AliExpress"],
  "query": "gaming mouse",
  "searchUrl": "https://www.aliexpress.com/w/wholesale-gaming-mouse.html",
  "country": "US",
  "page": 1,
  "position": 4,
  "totalResults": 40961,
  "scrapedAt": "2026-11-13T07:12:41.250Z"
}
```

### Use cases

- **Dropshipping research:** find the most-sold products in a niche that ship from a local warehouse, with sold count, price and delivery days.
- **Price monitoring per market:** track prices of a keyword in Germany in EUR with German titles, within a price range and with free shipping.
- **Category catalogue slices:** pull the newest listings of a category with their listing date and category path.
- **Re-running a filtered browser search:** paste a search URL with brand or colour filters and get the same results as rows.
- **AI agent shopping tasks:** answer "cheapest well-rated USB cables under $3" with a price cap, the 4-stars filter and price sorting.

### Limitations

- AliExpress serves at most 60 pages (about 3,600 cards) per search, and deep pages repeat products, so one search gives roughly 2,700 unique products at most.
- Only search and category listings. No product detail pages (SKU variants, stock, specifications, description), reviews, store pages, store ids or shipping fee amounts.
- Categories are given as ids (`categoryId`, `categoryPath`); AliExpress cards carry no category names.
- These fields can be `null` when the card does not show them: `imageUrl`, `images`, `price`, `originalPrice`, `discountPercent`, `currency`, `priceText`, `rating`, `soldCount`, `soldText`, `shipFrom`, `deliveryDaysMin`, `deliveryDaysMax`, `skuId`, `categoryId`, `categoryPath`, `author`, `publishedAt`, `tags` and `totalResults`. Missing values are never guessed.
- The store name (`author`) is on a minority of cards, mostly promoted ones.
- `totalResults` is approximate; with the 4-stars or ships-from filters AliExpress reports only a running count. With 4 stars & up and a price sort, it is the count of the search without the rating filter.
- `freeShipping` reflects the badge on the card. In a free-shipping search, not every card shows the badge, so the flag can be `false`.
- A product found by two searches is saved once, with the `query` of the search that found it first.
- Russia, India and Switzerland are not offered as delivery countries.

### Tips and troubleshooting

- **More than about 2,700 products for one topic:** split the search by price range (Min/Max price) or by category.
- **0 rows for a keyword:** AliExpress found no exact matches and showed only suggestions, which are not saved (the log says so). Try a broader or differently spelled keyword.
- **0 rows with Ships from = Local warehouse:** there may be no products in a warehouse in that country; the search stops after 2 pages in a row with no matching card, with a warning.
- **Filters combine:** Free shipping, Choice, 4 stars & up, a price range and Ships from can be used together, and with keywords inside categories.
- **4 stars & up with a price sort:** the rating is checked on each card, and products without a rating are left out. If 5 results pages in a row have no card rated 4 or more, the search stops with a warning.
- **Input errors:** a run with no keywords, categories or URLs, a Min price above the Max price, a category entry that is neither digits nor a category URL, or an unsupported URL fails at once with a message naming the field.
- **Proxy:** keep the default Apify proxy. Without a proxy, AliExpress blocks the requests quickly.

### API, MCP and integrations

Run the actor from your code with the same JSON input as in Console. Your API token is in [Console → Settings → API & Integrations](https://console.apify.com/settings/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("genial_candlestand/aliexpress-search-scraper").call(run_input={"queries": ["gaming mouse"], "maxItemsPerSearch": 100})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**Node.js** (`npm install apify-client`):

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('genial_candlestand/aliexpress-search-scraper').call({"queries": ["gaming mouse"], "maxItemsPerSearch": 100});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**HTTP** — one request runs the actor and returns the results (runs up to 5 minutes; longer ones: [run asynchronously](https://docs.apify.com/api/v2/act-runs-post)):

```bash
curl -X POST "https://api.apify.com/v2/acts/genial_candlestand~aliexpress-search-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["gaming mouse"],"maxItemsPerSearch":100}'
```

**AI agents (MCP).** Add the actor as a tool of the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Claude Code:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=genial_candlestand/aliexpress-search-scraper"
```

Claude Desktop, Cursor or VS Code: `{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=genial_candlestand/aliexpress-search-scraper"}}}`. Then ask, for example:

- "Find the 20 cheapest USB cables under $3 on AliExpress with 4 stars and up"
- "List the 300 best-selling LED strip lights on AliExpress that ship from a US warehouse"
- "Get the 1000 newest AliExpress listings in category 44 with listing date and category path"

**Integrations.** Run it on a schedule with [Apify Schedules](https://docs.apify.com/platform/schedules) and send the results to Google Sheets, Slack, Zapier, Make, n8n or your webhook — see [Apify integrations](https://docs.apify.com/platform/integrations).

### FAQ

**Is it legal to scrape AliExpress?**<br>
The actor collects only public product listings that any visitor sees without logging in. Store names are those of businesses. You are responsible for how you use the data, including AliExpress's terms and the laws that apply to you.

**Do I need an AliExpress account or API key?**<br>
No. The actor needs no login, cookies or affiliate key.

**Can I get prices for another country or currency?**<br>
Yes. Country, currency and language are independent settings: for example, USD prices with delivery to Germany, or French titles with delivery to the US.

**How is it different from other AliExpress scrapers?**<br>
It takes keywords, category ids or URLs and pasted search URLs with their filters, not only keywords. It returns the exact sold count, ad and Choice flags, ships-from country and delivery days per product. It costs $1.90 per 1,000 products, against $2.00 for the most used AliExpress product search actor, with the datacenter proxy included.

**Why do I get fewer products than Max products per search?**<br>
The search ran out of results, AliExpress stopped at page 60, duplicates were dropped, or the Ships from or 4-stars rating check skipped cards. You are not charged for skipped or duplicate cards.

### Also useful

- [AliExpress Product Scraper](https://apify.com/genial_candlestand/aliexpress-product-details-scraper) — open the products you found to get SKU variants, stock, shipping costs and specs
- [Amazon Best Sellers Scraper](https://apify.com/genial_candlestand/amazon-best-sellers-scraper) — compare your niche with Amazon's top products, ranks and prices on 12 stores
- [Etsy Search Scraper](https://apify.com/genial_candlestand/etsy-search-scraper) — check the same keywords on Etsy: prices, shops, ads and search rank
- [eBay Sold Listings Scraper](https://apify.com/genial_candlestand/ebay-sold-listings-scraper) — see what similar products actually sell for on eBay, with sold dates and shipping
- [Google Trends Scraper](https://apify.com/genial_candlestand/google-trends-scraper) — check whether demand for a product idea is rising before you list it

# Actor input Schema

## `queries` (type: `array`):

Keywords to search on AliExpress, one per line, in any language (e.g. "gaming mouse", "handyhülle"). Each keyword is one search. With Category IDs, every keyword is searched inside every category. Give at least one of Search keywords, Category IDs or Start URLs.

## `categoryIds` (type: `array`):

Numeric AliExpress category ids (e.g. 44 = Consumer Electronics, 100003109 = Women's Clothing) or category URLs like https://www.aliexpress.com/category/44/consumer-electronics.html (the id is taken from the URL). Alone: lists the products of each category. With Search keywords: each keyword is searched inside each category.

## `startUrls` (type: `array`):

AliExpress search (/w/wholesale-….html) or category (/category/<id>/….html) URLs copied from the browser, e.g. https://www.aliexpress.com/w/wholesale-phone-case.html?attr=3079-4148335. Their filters (catId, attr such as brand or colour, SortType, minPrice, maxPrice, selectedSwitches) are kept; the fields below override them when set. aliexpress.us and language subdomains such as de.aliexpress.com are rewritten to www.aliexpress.com. Product (/item/) URLs, store pages and aliexpress.ru are not supported.

## `maxItemsPerSearch` (type: `integer`):

Stop each search (keyword, category or URL) after this many unique products (1–3,600). AliExpress shows at most 60 pages (about 3,600 cards, roughly 2,700 unique) per search; split big searches by price range or category to get more.

## `maxItems` (type: `integer`):

Optional cap on all products of the run across all searches. Empty = no total cap (only Max products per search applies).

## `sort` (type: `string`):

Order of the results, as on AliExpress: Best match, Orders (most sold first), Price low to high, Price high to low, or Newest listings.

## `minPrice` (type: `number`):

Only products priced at least this much, in the selected Currency (e.g. 10 with EUR = €10). Can be used alone or with Max price; Min price must not be greater than Max price.

## `maxPrice` (type: `number`):

Only products priced at most this much, in the selected Currency. Can be used alone or with Min price.

## `freeShipping` (type: `boolean`):

AliExpress filter "Free shipping" for the selected delivery Country. Combines with the other filters.

## `choiceOnly` (type: `boolean`):

AliExpress filter "Choice" (products of the AliExpress Choice programme). Combines with the other filters.

## `fourStarsAndUp` (type: `boolean`):

AliExpress filter "4★ & up". AliExpress returns nothing for it together with a price sort, so with Price low to high or Price high to low the actor keeps only cards rated 4 or more itself (unrated cards are skipped, not charged). With the AliExpress filter, totalResults is only a running count.

## `shipFrom` (type: `string`):

Any warehouse; Local warehouse = ships from the delivery Country itself (e.g. US warehouses when Country is United States); or China. Products not shipping from the chosen place are skipped and not charged.

## `country` (type: `string`):

Delivery country: decides the shipping options, local warehouses and delivery days shown. Prices are shown in Currency, independent of the country. Russia, India and Switzerland are not offered: AliExpress serves them with another site or returns other countries' results.

## `currency` (type: `string`):

Currency of all prices and of Min/Max price. Works with every Country.

## `language` (type: `string`):

Language of product titles and tags (AliExpress machine-translates them). Works with every Country.

## `proxyConfiguration` (type: `object`):

The Apify datacenter proxy is enough and included in the price; blocked pages are retried automatically on new IPs and, if needed, through Apify residential proxy. Running without a proxy gets blocked quickly.

## Actor input object example

```json
{
  "queries": [
    "gaming mouse"
  ],
  "maxItemsPerSearch": 100,
  "sort": "relevance",
  "freeShipping": false,
  "choiceOnly": false,
  "fourStarsAndUp": false,
  "shipFrom": "any",
  "country": "US",
  "currency": "USD",
  "language": "en",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with one row per unique product card

## `overview` (type: `string`):

The products in the overview view (image, title, price, sold count, rating)

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "gaming mouse"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("genial_candlestand/aliexpress-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "queries": ["gaming mouse"] }

# Run the Actor and wait for it to finish
run = client.actor("genial_candlestand/aliexpress-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "gaming mouse"
  ]
}' |
apify call genial_candlestand/aliexpress-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,genial_candlestand/aliexpress-search-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0BRfVqR2d4VClx6ju/builds/VWXUPlc3jdJA61P5j/openapi.json
