logo
FR

JD Keyword Search

Give a JD search keyword and an expected count to get matching product listings with prices, shops, and product links.

Source · en-USRevenir à la traduction

Collecte de donnéesE-commerce & RetailJD.comProducts
Développeur
super_ig
Tarifs
À partir de 0,05 $US / 48 enregistrements
Dernière mise à jour
2026-10-13

Aperçu

Keyword searches on JD mix official stores, authorized sellers and accessory listings behind the same buying intent. Seeing those search-result cards together makes it easier to judge which products, shops and price points actually appear for a query, without opening every listing one by one.

This collection keeps the original product titles, displayed prices and listing links from JD search results. It is useful when assortment, ranking and list-page pricing are the input to a sourcing or competitive review, rather than replacing a product-detail check or a purchase decision.

Data notes

The data describes product cards collected from public JD keyword search results. Results are delivered in ascending collection-time order, which is separate from the sorting used to select products during collection. Repeated SKU IDs are consolidated across the delivered pages.

Product title, Price, Review count and Sales count retain their source text. Price is not converted into another currency, and no assumptions are made about taxes, promotions or purchasing conditions. Business ID, Keyword and Submitted keyword can carry the same search phrase; none of them is a unique product identifier. The time zone of Collection time is not specified.

Missing brand, sales-count and listing-status values remain missing rather than being inferred. A blank preview does not assert that the corresponding source value is an empty string. Search-desc flag is kept as a yes/no marker as collected. The collection should not be treated as a complete JD catalog, a stock snapshot, or a verified offer for a particular order.

What the results look like

Each row represents one JD search-result listing. Quoted Price and Review count values are text, not converted numbers.

SKU IDProduct titlePriceReview countShop name
10235644935262苹果18promax【新品限售】Apple iphone18promax 18promax 手机apple 18Promax 6.9英寸 勃艮第酒红色 256GB【全新未激活+全国联保】"12888.00""2000+"星盟3C数码买手店
10234915484680Apple/苹果 iPhone 18 Pro Max 支持移动联通电信 5G 双卡双待手机 勃艮第酒红色 256GB 授权正品【需现场签收激活】 官方标配"10999.00""500+"Apple产品萌宠主题旗舰店

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

Use cases

  • Compare search assortment: group Product title by recurring product or accessory terms, then use SKU ID and Shop name to separate distinct listings behind the same keyword.
  • Review displayed pricing: compare Price and Review count for listings with similar Product title wording, keeping the original text before drawing conclusions about competitiveness.
  • Prepare a shortlist: combine Keyword, Product title, Product URL and Shop name to identify relevant candidates, and retain Collection time so later reviews can distinguish collection snapshots.

Périmètre et limites

One JD search keyword per task with an expected result count from 1 to 2000; results are collected in source pages and may return fewer or more than requested; fetch protection is 110 pages / 2,200 records; reaching this capacity does not establish completeness; coverage is limited to public JD search listings.

  • Adapté pour
  • When you need JD search-result products for a brand, product, or category keyword.
  • When you need a structured list that connects each matched listing with its shop, price, and product link.
  • À ne pas utiliser pour
  • When you need a full product page, variants, reviews, or price history — this App only returns search-result listing information.
  • When you need a strictly capped result count or an immediate single-record lookup.

Gestion des échecs

Comportement en cas d'échec et de nouvelle tentative déclaré par le développeur. Nous vous recommandons de l'inclure dans votre prompt système lors de l'intégration.

  1. 1If submission times out or its outcome is unknown, check the existing run before submitting again: repeated submissions can create separate jobs.
  2. 2If no matching records are returned, try a shorter or broader search phrase and resubmit.
  3. 3Keep completed records after a partial success; resubmit the same input after a failed or expired task.
  4. 4Retry later after rate limiting, temporary service unavailability, or a timeout.
  5. 5If authentication fails, verify the API Key configured for the execution environment.

Entrée

Paramètres requis pour appeler cette App, générés à partir de l'input.schema du manifest.json.

  • Search keywordkeywordRequisstring
    Enter one JD product search keyword, from 1 to 512 characters.
    Exempleiphone 18 pro max
  • Expected product counttarget_countRequisstring
    Enter a whole number from 1 to 2000 as digits only. This is a collection target, not a strict cap; source-page collection can return fewer or more listings.
    Exemple25
  • Collection sort ordersortRequisstring(enum)
    Choose how products are ordered during collection. Default is the JD default ranking. Delivered results remain in ascending collection-time order.
    Valeurs possiblesDefault0Comprehensive1Sales2Review count3Newest4Price: low to high51Price: high to low52Défaut0Exemple0

