# AliExpress Price Tracker - Best Sellers & Ratings \[NO LOGIN] ✅ (`unseenuser/aliexpress-product-search`) Actor

AliExpress price tracker: get prices, sales counts, ratings and links from AliExpress search results. 23 ship-to countries, 18 currencies, 13 title languages, sort by best selling or price, price range filter, organic/ad/promoted labels. Error rows are free. Export to CSV, Excel, JSON or API.

- **URL**: https://apify.com/unseenuser/aliexpress-product-search.md
- **Developed by:** [Unseen User](https://apify.com/unseenuser) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $3.49 / 1,000 product founds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 Scraper - Prices, Sales & Ratings \[NO LOGIN] ✅

> **Search AliExpress by keyword and get product titles, prices, sales counts, ratings, links and images for 23 ship-to countries, 18 currencies and 13 languages.**

### ⚡ Why This Actor?

Atomic actor: input one or more search keywords, get back AliExpress products exactly as they appear in the search results: title, current price, sales count, star rating, product link, main image and listing type (organic, ad or promoted). Choose the ship-to country, the currency and the language of the titles, sort by best match, best selling or price, and filter by a price range. Built for product research, price tracking and dropshipping sourcing at a low price per product. No login, no cookies, no browser.

This is a search results actor. It does NOT open product pages, so it does not return variants, stock, shipping costs, seller details or reviews.

### 🎯 Use Cases

- **Dropshipping product research** - find best-selling products for a niche by sorting on sales and reading the sales count and rating of each listing
- **Price tracking** - run the same keywords on a schedule and compare current prices per ship-to country and currency
- **Competitive monitoring** - see which products and brands rank first for your category keywords and which positions are paid ads
- **Market research** - estimate how crowded a product category is from the number of listings, price spread and sales counts
- **Localization research** - compare the same search in Germany, Brazil, Japan or Saudi Arabia to see local titles, prices and rankings
- **Catalog sourcing** - build a shortlist of candidate products with links and images for your own supplier review
- **Ad placement analysis** - measure how many results are ads or promoted listings for a keyword

### 🚀 Quick Start

1. Click **Try for free** on this Actor's page
2. Enter the required identifier (see Inputs Overview below)
3. Run the Actor
4. Download results as JSON, CSV, or XLSX, or pull via Apify API

The required identifier for this Actor is one or more search keywords (one per line), for example `wireless earbuds`.

### ⚙️ Inputs Overview

| Input | Type | Required | Description | Example/Allowed Values |
|---|---|---|---|---|
| `keywords` | array of strings | ✅ | Search keywords, one search per line. Any language. Empty lines are ignored; a repeated keyword runs once. | `["wireless earbuds", "phone case"]` |
| `maxProductsPerKeyword` | integer | ❌ | Maximum products per keyword (0 = all results, free plan: up to 5). Minimum 0. AliExpress returns up to 20 products per page. Default 100. Free Apify plan: up to 5 results per run, whatever this field says; paid plans: no limit. | `100` |
| `sort` | enum | ❌ | Result order. Default `default` (best match) | `default`, `salesDesc`, `priceAsc`, `priceDesc` |
| `minPrice` | number | ❌ | Lowest price to include, in the chosen currency, inclusive. Minimum 0. Must not be higher than `maxPrice`. | `2` |
| `maxPrice` | number | ❌ | Highest price to include, in the chosen currency, inclusive. Minimum 0. | `10` |
| `shipTo` | enum | ❌ | Ship-to country. Prices and results change by country. Default `US` | One of the 23 countries in the table below |
| `currency` | enum | ❌ | Currency for prices. `auto` = the ship-to country's own currency. Default `auto` | `auto` or one of the 18 currencies below |
| `language` | enum | ❌ | Language of the product titles. Independent of the country. Default `en_US` | One of the 13 languages below |
| `includeRepeats` | boolean | ❌ | When on, products that appear again on later pages are written again with `isRepeat: true`. Default off | `false` |

#### Countries, currencies and languages

| Ship-to country (`shipTo`) | Auto currency |
|---|---|
| United States (`US`) | USD |
| Germany (`DE`) | EUR |
| France (`FR`) | EUR |
| Spain (`ES`) | EUR |
| Italy (`IT`) | EUR |
| Netherlands (`NL`) | EUR |
| Belgium (`BE`) | EUR |
| Poland (`PL`) | PLN |
| Switzerland (`CH`) | CHF |
| Sweden (`SE`) | SEK |
| Brazil (`BR`) | BRL |
| Mexico (`MX`) | MXN |
| Chile (`CL`) | CLP |
| Canada (`CA`) | CAD |
| Australia (`AU`) | AUD |
| South Korea (`KR`) | KRW |
| Japan (`JP`) | JPY |
| Israel (`IL`) | ILS |
| Saudi Arabia (`SA`) | SAR |
| United Arab Emirates (`AE`) | AED |
| Turkey (`TR`) | TRY |
| Kazakhstan (`KZ`) | KZT |
| Russia (`RU`) | RUB |

**Currencies (18):** USD, EUR, PLN, CHF, SEK, BRL, MXN, CLP, CAD, AUD, KRW, JPY, ILS, SAR, AED, TRY, KZT, RUB. Any currency works with any country (for example Germany with USD).

**Languages (13):** English (`en_US`), German (`de_DE`), French (`fr_FR`), Spanish (`es_ES`), Italian (`it_IT`), Dutch (`nl_NL`), Polish (`pl_PL`), Portuguese - Brazil (`pt_BR`), Korean (`ko_KR`), Japanese (`ja_JP`), Arabic (`ar_MA`), Turkish (`tr_TR`), Russian (`ru_RU`). Any language works with any country (for example France with English).

#### Sort and price filter

| `sort` value | Meaning |
|---|---|
| `default` | Best match (AliExpress default order) |
| `salesDesc` | Best selling first |
| `priceAsc` | Price, lowest first |
| `priceDesc` | Price, highest first |

`minPrice` and `maxPrice` are applied by AliExpress before results are returned, in the currency you chose. Both are inclusive.

### 📤 Output

One row per product, in the order AliExpress shows them:

| Field | Type | Description |
|---|---|---|
| `productId` | string | AliExpress product ID |
| `title` | string | Product title in the chosen language |
| `price` | number | Current price shown in the search results, in `currency` |
| `currency` | string | Currency code of `price` |
| `salesCount` | integer or null | Number of sales shown by AliExpress; null if not shown |
| `rating` | number or null | Average star rating (0-5); null if the product has no rating |
| `productUrl` | string | `https://www.aliexpress.com/item/<productId>.html` |
| `imageUrl` | string | Main product image (https) |
| `listingType` | string | `organic`, `ad` or `promoted` |
| `position` | integer | Position in the results for this keyword (1-based, across pages) |
| `page` | integer | Results page the product came from |
| `keyword` | string | The search keyword |
| `shipTo` | string | Ship-to country code |
| `language` | string | Language code of the title |
| `isRepeat` | boolean | Only present when `includeRepeats` is on |
| `scrapedAt` | string | ISO timestamp |

Example row:

```json
{
  "productId": "3256807042125723",
  "title": "TWS Wireless Bluetooth Headset LED Display Gamer Earbuds with Mic Wireless Headphones Noise Cancelling Bluetooth Earphones X15",
  "price": 1.09,
  "currency": "USD",
  "salesCount": 37692,
  "rating": 4.5,
  "productUrl": "https://www.aliexpress.com/item/3256807042125723.html",
  "imageUrl": "https://ae-pic-a1.aliexpress-media.com/kf/S78dfabb1bf044ef48392d1a37aab8a19o.jpg",
  "listingType": "organic",
  "position": 1,
  "page": 1,
  "keyword": "wireless earbuds",
  "shipTo": "US",
  "language": "en_US",
  "scrapedAt": "2026-10-26T12:34:56.789Z"
}
```

After each keyword the dataset also gets one **KEYWORD_SUMMARY** row: the keyword, the total number of results AliExpress reported, products written, pages fetched and why the keyword stopped (limit reached, end of results, budget reached or free plan). Summary, info and error rows are never charged and carry `charged: false`.

**About prices:** prices are what AliExpress shows for that ship-to country and currency at the moment of the run. They may include limited-time offers or new-buyer deals, so the same product can show a different price on another day or in another country.

**About listing types:** `organic` is a normal search result, `ad` is a paid ad placement, `promoted` is a promoted listing. All of them are returned, because they are all part of what a shopper sees.

### 💰 Pricing

Pay-per-event model on Apify.

| Event | Price |
|---|---|
| Actor start | $0.02 per run |
| Product found (one result row) | $0.00349 ($3.49 per 1,000) |

Summary, info and error rows are free.

NOTE: Free Apify users receive up to 5 results per run. Upgrade to any paid Apify plan to remove this limit. This limit was set by the Actor developer, not by Apify.

See exact per-event pricing on the Actor's Apify page.

### 🆓 Free Plan Limit

NOTE: Free Apify users receive up to 5 results per run. Upgrade to any paid Apify plan to remove this limit. This limit was set by the Actor developer, not by Apify.

The 5 results are counted across the whole run, whatever `maxProductsPerKeyword` says (including `0`). On the free plan only the first keyword is searched. Summary, info and error rows do not count toward the 5.

When a free plan run hits the limit, the run finishes successfully (status `SUCCEEDED`) and the run's status message explains what happened. The results you received are fully usable. Upgrade to any paid Apify plan to remove this limit: https://apify.com/pricing

### ❓ FAQ

**Q: Is this legal?**
A: This Actor wraps a JustOneAPI endpoint that handles the underlying data collection. It returns publicly listed product data only (no buyer, reviewer or seller-person data). Your downstream use of the data is your responsibility - see the full Terms of Service and the Actor-Specific Addendum (Part 4) for details.

**Q: Do I need a JustOneAPI account?**
A: No. UnseenUser holds the JustOneAPI credentials. You only need an Apify account.

**Q: What about AliExpress's anti-scraping enforcement?**
A: AliExpress's Terms of Use restrict systematic retrieval of site content. The data provider handles the data collection and bears the responsibility for its own methods. Your downstream use must comply with AliExpress's Terms of Use.

**Q: What if AliExpress sends a cease-and-desist?**
A: Notify UnseenUser within 48 hours via the Apify profile contact form (apify.com/UnseenUser) and cease using this Actor immediately.

**Q: Can I use this data to train AI?**
A: NO, not without your own licensing. AliExpress's Terms of Use restrict compiling and commercially exploiting site content, and product titles and images belong to the sellers who created them.

**Q: What about minors?**
A: This Actor returns product listings only. It returns no buyer, reviewer or user profiles, so it collects no data about minors. Do not use the results to target products at children in breach of child protection or advertising law. See Part 4 for details.

**Q: Why does a nonsense search still return products?**
A: AliExpress shows its closest matches instead of an empty page. The Actor writes those rows like any other results. Check the `title` field if you need exact matches.

**Q: Why do some products repeat across pages?**
A: AliExpress sometimes shows the same product again on a later page. By default the Actor writes each product once per keyword. Turn on `includeRepeats` if you want every appearance (marked `isRepeat: true`).

**Q: Why are there no variants, stock or shipping costs?**
A: This Actor reads the search results pages only. Those pages show one main price, the sales count and the rating, not the full product page.

**Q: Why does the total number of results often show 60000?**
A: AliExpress often reports exactly 60000 as a display cap, and the reported total can change from page to page. Treat `totalResultsReported` in the summary row as a rough indicator, not an exact count.

**Q: Why is the price different from what I see in my browser?**
A: Prices depend on the ship-to country, currency, active promotions and whether the shopper is a new buyer. Set `shipTo` and `currency` to match your own settings for the closest comparison.

**Q: Why are the United Kingdom, Portugal, Ukraine and Hebrew not available?**
A: They did not return results reliably in our tests, so they are left out until they work.

### 🔧 Technical Details

- Data: AliExpress search results pages, 20 products per page
- Output: streamed via Apify dataset
- Format: JSON, CSV, XLSX, or via Apify API
- Retries: up to 4 tries with growing waits on temporary source errors
- Pagination: page number, 1-based, until the limit, an empty page or a page with no new products
- Concurrency: up to 3 keywords at a time; pages within a keyword in order
- Migration-safe: a restarted run continues where it stopped, without writing or charging any row twice

***

## Apify Actor - Terms of Service

**Version:** 4.0
**Effective Date:** May 5, 2026

***

### 0. ACCEPTANCE BY USE - IMPORTANT

**Read this section first.**

These Terms of Service ("Terms") form a binding legal agreement between you ("User," "you," "your") and UnseenUser, the Publisher of this Apify actor ("UnseenUser," "the Publisher," "we," "us," "our").

#### 0.1 How You Accept These Terms

You accept these Terms by **any of the following actions**, each of which constitutes a clear, affirmative act of acceptance:

- (a) **Running the Actor** - Initiating any execution of the Actor on the Apify platform
- (b) **Using any output** returned by the Actor for any purpose
- (c) **Continuing to access** the Actor's listing or documentation after these Terms are visible

#### 0.2 Continuing Acceptance

Each time you run the Actor or use its outputs, you reaffirm your acceptance of the then-current Terms. If you do not agree to these Terms or any subsequent update, you must stop using the Actor immediately.

#### 0.3 No Anonymous Acceptance

You cannot disclaim acceptance by:

- Failing to read these Terms before running the Actor
- Running the Actor through automated systems
- Sharing your Apify account with others who may not have read these Terms

By the act of running the Actor on Apify, you bind yourself, your organization (if applicable), and any individuals or systems acting on your behalf or under your authority.

#### 0.4 If You Do Not Accept

**If you do not agree to these Terms, you must not run the Actor.** No use is authorized without acceptance.

***

### PREAMBLE - UNDERSTANDING THE ARCHITECTURE

Before using the Actor, please understand the technical architecture of the service:

#### The Data Flow

```
You (User) → Apify Platform → Actor (software) → Third-Party API → Source Platform
                                                       ↓
You (User) ← Apify Platform ← Actor (software) ← Third-Party API
```

#### What Each Party Does

- **You (the User):** Run the Actor on the Apify platform with input parameters you choose
- **Apify:** Operates the cloud infrastructure that hosts and executes Actors. Apify is a Czech-incorporated company (Apify Technologies s.r.o.) governed by its own Terms of Service.
- **The Publisher (us):** Publishes software code (the Actor) on Apify's platform. The Actor is a thin wrapper that translates your input into requests to a third-party API and returns the API's responses to you. **The Publisher does not operate scraping infrastructure. The Publisher does not store or retain data returned by the Actor. Because requests are made under the Publisher's provider accounts, copies of results may remain in those accounts as described in the Data Retention section of the Addendum. The Publisher does not access these copies except where needed to troubleshoot a run at the User's request. The Publisher does not see, log, or process the personal data of any individuals returned in the Actor's outputs beyond what is incidental to passing the data through.**
- **Third-Party API Provider:** JustOneAPI (https://justoneapi.com). This is an independent third-party company that operates data infrastructure that retrieves publicly listed product data from source platforms and returns it.
- **Source Platform:** AliExpress (Alibaba Group). This is the platform whose publicly visible data is accessed by the Third-Party API Provider.

#### Why This Matters

Your relationship with the Publisher is that of a **software user** to a **software vendor**. The Publisher has the responsibilities of a software vendor (functional code, accurate documentation) and the limits of one (the Publisher is not responsible for how you use the data you obtain).

***

These Terms operate alongside but do not replace:

- Apify's Terms of Service and Acceptable Use Policy (governing your relationship with Apify)
- JustOneAPI Terms of Service (governing the underlying data infrastructure)
- Source Platform terms (AliExpress (Alibaba Group)) governing the public data accessed
- Applicable law in your jurisdiction and the jurisdictions of data subjects

These Terms incorporate the actor-specific addendum published in each Actor's individual listing ("Addendum"). In the event of a conflict, the more restrictive provision applies.

***

### 1. NATURE OF THE SERVICE

#### 1.1 What the Actor Is

The Actor is a software program published on the Apify platform. Each Actor:

- (a) Accepts structured input from you on the Apify platform
- (b) Translates that input into HTTP requests to a third-party API operated by JustOneAPI
- (c) Receives HTTP responses from that third-party API
- (d) Returns the response data to you in a structured format on the Apify platform

The Actor's source code is hosted on Apify's infrastructure. The Actor runs in Apify's cloud, not on the Publisher's servers. The Publisher operates no servers running the Actor.

#### 1.2 What the Actor Is Not

The Actor is **not**:

- (a) A scraping tool - the Publisher does not operate scraping infrastructure, proxies, headless browsers, or fake accounts
- (b) A direct connection to any source platform - connections to source platforms are made by JustOneAPI
- (c) A data storage or data retention service - the Publisher does not maintain a database of any data the Actor returns. Because requests are made under the Publisher's provider accounts, copies of results may remain in those accounts as described in the Data Retention section of the Addendum. The Publisher does not access these copies except where needed to troubleshoot a run at the User's request.
- (d) A licensed access channel to AliExpress (Alibaba Group) or any other source platform
- (e) Affiliated with, endorsed by, sponsored by, or authorized by any source platform

#### 1.3 The Publisher's Limited Role

The Publisher's role is limited to:

- (a) Designing and writing the Actor's source code
- (b) Publishing the Actor on the Apify Store
- (c) Maintaining the Actor (updating it when API providers change schemas)
- (d) Providing documentation and customer support via Apify's contact mechanism

The Publisher is a software vendor, similar to a developer who publishes an app on the Apple App Store or Google Play Store. The Publisher is not a data provider, data broker, data processor, or data controller for purposes of GDPR, CCPA, Israel's Privacy Protection Law, or equivalent.

#### 1.4 The Third-Party API Provider's Role

JustOneAPI (https://justoneapi.com) is an independent third-party company. It:

- (a) Operates the data infrastructure that retrieves publicly listed product data from source platforms
- (b) Maintains its own data sources and collection methods
- (c) Provides its own Terms of Service governing its operations
- (d) Is responsible for compliance obligations relating to the data collection itself

The Publisher is a customer of this provider. The Publisher is not its agent, partner, or representative.

***

### 2. WHO MAY USE THE ACTOR

#### 2.1 Eligibility

You may use the Actor only if:

- (a) You are at least 18 years old or the age of majority in your jurisdiction
- (b) You have legal capacity to enter into binding contracts
- (c) You are not located in or resident of a country subject to comprehensive sanctions by the United States, European Union, United Kingdom, or Israel
- (d) You are not on any prohibited persons list

#### 2.2 User Representations

By using any Actor, you represent and warrant that:

- (a) **Truthful identity:** Information you provide about your identity and intended use is accurate
- (b) **Lawful intent:** Your intended use complies with applicable law in your jurisdiction
- (c) **Source platform compliance:** You will independently comply with the Terms of Service of any source platform whose data you obtain through the Actor
- (d) **Data subject rights:** Where Actor outputs include personal data, you will respect data subject rights under applicable law
- (e) **No prohibited use:** You will not use the Actor for any of the purposes prohibited in Section 4

These representations are continuous - they must remain true throughout your use.

***

### 3. PERMITTED USES

The Actor may be used for any lawful purpose, including:

- Market research and competitive analysis
- Academic research
- Journalism and investigative reporting
- Internal business intelligence
- Brand monitoring
- Recruitment research where consistent with applicable employment law
- Building products that further process publicly available information lawfully

Specific permitted uses for each Actor are described in that Actor's individual listing and Addendum.

***

### 4. PROHIBITED USES

You may not use the Actor for any of the following:

#### 4.1 Illegal Activity

Activity illegal under the law of your jurisdiction, the User's jurisdiction, or the jurisdiction of any data subjects.

#### 4.2 Harassment, Stalking, and Personal Targeting

- Compiling profiles for harassment, stalking, or doxxing
- Tracking individuals' movements or activities without their knowledge
- Building profiles of journalists, activists, dissidents, or vulnerable populations for retaliatory purposes

#### 4.3 Discrimination

- Using outputs for discriminatory employment, lending, housing, or insurance decisions based on protected characteristics
- Building lists for discriminatory purposes

#### 4.4 Spam and Unsolicited Commercial Communication

- Sending unsolicited marketing in violation of CAN-SPAM, CASL, GDPR, PECR, Israeli Anti-Spam Law (סעיף 30א לחוק התקשורת), or equivalent laws
- Building "lead lists" from scraped contacts without proper consent infrastructure
- Reselling contact data for spam purposes

#### 4.5 Fraud and Deception

- Identity theft or impersonation
- Generation of fake reviews, testimonials, or coordinated inauthentic behavior
- Election interference or political disinformation
- Securities fraud

#### 4.6 Source Platform Abuse

- Using outputs to circumvent technical protection measures of source platforms
- Creating fake accounts on source platforms based on Actor outputs
- Vote manipulation, engagement manipulation, or platform algorithm gaming
- Building services that competitively substitute for source platforms

#### 4.7 Reselling the Actor's Service

- Reselling raw Actor outputs as your own data product or scraping-as-a-service
- Sharing your Apify credentials to provide third parties indirect access
- Building competing API services using Actor outputs

#### 4.8 AI Training Without Authorization

- Using Actor outputs as training data for commercial AI/ML models without separate licensing authority from the source platform

#### 4.9 Sensitive Targeting

- Specifically targeting or profiling based on health conditions, sexual orientation, religious beliefs, political opinions, or other sensitive characteristics
- Targeting children under 16 (or local age of consent for data processing)

#### 4.10 Privacy Law Violations

- Processing personal data of EU/UK/California/Israeli residents without complying with applicable privacy law
- Failing to honor data subject access, deletion, or objection requests
- Processing data for purposes incompatible with its publication context

***

### 5. SOURCE PLATFORM TERMS - YOUR RESPONSIBILITY

#### 5.1 Acknowledgment

The Actor accesses publicly visible data on third-party platforms ("Source Platforms") through the Third-Party API Provider (JustOneAPI). Source Platforms include AliExpress (Alibaba Group).

#### 5.2 Your Sole Responsibility

You acknowledge:

- (a) **You are solely responsible for ensuring your downstream use of data obtained through the Actor complies with the Source Platform's Terms of Service**
- (b) The Publisher makes no representation that any specific use is permitted under any Source Platform's terms
- (c) The Third-Party API Provider, not the Publisher, bears responsibility for the lawfulness of the data collection itself
- (d) You should review Source Platform terms before commercial use:
  - AliExpress Terms of Use: https://terms.alicdn.com/legal-agreement/terms/suit_bu1_aliexpress/suit_bu1_aliexpress202204182115_66077.html
  - JustOneAPI Terms of Service: https://justoneapi.com/en/terms

#### 5.3 Cease-and-Desist Compliance

If you receive a cease-and-desist letter or other legal demand from a Source Platform regarding your use of Actor outputs, you must:

- (a) Cease the contested use immediately
- (b) Notify UnseenUser within 48 hours via UnseenUser's Apify profile contact form (https://apify.com/UnseenUser)
- (c) Cooperate with the Publisher as needed to mitigate
- (d) Not assert against the Publisher any claim arising from your inability to use the Actor for that Source Platform

***

### 6. DATA PROTECTION - REFLECTING ACTUAL ARCHITECTURE

#### 6.1 Roles Under Privacy Law

For purposes of GDPR, UK GDPR, CCPA, Israel's Privacy Protection Law (PPL) including Amendment 13, and equivalents:

- **You (the User) are the Data Controller** of any personal data you obtain through the Actor and subsequently process for your own purposes
- **JustOneAPI** is the entity that collects data from source platforms (AliExpress (Alibaba Group)) - it bears the responsibilities of a data processor or controller (depending on context) for the collection itself
- **The Publisher acts solely as a software vendor**, not as a data controller or processor, because the Publisher does not store, retain, or substantively process personal data - the Actor merely passes API responses through. Because requests are made under the Publisher's provider accounts, copies of results may remain in those accounts as described in the Data Retention section of the Addendum. The Publisher does not access these copies except where needed to troubleshoot a run at the User's request.

#### 6.2 No Data Retention by the Publisher

The Publisher confirms:

- (a) The Publisher does not maintain a database of personal data obtained through the Actor. Because requests are made under the Publisher's provider accounts, copies of results may remain in those accounts as described in the Data Retention section of the Addendum. The Publisher does not access these copies except where needed to troubleshoot a run at the User's request.
- (b) The Actor passes data from the Third-Party API directly to you on the Apify platform - data does not flow through the Publisher's infrastructure
- (c) Apify's standard execution and operational logging may include limited information about Actor runs (input parameters, run duration, data volume) - this is governed by Apify's own privacy practices
- (d) The Publisher does not access, view, or analyze your Actor outputs except as needed for technical support if you specifically share them with the Publisher

#### 6.3 Your Obligations as Data Controller

Where your use of the Actor involves processing personal data, you are responsible for:

- (a) Establishing a lawful basis for your processing (consent, legitimate interest with documented balancing test, contract, etc.)
- (b) Providing transparent notice to data subjects as required by applicable law
- (c) Honoring data subject access, rectification, erasure, restriction, and portability requests
- (d) Implementing appropriate security measures
- (e) Conducting Data Protection Impact Assessments where required
- (f) Appointing a Data Protection Officer if your operations require one
- (g) Registering databases with applicable supervisory authorities
- (h) Honoring opt-out requests for direct marketing
- (i) Cross-border transfer safeguards where data crosses borders

#### 6.4 Israel's Amendment 13 - User Compliance

If your use of the Actor involves Israeli residents' personal data, you must comply with the Privacy Protection Law as amended (Amendment 13, effective August 14, 2025). These obligations are yours as the data controller, not the Publisher's as the software vendor.

#### 6.5 Sensitive Data Targeting Restrictions

You will not use the Actor to specifically target, profile, or build datasets focused on:

- Health or medical conditions
- Religious beliefs
- Political opinions
- Sexual orientation or gender identity
- Genetic or biometric data
- Criminal history
- Children under 16

***

### 7. INTELLECTUAL PROPERTY

#### 7.1 Actor Code

The Actor's source code, schemas, documentation, and branding are owned by the Publisher. You receive a limited, non-exclusive, non-transferable, revocable license to use the Actor for permitted purposes during your active subscription/run with Apify.

#### 7.2 Output Data

The Publisher claims no ownership over the public data the Actor returns. Source Platforms may have copyright, database rights, or other rights in their data; data subjects may have copyright in user-generated content. Your use of output data must respect these rights independently.

#### 7.3 Restrictions

You may not reverse engineer, decompile, or reuse the Actor's code in a competing actor.

#### 7.4 Feedback

Feedback you provide may be used by the Publisher to improve products without compensation to you.

***

### 8. PRICING AND PAYMENT

#### 8.1 Apify Platform Billing

Pricing is administered through Apify's pricing models. Apify processes all payments. Apify's payment terms govern refunds and disputes.

#### 8.2 Pricing Changes

The Publisher may change Actor pricing with at least 14 days' notice via the Actor's Apify listing.

#### 8.3 No Refunds for Misuse

If your access is suspended or terminated for breach of these Terms, you forfeit any unused balance and are not entitled to refunds.

***

### 9. SERVICE AVAILABILITY AND CHANGES

#### 9.1 No Uptime Guarantee

The Actor depends on:

- (a) The Apify platform
- (b) Underlying API provider (JustOneAPI)
- (c) Source Platforms' continued public accessibility

Any of these may change behavior, restrict access, or become unavailable without notice. The Publisher makes no uptime guarantees.

#### 9.2 Service Discontinuation

The Publisher may discontinue any Actor at any time. Reasonable notice will be provided when feasible.

***

### 10. DISCLAIMERS

#### 10.1 "AS IS" Service

THE ACTOR IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTIES OF ANY KIND, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR PURPOSE, NON-INFRINGEMENT, OR ACCURACY OF DATA.

#### 10.2 No Representation of Lawfulness

The Publisher makes no representation that your specific use of the Actor or the data it returns is lawful in your jurisdiction or under any Source Platform's terms. The burden of determining lawfulness for your use case is yours.

#### 10.3 No Endorsement of Source Content

Content returned by the Actor was created by third parties. The Publisher does not endorse, verify, or take responsibility for it.

***

### 11. LIMITATION OF LIABILITY

#### 11.1 Aggregate Liability Cap

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL THE AGGREGATE LIABILITY OF THE PUBLISHER FOR ALL CLAIMS RELATING TO THE ACTOR EXCEED THE GREATER OF:

- (a) ONE HUNDRED U.S. DOLLARS (US $100), OR
- (b) THE AMOUNTS YOU PAID THROUGH APIFY FOR USE OF THE ACTOR IN THE THREE (3) MONTHS IMMEDIATELY PRECEDING THE EVENT

#### 11.2 Excluded Damages

THE PUBLISHER IS NOT LIABLE FOR INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES, OR FOR LOSS OF PROFITS, REVENUE, OR DATA, EVEN IF ADVISED OF THE POSSIBILITY.

#### 11.3 Time Limit

Any claim must be brought within one (1) year of the event.

***

### 12. INDEMNIFICATION

#### 12.1 Your Indemnification of the Publisher

You agree to defend, indemnify, and hold harmless the Publisher from any:

- Claims arising from your use of the Actor
- Claims arising from your violation of these Terms
- Claims arising from your violation of any law (including privacy law)
- Claims arising from your violation of any Source Platform's Terms of Service
- Claims arising from your processing of personal data obtained through the Actor
- Reasonable attorneys' fees and costs of defending such claims

#### 12.2 Defense

The Publisher may assume defense at your expense. You will cooperate with the Publisher's defense.

#### 12.3 Scope

The indemnification covers reasonable, foreseeable third-party claims arising from your use. It does not extend to:

- Claims arising from the Publisher's gross negligence or willful misconduct
- Claims regarding the Actor's source code itself (those are the Publisher's responsibility)
- Claims regarding the Third-Party API Provider's data collection (those are their responsibility)

***

### 13. SUSPENSION AND TERMINATION

#### 13.1 Termination by the Publisher

The Publisher may terminate your access for material breach, illegal use, breach of warranty, or upon credible legal demand.

#### 13.2 Effects of Termination

Your license ends, you must cease use, and applicable provisions survive.

#### 13.3 Termination by You

You may stop using the Actor at any time on Apify.

***

### 14. DISPUTE RESOLUTION

#### 14.1 Informal Resolution First

Send a detailed written description of the dispute via UnseenUser's Apify profile contact form (https://apify.com/UnseenUser) and wait 60 days for resolution attempt before any formal claim.

#### 14.2 Governing Law

These Terms are governed by the substantive laws of the State of Israel, without regard to conflict of law principles.

#### 14.3 Exclusive Jurisdiction

Any dispute shall be brought exclusively in the competent civil courts of Tel Aviv-Jaffa, Israel.

#### 14.4 No Class Actions

You agree to bring claims only in your individual capacity.

#### 14.5 Attorneys' Fees

The prevailing party recovers reasonable attorneys' fees.

***

### 15. MISCELLANEOUS

#### 15.1 Entire Agreement

These Terms (with Addendum and incorporated documents) are the entire agreement.

#### 15.2 Severability

Unenforceable provisions are reformed to the minimum extent or severed.

#### 15.3 Assignment

You may not assign without the Publisher's consent. The Publisher may assign to affiliates, successors, or acquirers.

#### 15.4 Force Majeure

Neither party is liable for failure due to events beyond reasonable control, including changes by Source Platforms or the Third-Party API Provider, or actions by Apify.

#### 15.5 Third-Party Beneficiaries

Apify and JustOneAPI are intended third-party beneficiaries of Sections 4 (Prohibited Uses), 5 (Source Platform Compliance), and 12 (Indemnification).

#### 15.6 Survival

Sections 0 (Acceptance), 4, 5, 6, 7, 10, 11, 12, 14, and 15 survive termination.

#### 15.7 Language

English controls. Translations are for convenience only.

#### 15.8 Publisher Identification for Legal Process

The Publisher operates on the Apify platform under the username **UnseenUser** (apify.com/UnseenUser). The Publisher is a registered legal entity. Upon receipt of valid legal process (subpoena, court order, or equivalent) directed through Apify's official channels, the Publisher's full legal identity may be disclosed as required by law. This Section ensures that you have a valid path to legal recourse if needed.

***

### 16. ACKNOWLEDGMENT

By using any Actor, you acknowledge that:

- (a) You have read these Terms
- (b) You understand the architecture: you are using software (the Actor) on Apify's platform that calls third-party APIs
- (c) You accept responsibility for your use, including for compliance with Source Platform terms
- (d) Your indemnification obligations cover third-party claims arising from your use
- (e) Disputes are resolved in Israeli courts
- (f) The Publisher's identity, while not publicly disclosed in this listing, can be obtained through valid legal process via Apify

For questions, use UnseenUser's Apify profile contact form (https://apify.com/UnseenUser) before running the Actor.

***

### APPENDIX - Document Version History

| Version | Date | Summary |
|---------|------|---------|
| 1.0 | May 5, 2026 | Initial publication |
| 2.0 | May 5, 2026 | Hardened (over-broad - treated User as data broker) |
| 3.0 | May 5, 2026 | Architecturally accurate - Publisher as software vendor |
| 4.0 | May 5, 2026 | **Anonymous Publisher.** All personally identifying information removed. Acceptance-by-Use mechanism formalized. |

***

*These Terms reflect best practices for anonymous Apify actor publishing as of May 2026. Not a substitute for legal advice. Consult qualified Israeli commercial counsel before deploying.*

***

### 🛡️ Actor-Specific ToS Addendum - 🛒 AliExpress Product Search

This addendum supplements the Master Terms of Service V4.0. By running this Actor, you accept both the Master ToS and this addendum.

#### A. Architectural Disclosure

This Actor is a software wrapper. It accepts your input parameters, calls 1 JustOneAPI endpoint (/api/aliexpress/search-products/v1), and returns the response data to you on the Apify platform. UnseenUser does not store, log, or substantively process the data returned. Because requests are made under UnseenUser's JustOneAPI account, copies of results may remain in that account as described in the Data Retention section below. UnseenUser does not access these copies except where needed to troubleshoot a run at the User's request. The data flows from JustOneAPI through Apify's runtime directly to you.

JustOneAPI is an independent company. Neither UnseenUser nor JustOneAPI claims any relationship with, authorization from, or endorsement by AliExpress or Alibaba Group.

#### Data Retention

Just One API: Requests are made through the Publisher's Just One API account. Just One API has not published a specific retention period for results linked to that account, so copies may remain in that account under Just One API's own policies. Where technically available, the Publisher can ask Just One API to delete records linked to its account, and will pass on a User's reasonable deletion request relating to that User's runs.

#### B. Nature of Data Returned

This Actor returns: publicly listed AliExpress product data from the search results pages for your keyword, ship-to country, currency and language. Each row contains the product ID, the product title, the current price shown in the search results and its currency, the sales count shown by AliExpress, the average star rating, the product page link, the main product image link, the listing type (organic, ad or promoted), the position and page in the results, and the run parameters (keyword, ship-to country, language, timestamp). One summary row per keyword reports the total number of results AliExpress displayed and why the keyword stopped. The Actor does NOT return buyer names, reviewer names, review text, seller names, seller contact details, store addresses or any other information about individual people. No geolocation, contact or biometric data is returned.

Where the Actor's output includes individual people's names, photos, contact details, or content authored by them, that data constitutes **personal data** subject to GDPR, CCPA, Israeli Privacy Protection Law (including Amendment 13), and equivalent privacy laws in your downstream processing - but **only in your hands as the data controller**, not in UnseenUser's hands as the software vendor.

In this Actor's normal output that situation is rare: a product title or product image could occasionally show a person (for example a model in a clothing photo) or a seller's own brand name that is also a person's name. Treat such content as personal data in your hands if it occurs.

#### C. Permitted Use Cases

You may use this Actor for the following purposes (non-exhaustive list):

- **Dropshipping product research** - find best-selling products for a niche by sorting on sales and reading the sales count and rating of each listing
- **Price tracking** - run the same keywords on a schedule and compare current prices per ship-to country and currency
- **Competitive monitoring** - see which products and brands rank first for your category keywords and which positions are paid ads
- **Market research** - estimate how crowded a product category is from the number of listings, price spread and sales counts
- **Localization research** - compare the same search in Germany, Brazil, Japan or Saudi Arabia to see local titles, prices and rankings
- **Catalog sourcing** - build a shortlist of candidate products with links and images for your own supplier review
- **Ad placement analysis** - measure how many results are ads or promoted listings for a keyword

#### D. Specifically Prohibited Uses

In addition to Master ToS Section 4 prohibitions, you may NOT:

- Copy AliExpress product listings (titles, images, prices) in bulk to build a competing marketplace, shop or price-comparison site that substitutes for AliExpress
- Republish seller product images or titles in your own store or ads without the rights holder's permission
- Use the data to find, source or resell counterfeit goods or products that infringe trademarks, designs or patents
- Publish misleading price claims (for example a fake "was" price or "lowest price ever") based on prices that were limited-time or new-buyer deals in one region
- Use sales counts or ratings to create fake reviews, fake sales figures or manipulated rankings on AliExpress or any other marketplace
- Use the ship-to country, currency or results to arrange purchases or shipments that breach sanctions or export controls that apply to you
- Present the data as an official AliExpress or Alibaba Group data feed, or suggest any partnership with them
- Use the Actor to target products at children in breach of child protection, toy safety or advertising law

#### E. Platform Terms of Service Considerations

AliExpress's Terms of Use prohibit the systematic retrieval of site content "to create or compile" collections, "whether through robots, spiders, automatic devices or manual processes", without written permission, and restrict copying site content to run a competing business or otherwise exploit it commercially (AliExpress.com Terms of Use, clause 3.2(a); clause 5.6(h) also protects its directories, databases and listings). Alibaba Group actively enforces its intellectual property and anti-counterfeiting programs. This Actor accesses publicly listed AliExpress data via the data provider named in Section A - that provider bears responsibility for the lawfulness of the data collection. Your downstream use must independently comply with AliExpress's Terms of Use.

If AliExpress issues a cease-and-desist regarding data obtained via this Actor, notify UnseenUser within 48 hours via the Apify profile contact form (apify.com/UnseenUser) and cease your use immediately.

#### F. Prices Are Regional and Point-in-Time

Every price this Actor returns is the price AliExpress showed for one ship-to country, one currency and one moment. In the live tests:

- The same product showed different prices in different currencies and countries (for example one phone case at 5.09 USD with ship-to US and 4.62 EUR with ship-to US)
- Many US results showed a price of 1.09, which looks like a new-buyer or first-order deal rather than the regular price
- The original (pre-discount) price was never available in the search results

You must therefore:

- Not present a returned price as the product's regular, permanent or worldwide price
- Not use a price from one country to make claims to shoppers in another country
- Not build "price drop" or "lowest price" claims for consumers without checking them against the live product page, because consumer protection laws (for example the EU Omnibus Directive on price reductions, the US FTC Guides Against Deceptive Pricing, the Israeli Consumer Protection Law) regulate such claims
- Keep the `scrapedAt`, `shipTo` and `currency` fields with every price you store, so the context is never lost

UnseenUser does not guarantee that a price is still valid after the run, or that a buyer will be charged that price.

#### G. Listing Types and Paid Placement

AliExpress mixes organic results with paid placements. The Actor labels them from the source data:

| `listingType` | Source value | Meaning |
|---|---|---|
| `organic` | `natural` | Normal search result |
| `ad` | `ad` | Paid ad placement |
| `promoted` | `gem` | Promoted listing |

In the live test, 44 of 265 results (17%) were ads and 10 (4%) were promoted. The Actor never drops paid rows, because they are part of what a shopper sees. If you report "top products" or "best sellers" to others:

- ✅ "Top 20 results for 'phone case' in Germany, 4 of them ads" - permitted, accurate
- ✅ Filter out `ad` and `promoted` rows yourself when you need organic rankings only - permitted
- ❌ Presenting paid placements as independent rankings or recommendations - misleading
- ❌ Calling a position "rank #1 on AliExpress" when it was an ad slot - misleading

#### H. Product Images, Titles and Brand IP

Product images and titles are created by sellers and may be protected by copyright. Many listings also use brand names and trademarks (for example "iPhone", "Samsung Galaxy", "Hello Kitty" appeared in the test results), and some may be unauthorized or counterfeit goods. The appearance of a brand name in a title does not mean the product is genuine or licensed.

You may:

- **Analyze** titles, prices and images for research (typically lawful)
- **Link** to the product page using `productUrl`
- **Show images internally** for your own sourcing review

You may NOT:

- **Republish images or titles** in your own store, ads or catalog without the rights holder's permission
- **Use listings that show third-party brands** as proof that you may sell those brands
- **Source or resell counterfeit goods** found through this Actor (trademark and customs laws in the EU, US, Israel and most countries impose seizure, damages and criminal penalties)
- **Train AI image or text models** on the images and titles without proper licensing - AliExpress's Terms of Use restrict compiling and commercially exploiting site content, and sellers own their content

If a rights holder contacts you about content you obtained through this Actor, handle it yourself as the data controller and content user; UnseenUser does not host the content.

#### I. Search Result Reliability

This Actor returns what AliExpress returned at the moment of the run. Known limits from the live tests:

- **Closest matches, not exact matches:** a nonsense keyword ("zxqvbnmlkjqwpo asdfghqwe") still returned 9 unrelated products. Check titles before treating results as relevant
- **Reported totals are not real counts:** `totalResultsReported` was often exactly 60000 (a display cap) and changed between pages of the same search (11662 on page 1, 4994 on page 2, 45716 on page 60)
- **Repeats:** a few products appear again on later pages. By default they are written once per keyword
- **Page size:** usually 20 products, sometimes 17-19
- **Temporary failures:** AliExpress sometimes refuses a request. The Actor retries, and if a keyword still fails it writes one uncharged SOURCE_UNAVAILABLE row and continues
- **Countries and languages:** only the 23 countries, 18 currencies and 13 languages that returned results reliably are offered; others (UK, Portugal, Ukraine, Hebrew) are left out
- **Rankings change:** order, prices and sales counts change during the day and between runs

| Use | Status |
|---|---|
| Comparing your own keywords weekly for internal research | ✅ Permitted |
| Building a sourcing shortlist from the top results | ✅ Permitted |
| Citing sales counts as approximate popularity signals | ✅ Permitted, with the run date |
| Publishing sales counts or totals as audited market figures | ❌ Misleading - the source does not guarantee them |
| Mirroring AliExpress's full catalog for resale | ❌ Prohibited - see Sections D and E |

#### J. Seller and Buyer Data Not Collected

This Actor is deliberately limited to product listing data:

- It does not call any product detail, seller, store or reviews endpoint
- It returns no buyer, reviewer or seller names, no contact details, no store addresses and no review text
- A personal-field scan of all live test responses found no personal data

You may NOT use the Actor's output as a starting point to:

- Identify, contact or profile individual sellers or buyers
- Combine product rows with other sources to build profiles of the people behind stores
- Send unsolicited marketing to sellers found through product links (Master ToS Section 4.4 applies, including Israeli Anti-Spam Law)

If you need seller or review data, this Actor is not the right tool, and any such collection would need its own lawful basis and review.

# Actor input Schema

## `keywords` (type: `array`):

One AliExpress search per line, in any language. Empty lines are ignored and a repeated keyword runs once.

## `maxProductsPerKeyword` (type: `integer`):

Maximum products to return for each keyword. 0 = all results. Minimum 0. Default 100. AliExpress returns up to 20 products per page. Free Apify plan: up to 5 results per run, whatever this field says; paid plans: no limit.

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

Order of the results.

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

Only products priced at or above this amount. Minimum 0. Must not be higher than the maximum price.

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

Only products priced at or below this amount. Minimum 0.

## `shipTo` (type: `string`):

The country AliExpress shows prices and results for. Prices and rankings change by country.

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

Currency for prices. Auto = the ship-to country's own currency. Any currency works with any country.

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

Language of the product titles. Works with any ship-to country.

## `includeRepeats` (type: `boolean`):

When on, products that appear again on later pages are written again, marked isRepeat: true. When off, each product is written once per keyword.

## Actor input object example

```json
{
  "keywords": [
    "wireless earbuds"
  ],
  "maxProductsPerKeyword": 100,
  "sort": "default",
  "shipTo": "US",
  "currency": "auto",
  "language": "en_US",
  "includeRepeats": false
}
```

# Actor output Schema

## `products` (type: `string`):

One row per product per keyword, plus uncharged explanation rows. Opens the Products view.

## `errorsAndInfo` (type: `string`):

The same dataset in the Errors and info view: keyword summaries, keywords with no results and why a run stopped.

## `runSummary` (type: `string`):

Totals per keyword and the final status message of the run.

# 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 = {
    "keywords": [
        "wireless earbuds"
    ],
    "maxProductsPerKeyword": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("unseenuser/aliexpress-product-search").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 = {
    "keywords": ["wireless earbuds"],
    "maxProductsPerKeyword": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("unseenuser/aliexpress-product-search").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 '{
  "keywords": [
    "wireless earbuds"
  ],
  "maxProductsPerKeyword": 100
}' |
apify call unseenuser/aliexpress-product-search --silent --output-dataset

```

## MCP server setup

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

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/KUu6AvClsIglQSb0T/builds/yBi14a69kAE5SQ2pg/openapi.json