E-commerce & Marketplaces

How do you scrape AliExpress products via API without getting blocked?

To scrape AliExpress products without rotating proxies or a headless browser, call ReefAPI's AliExpress search endpoint with a query and read the returned products as structured JSON.

AliExpress engineLive JSON4 steps1,000 free credits
Get a free keyOpen in playground

This guide demonstrates the real AliExpress API engine with a captured response from . The example is only published because the engine passed the SEO snapshot gate.

Use case

Dropshipping research, price monitoring, catalog enrichment and marketplace analytics.

AliExpress docsE-commerce & Marketplaces hubOpen in playground
Step by step

Call the live endpoint

  1. 1

    Pick a search query

    Start with a specific product or keyword so the response stays relevant and easy to review.

  2. 2

    Call aliexpress/v1/search

    Send the query param from the captured example with your ReefAPI key in the x-api-key header.

  3. 3

    Normalize products from data

    Store product id, title, price, rating, order count and the canonical product URL for your workflow.

  4. 4

    Check meta before charging jobs

    Use meta.record_count, latency_ms and error to confirm a clean response before downstream pricing.

Code

Copy the request

These snippets use the captured request params for aliexpress/v1/search.

curl -X POST https://api.reefapi.com/aliexpress/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"wireless earbuds","country":"US","currency":"USD"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.aliexpress.search with {"query":"wireless earbuds","country":"US","currency":"USD"}.
Real response

Captured output from ReefAPI

Captured on UTC. The response below is the committed snapshot, including the API envelope and metadata.

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/aliexpress/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "wireless earbuds",
    "country": "US",
    "currency": "USD"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "aliexpress",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 2098.7,
    "record_count": 59,
    "bytes": 728594,
    "cache_hit": false,
    "version": "0.1",
    "page": 1,
    "pages_fetched": 1,
    "pagination": {
      "page": 1,
      "has_more": true
    },
    "attempts": 1
  },
  "data": {
    "query": "wireless earbuds",
    "country": "US",
    "currency": "USD",
    "results": [
      {
        "product_id": "[redacted-phone]",
        "title": "Air Pro4 wireless earphones Bluetooth 5.3 in ear earphones suitable for sports, gaming, and office work, compatible with all ear",
        "url": "https://www.aliexpress.com/item/[redacted-phone].html",
        "image": "https://ae-pic-a1.aliexpress-media.com/kf/Sb291d389a51541a397c[redacted-phone]a908R.jpg",
        "images": [
          "https://ae-pic-a1.aliexpress-media.com/kf/Sb291d389a51541a397c[redacted-phone]a908R.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/Sf7c08b39370d4742afdb890568b6dd21W.jpg",
          "https://ae-pic-a1.aliexpress-media.com/kf/Sf1e60fd679864b7e8de94594d9aa0876g.jpg"
        ],
        "price": 8.97,
        "original_price": 43.03,
        "currency": "USD",
        "discount_pct": 79,
        "price_formatted": "US $8.97",
        "sold_count": 321,
        "sold_text": "321 sold",
        "rating": 4.9,
        "store_name": null,
        "store_url": null,
        "product_type": "natural",
        "promo_tags": [
          "New shoppers save $34.06",
          "Lowest price in 90 days"
        ],
        "sku_id": "[redacted-phone]"
      },
      {
        "product_id": "[redacted-phone]",
        "title": "TWS Sports Wireless Bluetooth Headphones AI Translator Earbuds In-Ear Noise Reduction Microphone",
        "url": "https://www.aliexpress.com/item/[redacted-phone].html",
        "image": "https://ae-pic-a1.aliexpress-media.com/kf/Sc0a735c[redacted-phone]bdd17af838e2b69cA.png",
        "images": [
          "https://ae-pic-a1.aliexpress-media.com/kf/Sc0a735c[redacted-phone]bdd17af838e2b69cA.png",
          "https://ae-pic-a1.aliexpress-media.com/kf/Sdce9dd30db0c4f73b6a442a369fd6da3l.png",
          "https://ae-pic-a1.aliexpress-media.com/kf/S2dae[redacted-phone]ca30fa5e3ba390r.png"
        ],
        "price": 0.99,
        "original_price": 16.92,
        "currency": "USD",
        "discount_pct": 94,
        "price_formatted": "US $0.99",
        "sold_count": 133,
        "sold_text": "133 sold",
        "rating": 4.9,
        "store_name": null,
        "store_url": null,
        "product_type": "natural",
        "promo_tags": [
          "New shoppers save $15.93"
        ],
        "sku_id": "[redacted-phone]"
      },
      {
        "product_id": "[redacted-phone]",
        "title": "HD Screen Wireless Earphones Bluetooth Music Earbuds HTC NE68 150 Languages 30 hour Battery Life Clear Audio Comfortable Wearing",
        "url": "https://www.aliexpress.com/item/[redacted-phone].html",
        "image": "https://ae-pic-a1.aliexpress-media.com/kf/S0be9cd0fe[redacted-phone]da1152ed585fdbD.png",
        "images": [
          "https://ae-pic-a1.aliexpress-media.com/kf/S0be9cd0fe[redacted-phone]da1152ed585fdbD.png",
          "https://ae-pic-a1.aliexpress-media.com/kf/Saec7ecbbd9b6405a8e7dd6eff8a0a9c1Y.png",
          "https://ae-pic-a1.aliexpress-media.com/kf/S13077a2999c64a22bca07f9f46ec0b84r.png"
        ],
        "price": 19.63,
        "original_price": 43,
        "currency": "USD",
        "discount_pct": 54,
        "price_formatted": "US $19.63",
        "sold_count": 900,
        "sold_text": "900+ sold",
        "rating": 4.9,
        "store_name": null,
        "store_url": null,
        "product_type": "natural",
        "promo_tags": [
          "Save $23.37",
          "Free shipping"
        ],
        "sku_id": "[redacted-phone]"
      }
    ],
    "related_searches": [
      "wireless earrings earbuds",
      "aptx wireless earbuds",
      "wireless earbuds ear hook"
    ],
    "ranking_searches": [
      "wireless headphones",
      "white earbuds",
      "ear buds"
    ]
  }
}
Manual way

Why this is hard manually

AliExpress loads product data through dynamic endpoints, varies by region and currency, and blocks datacenter IPs fast. A scraper built for one query breaks on pagination, currency, shipping variants and locale changes.

Normalizing title, price, rating, order count and the canonical product URL into a stable shape across regions is where most DIY AliExpress scrapers fall apart.

ReefAPI way

Why ReefAPI solves it

ReefAPI wraps the working AliExpress engine behind one POST request and returns the standard envelope: ok, data, meta and error. The live snapshot on the AliExpress API page shows a real search call returning products with title, price, rating and orders.

Use it for dropshipping tools, repricing dashboards, catalog enrichment or AI agents — without maintaining a scraper or proxy pool.

FAQ

Questions developers ask

Do I need an AliExpress account?

No. You call ReefAPI with your x-api-key; no AliExpress account or affiliate key is required for public product data.

Why does my AliExpress scraper keep getting blocked?

AliExpress scraping needs rotating residential IPs and the right headers to clear anti-bot checks. ReefAPI handles that and returns live JSON; blocked or failed calls are free.

What product fields come back?

The captured response includes product ids, titles, prices, ratings, order counts and canonical product URLs.

Can I monitor prices over time?

Yes. Run the search on a schedule, store product ids and prices, and compute changes in your own database.