Sortie

Structure des champs d'un enregistrement, générée à partir de l'output.schema du manifest.json.

  • SKU IDskuIdstring
    JD product identifier used to distinguish listings.
    Exemple10235644935262
  • Business IDbizIdstring
    Search keyword retained on the listing; not a unique product identifier.
    Exempleiphone 18 pro max
  • Product titleproductTitlestring
    Product title as collected, without translation.
    Exemple苹果18promax【新品限售】Apple iphone18promax 18promax 手机apple 18Promax 6.9英寸 勃艮第酒红色 256GB【全新未激活+全国联保】
  • Pricepricestring
    Price text as collected; no currency or numeric conversion is applied.
    Exemple12888.00

Exemple de données

Généré à partir d'output.schema. Les champs sans valeur d'exemple utilisent des espaces réservés structurels.

output.example
{
  "skuId": "10235644935262",
  "bizId": "iphone 18 pro max",
  "productTitle": "苹果18promax【新品限售】Apple iphone18promax 18promax 手机apple 18Promax 6.9英寸 勃艮第酒红色 256GB【全新未激活+全国联保】",
  "price": "12888.00",
  "saleCount": "<saleCount>",
  "rateCount": "2000+",
  "brandName": "<brandName>",
  "imageUrl": "https://img11.360buyimg.com/img/jfs/t1/514884/11/15012/128777/6aacf40fF7127ae8f/00833203200b14b8.png",
  "productUrl": "https://item.jd.com/10235644935262.html",
  "shopId": "13365898",
  "shopName": "星盟3C数码买手店",
  "keyword": "iphone 18 pro max",
  "searchDescFlag": false,
  "status": "<status>",
  "crawlTime": "2026-10-13T18:37:40",
  "taskItem": "iphone 18 pro max",
  "taskNoData": false
}

Intégration

Cette App peut être intégrée via MCP, API, SDK ou export de fichiers — tous les canaux partagent les mêmes capacités et la même tarification. Chaque requête s'authentifie avec l'en-tête Authorization: Bearer à l'aide d'une API Key (longue durée, créée dans la console Data Hub) ; les clients MCP peuvent aussi se connecter via OAuth, sans clé. D'autres options comme la CLI et Skill arrivent bientôt. Cette App s'exécute de manière asynchrone et peut être annulée en cours de route : Après l'annulation, l'exécution s'arrête. Les enregistrements déjà livrés sont conservés et facturés.

Avec MCP (Model Context Protocol), vous pouvez appeler cette App directement depuis des clients IA comme Claude et Cursor. Choisissez votre client et votre mode d'authentification, puis copiez la config ci-dessous.

Config du client

Remplacez la valeur après Bearer par votre API Key longue durée. Fonctionne dans n'importe quel client, en CI ou en environnement sans navigateur.

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

Laissez l'IA tout configurer pour vous

Vous ne voulez pas modifier les configs à la main ? Copiez le prompt d'installation et collez-le dans n'importe quel client IA — il effectuera la configuration à sa manière. (Le prompt demande à l'IA de vous réclamer votre API Key, afin que les identifiants ne finissent jamais dans l'historique de conversation ni dans des configs partagées.)

detail.access.mcp.composeHint

Tarifs

Task submission

Facturé une fois par exécution soumise, quel que soit le nombre d'enregistrements renvoyés.

0,0001 $US/ exécution
Returned record

Facturé selon le nombre d'enregistrements renvoyés avec succès. Les exécutions échouées ne sont pas facturées. Facturé par unités de 48 enregistrements ; toute unité incomplète est arrondie à 48 enregistrements.

0,05 $US/ 48 enregistrements

Plusieurs événements de facturation se cumulent indépendamment. Voir chaque élément pour les détails. Les exécutions échouées ne sont pas facturées.

Voir les crédits

Essayer maintenant

Renseignez les paramètres et lancez l'exécution — les résultats proviennent d'un appel réel.

Exemple
Les paramètres sont validés par rapport à l'input.schema avant la soumission
À partir de 0,05 $US / 48 enregistrements