AliExpress-API

AliExpress-Suche-API

Search AliExpress by keyword with optional sort, price-range, page, ship-to country and currency, and get title, price, original price, units sold and image for each product in one normalized response.

POST/v1/run/aliexpress.search
Verfügbarkeit
100,00%
30d · 1 Aufruf
Anfragen
1
30d
Antwort
3,2s
Median · 30d

Preise und Anbieter

Preise der AliExpress-Suche-API: eine API, 2 austauschbare Anbieter

Der günstigste Anbieter bedient zuerst. Fällt er aus, übernimmt der nächste im selben Aufruf.

Du zahlst
8,50 USD
0,85 USD/1k Anfr., nur für das, was du nutzt. Kein Monatstarif.
Deine ersten 117 Anfragen sind mit dem Startguthaben von 0,10 USD kostenlos.

Ausprobieren

AliExpress Suche mit einer Anfrage abrufen

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `shipFrom`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Öffnen in
Beispielantwort
Kostenlose Läufe liefern nur die ersten 3 Ergebnisse. Lade einen Schlüssel auf, um die vollständige Antwort zu bekommen.
{
  "data": {
    "items": [
      {
        "currency": "USD",
        "deliveryDaysMax": 42,
        "deliveryDaysMin": 42,
        "image": "https://example.com/image.jpg",
        "images": [
          "https://example.com/image.jpg"
        ],
        "isChoice": true,
        "isSponsored": true,
        "listedUtc": 12.5,
        "originalPrice": 19.99,
        "price": 19.99,
        "productId": "a1b2c3d4",
        "rating": 4.6,
        "shipFrom": "example",
        "skuId": "a1b2c3d4",
        "soldCount": 12500,
        "storeName": "Example title",
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ],
    "totalResults": 12500
  },
  "found": true,
  "reason": "not_found"
}

Vollständige Parameter- und Antwortreferenz: jedes Feld, jeder Typ und jedes Beispiel für diesen Endpoint.

Referenz

Eine Anfrage, eine Antwortstruktur.

Jedes Feld, das du sendest, und jedes Feld, das du zurückbekommst, jeweils mit einem echten Beispiel.

Zuletzt geprüft 2026-10-23 · Verfügbarkeit und Latenz gemessen über 30d

Request-Body

JSON, per POST an diesen Endpoint gesendet.

  • querystring

    minecraft room projector

    Search keywords, e.g. "wireless earbuds".

  • countrystring

    Ship-to country as a 2-letter ISO code, e.g. US or DE. It changes prices, availability and delivery estimates.

  • currencystring

    Price currency as a 3-letter ISO code, e.g. USD or EUR.

  • maxPricenumber

    Optional maximum product price, in the requested currency.

  • minPricenumber

    Optional minimum product price, in the requested currency.

  • pageinteger

    1-based results page of about 60 products; AliExpress serves no results past page 60. Each page is billed as one request.

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `shipFrom`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.

  • sortenum

    Result order: best_match (AliExpress relevance, the default), best_seller (most orders first), price_low, or price_high.

Du sendest. Ein kleiner JSON-Body. Die gezeigten Werte sind Beispiele, die du durch deine eigenen ersetzt.

Antwort

JSON, ein Beispielwert pro Feld.

each itemdata.items[]

Matching AliExpress product cards for the requested page. Populated whenever the provider has data for the entity.

  • currencystring

    Price currency code, e.g. "USD", or null when no price is shown. Populated whenever the provider has data for the entity.

  • deliveryDaysMaxintegerkann erfordern

    Most days the estimated delivery to the requested country takes, or null when not reported.

  • deliveryDaysMinintegerkann erfordern

    Fewest days the estimated delivery to the requested country takes, or null when not reported.

  • imagestring

    Primary product image URL, or null when the card shows none. Populated whenever the provider has data for the entity.

  • imagesstring[]

    Every product image URL the card carries, primary first; empty when the card shows none.

  • isChoicebooleankann erfordern

    True when the product carries the AliExpress Choice badge, or null when the serving source does not report it.

  • isSponsoredboolean

    True when the card is a paid placement, or null when not reported.

  • listedUtcnumberkann erfordern

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. The day the product was first listed, as midnight UTC of that date; null when the serving source does not report it.

  • originalPricenumber

    Price before the current discount, or null when the product is not discounted.

  • pricenumber

    Current price in the requested currency, or null when the card shows no price. Populated whenever the provider has data for the entity.

  • productIdstring

    AliExpress product id, the number in the product URL; pass it to the AliExpress Product or AliExpress Reviews SKU. Populated whenever the provider has data for the entity.

  • ratingnumber

    Average customer rating, 0-5, or null when the product is unrated.

  • shipFromstringkann erfordern

    2-letter ISO code of the country the product ships from, e.g. "CN", or null when not reported.

  • skuIdstring

    Id of the product variant the card's price is for, or null when not reported.

  • soldCountinteger

    Number of units sold, or null when not shown. One source reads it from AliExpress's rounded label, so "60,000+ sold" comes back as 60000. Populated whenever the provider has data for the entity.

  • storeNamestringkann erfordern

    Name of the store selling the product, or null when the card does not show it.

  • titlestring

    Product title. Populated whenever the provider has data for the entity.

  • urlstring

    AliExpress product page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.

datadata

Search result wrapper, or null when nothing matched.

  • totalResultsintegerkann erfordern

    Total products AliExpress reports for the search, or null when the serving source does not report it.

top level
  • foundboolean

    True when the search returned at least one product.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Du bekommst zurück. Benannte, typisierte Felder in derselben Struktur, egal welche Quelle antwortet.

FAQ

Über die AliExpress-Suche-API

Die AnyAPI-AliExpress-Suche-API liefert AliExpress-Daten als normalisiertes JSON aus einem POST-Aufruf an /v1/run/aliexpress.search. Search AliExpress by keyword with optional sort, price-range, page, ship-to country and currency, and get title, price, original price, units sold and image for each product in one normalized response. AnyAPI routet jede Anfrage über 2 Quellen und weicht automatisch aus, wenn eine ausfällt. Sie kostet ab 0,85 USD pro 1.000 Anfragen, in US-Dollar, ohne Abo und ohne monatliches Minimum. In den letzten 30 Tagen waren 100,0% der AliExpress Suche-Aufrufe über AnyAPI erfolgreich, bei einer mittleren Antwortzeit von 3,2 Sekunden über 1 gemessene Aufrufe.

Sie kostet ab 0,85 USD pro 1.000 Anfragen, in US-Dollar, ohne Abo und ohne monatliches Minimum. Du lädst ein USD-Guthabenkonto auf, und jeder Aufruf bucht davon ab. Bei manchen fehlgeschlagenen, vom Guthabenkonto bezahlten Anfragen fallen Bearbeitungsgebühren an, die wir zum Selbstkostenpreis ohne Aufschlag weitergeben. Die Fehlerantwort zeigt den berechneten Betrag.

Search AliExpress by keyword with optional sort, price-range, page, ship-to country and currency, and get title, price, original price, units sold and image for each product in one normalized response. Die Antwort ist normalisiertes JSON mit demselben Envelope, den jeder AnyAPI-Endpoint liefert, sodass das Parsen eines zweiten Endpoints nur eine geänderte URL bedeutet.

In den letzten 30 Tagen waren 100,0% der AliExpress Suche-Aufrufe über AnyAPI erfolgreich, bei einer mittleren Antwortzeit von 3,2 Sekunden über 1 gemessene Aufrufe. Das sind AnyAPIs eigene Messungen des Traffics durch das Gateway, laufend neu berechnet, kein veröffentlichtes Service-Level-Ziel.

Ja. Ein neues AnyAPI-Konto startet mit 0,10 USD Gratis-Guthaben, ohne Karte. Das deckt 117 AliExpress-Suche-Aufrufe zu je 0,00085 USD.

AnyAPI fragt in derselben Anfrage die nächste seiner 2 Quellen, die günstigste zuerst, sodass der Ausfall einer Quelle deinen Aufruf nicht scheitern lässt.

Sende eine POST-Anfrage an https://api.getanyapi.com/v1/run/aliexpress.search mit deinem AnyAPI-Schlüssel in einem Header „Authorization: Bearer“ und der Eingabe als JSON-Body. Derselbe Schlüssel und dasselbe Guthabenkonto funktionieren bei jedem AnyAPI-Endpoint.

Nein. Du lädst US-Dollar auf ein Prepaid-AnyAPI-Guthaben, und jede Anfrage bucht davon ab. Es gibt keinen Monatstarif und kein Minimum, und dasselbe Guthaben bezahlt jeden AnyAPI-Endpoint.

Ja. Installiere @getanyapi/sdk von npm für TypeScript oder getanyapi von pip für Python. Beide rufen jeden AnyAPI-Endpoint mit demselben Schlüssel auf, und jeder HTTP-Client funktioniert ebenfalls.

Ja. Ein Agent kann sich mit dem AnyAPI-MCP-Server unter https://api.getanyapi.com/mcp verbinden oder mit einem unauthentifizierten POST an https://api.getanyapi.com/agent/signup einen eigenen kostenlosen Test-Schlüssel erstellen und diesen Endpoint über HTTP aufrufen.