logo
DE

1688 Keyword Search

Search 1688 by keyword and collect product listings with prices, sales counts and source links.

Original · en-USZur Übersetzung

DatenerfassungE-commerce & Retail1688 (Alibaba China)Products
Entwickler
super_ig
Preise
Ab 0,01 $ / 20 Datensätze
Zuletzt aktualisiert
2026-10-19

Übersicht

Keyword searches on 1688 can reveal several product styles, materials and listing variants behind the same buying need. Bringing those listings together makes it easier to review the available assortment without losing the original product titles and links needed for a closer look.

This collection pairs listing details with the search context that produced them. It provides a starting point for sourcing research and comparison, rather than replacing product-page checks or a conversation with a supplier about an eventual purchase.

Data notes

The data describes product listings collected from 1688 keyword searches. Results are delivered in ascending collection-time order, which is separate from the sorting used to select products during collection. Repeated product identifiers are consolidated across the delivered pages.

Product titles, listing status, price text and sales count text retain their source values. Price and Promotional price are not converted into another currency, and no assumptions are made about taxes, delivery charges or purchasing conditions. The sales measurement period and the time zone of Collection time are not specified.

Missing area, seller and shop details remain missing rather than being inferred from a product title. A blank preview does not assert that the corresponding source value is an empty string. The collection should not be treated as a verified supplier directory or a quotation for a particular order.

What the results look like

Each row represents a product listing. The examples retain the original titles; quoted Price and Sales count values are text, not converted numbers.

Product IDProduct titlePriceSales countKeyword
1065208644543Alcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16"85""0"iphone 18 pro max
816387948239适用苹果18promax手机壳插卡包翻盖iPhone17防摔16商务15真皮套14"158""0"iphone 18 pro max

Additional columns include Product URL, Image URL, Promotional price and Collection time.

Use cases

  • Compare an assortment: group Product title by recurring material or design terms, then use Product ID and Product URL to inspect the distinct listings behind each group.
  • Review displayed pricing: compare Price with Promotional price for listings with similar Product title wording, keeping the original price text and checking purchase conditions before drawing conclusions.
  • Prepare a sourcing shortlist: combine Keyword, Product title and Image URL to identify relevant candidates, and retain Collection time so later reviews can distinguish the collection snapshots.

Anwendungsbereich & Grenzen

One keyword per run; the requested collection target is 1–2,000 products, not a strict result limit. Whole-page collection may return fewer or more products. Fetch protection is 110 pages / 2,200 records; reaching this capacity does not establish completeness.

  • Geeignet für
  • Find 1688 listings for keyword-based product sourcing and comparison.
  • Nicht verwenden für
  • Do not use this for guaranteed real-time quotes, complete supplier profiles or a strictly capped result count.

Fehlerbehandlung

Vom Entwickler deklariertes Fehler- und Wiederholungsverhalten. Wir empfehlen, es bei der Integration in Ihren System-Prompt aufzunehmen.

  1. 1If submission times out or its outcome is unknown, check the existing run before submitting again: repeated submissions can create separate jobs.
  2. 2For rejected input or credentials, correct the input or access configuration before retrying.
  3. 3An empty result does not by itself mean that the source explicitly reported no data. Partial success may yield an incomplete collection; reaching the fetch protection capacity also requires a completeness check.

Eingabe

Parameter, die zum Aufruf dieser App erforderlich sind, generiert aus dem input.schema in der manifest.json.

  • Search keywordkeywordErforderlichstring
    Enter one 1688 product search keyword, from 1 to 512 characters.
    Beispieliphone 18 pro max
  • Expected product counttarget_countErforderlichstring
    Enter a whole number from 1 to 2000 as digits only. This is a collection target, not a strict cap; whole-page collection can return fewer or more products.
    Beispiel25
  • Collection sort ordersortOptionalstring(enum)
    Choose how products are ordered during collection; the default is relevance. Delivered results remain in ascending collection-time order.
    Zulässige WerteRelevancebidPrice: high to lowbid2Price: low to high_bid2Sales: high to lowsaleStandardbid
  • Start collection pagestartPageOptionalstring
    Specify the page number where collection starts. Enter a positive integer; when omitted, collection starts at page 1 by default. This does not change the expected product count.
    Standard1Beispiel2

Ausgabe

Feldstruktur eines einzelnen Datensatzes, generiert aus dem output.schema in der manifest.json.

  • Product IDproductIdstring
    1688 product identifier.
    Beispiel1065208644543
  • Product titleproductTitlestring
    Product title as collected, without translation.
    BeispielAlcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16
  • Product URLproductUrlstring
    Link to the 1688 product listing.
    Beispielhttps://detail.1688.com/offer/1065208644543.html
  • Image URLimageUrlstring
    Product image link as collected.
    Beispielhttps://cbu01.alicdn.com/img/ibank/O1CN01zUS1BK23KbTlWHRvp_!!2222667757237-0-cib.jpg

Beispieldaten

Aus output.schema erzeugt. Felder ohne Beispielwert verwenden strukturelle Platzhalter.

output.example
{
  "productId": "1065208644543",
  "productTitle": "Alcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16",
  "productUrl": "https://detail.1688.com/offer/1065208644543.html",
  "imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01zUS1BK23KbTlWHRvp_!!2222667757237-0-cib.jpg",
  "price": "85",
  "promotionPrice": "85",
  "saleCount": "0",
  "keyword": "iphone 18 pro max",
  "sourceItem": "iphone 18 pro max",
  "status": "有效",
  "tagPercent": "25%",
  "area": "<area>",
  "pageNum": "<pageNum>",
  "sellerName": "<sellerName>",
  "shopId": "<shopId>",
  "shopName": "<shopName>",
  "crawlTime": "2026-10-10T18:07:09",
  "createdAt": "1791626829270",
  "task_item": "iphone 18 pro max",
  "task_no_data": false
}

Integration

Diese App kann über MCP, API, SDK oder Dateiexport integriert werden — alle Kanäle teilen sich dieselben Fähigkeiten und Preise. Jede Anfrage authentifiziert sich über den Authorization: Bearer-Header mit einem API Key (langlebig, in der Data Hub Konsole erstellt); MCP-Clients können sich zusätzlich per OAuth ohne Key anmelden. Weitere Optionen wie CLI und Skill sind in Vorbereitung. Diese App läuft asynchron und kann zwischendurch abgebrochen werden: Nach dem Abbruch stoppt der Lauf. Bereits gelieferte Datensätze bleiben erhalten und werden abgerechnet.

Über das MCP (Model Context Protocol) können Sie diese App direkt aus KI-Clients wie Claude und Cursor aufrufen. Wählen Sie Ihren Client und den Authentifizierungsmodus und kopieren Sie dann die Konfiguration unten.

Client-Konfiguration

Ersetzen Sie den Wert nach Bearer durch Ihren langlebigen API Key. Funktioniert in jedem Client, in CI und in Headless-Umgebungen.

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=super_ig/alibaba1688-keyword-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
Meine API Keys anzeigen →

Lassen Sie die KI die Einrichtung übernehmen

Sie möchten Konfigurationen nicht von Hand bearbeiten? Kopieren Sie den Installations-Prompt und fügen Sie ihn in einen beliebigen KI-Client ein — er schließt die Einrichtung auf seine eigene Weise ab. (Der Prompt weist die KI an, Ihren API Key bei Ihnen zu erfragen, damit Zugangsdaten nie im Chatverlauf oder in geteilten Konfigurationen landen.)

detail.access.mcp.composeHint

Preise

Task submission

Wird pro übermitteltem Lauf einmal berechnet, unabhängig davon, wie viele Datensätze zurückgegeben werden.

0,0001 $/ Lauf
Returned products

Berechnet nach der Anzahl der erfolgreich zurückgegebenen Datensätze. Fehlgeschlagene Läufe werden nicht berechnet. Abgerechnet in Einheiten von 20 Datensätze; jede angefangene Einheit wird auf 20 Datensätze aufgerundet.

0,01 $/ 20 Datensätze

Mehrere Abrechnungsereignisse werden unabhängig voneinander kumuliert. Details siehe jeweilige Position. Fehlgeschlagene Läufe werden nicht berechnet.

Credits ansehen

Jetzt ausprobieren

Füllen Sie die Parameter aus und starten Sie — die Ergebnisse stammen aus einem echten Aufruf.

Beispiel
Parameter werden vor dem Absenden gegen input.schema validiert
Ab 0,01 $ / 20 Datensätze