FR

Amazon Japan Keyword Search

Give an amazon.co.jp search results URL and an expected count to get product titles, prices, ratings, delivery, and listing details.

Source · en-USRevenir à la traduction

Développeur
Tarifs
À partir de 0,003 $US / 20 enregistrements
Dernière mise à jour
2026-09-22

Aperçu

Shoppers on Amazon Japan decide from search cards long before they open a product page: the title, the price they see, the rating, the delivery promise, and whether the card is labeled as an ad. This app turns one amazon.co.jp search results link into a structured table of those public cards so assortment, pricing, and visibility work can start from the same search view a customer in Japan would see.

The dataset keeps the keyword, marketplace site code, and search link beside each product, which makes later comparisons stay attached to the query that produced them. It is a search-result workbook for the Japan marketplace, not a substitute for a full product page.

Data notes

Each row is one product card from a public Amazon Japan search results page. Rows are ordered by collection time from earliest to latest, and the same Product ID is kept once in the returned set. Current price and Original price are the texts shown on the card, including the currency symbol as displayed; they are not normalized numbers and may differ from a later detail-page price, tax, or coupon. Delivery, Free shipping, Shipping price, and Stock info are the card snapshot at collection time. Collected at is returned without a timezone. Keyword, Business ID, Item ID, and Source item repeat the search context across rows from the same query. Listing status is the source status text as returned, even when that text is not in English.

The collection does not cover non-Japan marketplaces, product-detail pages, variants, reviews, orders, or seller-backend data, and it does not include cards that are not visible on the public search page. A No-data marker distinguishes a search item that produced no cards from ordinary product rows.

What a result looks like

Each row is one search-result product card.

Product IDProduct titleCurrent priceRating scoreKeywordAd tag
B0BKPXSKNQ-JP【翻新产品】Apple iPad mini (第6代)Wi-Fi + Cellular 64GB 太空灰JP¥56,5663.8ipad miniNo
B09G9FPHY6-JPApple iPad mini(A17 Pro)Wi-Fi 128GB スペースグレイJP¥78,8004.7ipad miniNo

Original price, Delivery, Rating count, Site code, and Stock info are also available when the card shows them.

Use cases

  • For assortment checks, group rows by Keyword and Site code, then scan Product title and Product ID to see which products occupy the first results for a Japan-marketplace query.
  • For list-price comparison, rank Current price against Original price and Rating score to see which cards look like promotions versus full-price listings.
  • For visibility work, filter Ad tag and read Product title with Delivery to separate sponsored cards from organic cards and note how delivery promises are presented.
  • For availability review, read Stock info, Recent purchases, and Free shipping together to see which cards signal scarcity or shipping offers at collection time.

Périmètre et limites

One amazon.co.jp search results URL per task with an expected result count from 1 to 10000; actual returned cards will not exceed that count; coverage is limited to public Japan-marketplace search-result listings.

  • Adapté pour
  • When you need product cards from an Amazon Japan keyword search results page.
  • When you need to compare list-page prices, ratings, delivery promises, and ad placement for a Japan-marketplace query.
  • À ne pas utiliser pour
  • When you need a full product page, variants, reviews, or price history — this App only returns search-result card information.
  • When you need non-Japan marketplace, order, or seller-backend data — this App covers public amazon.co.jp search listings only.

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 no product cards are returned, confirm the link is a public amazon.co.jp search results page and try a shorter or broader query.
  2. 2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
  3. 3Retry later after rate limiting, temporary unavailability, or a timeout.
  4. 4If 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.

  • Amazon Japan search results URLsearch_urlRequisstring
    A full HTTPS Amazon Japan search results page URL. The link must be an amazon.co.jp search results page and at most 512 characters.
    Exemplehttps://www.amazon.co.jp/s?k=ipad+mini
  • Expected result countcrawl_countRequisstring
    Expected number of search-result products, from 1 to 10000. Actual returned records will not exceed this value.
    Exemple1

Sortie

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

  • Ad tagad_tagboolean
    Whether the product card is marked as an advertisement on the search results page.
    Exemplefalse
  • Business IDbiz_idstring
    Business identifier associated with the record; in the current data shape this is the search results URL.
    Exemplehttps://www.amazon.co.jp/s?k=ipad+mini
  • Collection statuscrawl_ratestring
    Collection status text returned with the source record.
    Exemplerunning
  • Collected atcrawl_timestring
    Collection time for this product card; the source does not specify a timezone.
    Exemple2026-09-02T10:54:24

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
{
  "ad_tag": false,
  "biz_id": "https://www.amazon.co.jp/s?k=ipad+mini",
  "crawl_rate": "running",
  "crawl_time": "2026-09-02T10:54:24",
  "current_price": "JP¥56,566",
  "delivery": "免费配送, 预计明天, 9月3日送达",
  "image_url": "https://m.media-amazon.com/images/I/71YBUkZO2BL._AC_UL320_.jpg",
  "in_stock": "<in_stock>",
  "item_id": "https://www.amazon.co.jp/s?k=ipad+mini",
  "keyword": "ipad mini",
  "original_price": "<original_price>",
  "product_id": "B0BKPXSKNQ-JP",
  "product_title": "【翻新产品】Apple iPad mini (第6代)Wi-Fi + Cellular 64GB 太空灰",
  "rating_count": "193",
  "rating_score": "3.8",
  "recent_purchase": "过去一个月有50+顾客购买",
  "search_front_category": "<search_front_category>",
  "shipping_free": "<shipping_free>",
  "shipping_price": "<shipping_price>",
  "site_code": "JP",
  "sku_id": "B0BKPXSKNQ-JP",
  "source_crawl_time": "1788317664075",
  "listing_status": "有效",
  "source_item": "https://www.amazon.co.jp/s?k=ipad+mini",
  "no_data": 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=meme_today/amazon-keyword-list-jp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

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. (Par défaut, il vous guide pour vous connecter et ne vous demande jamais d'envoyer votre API Key dans la conversation.)

detail.access.mcp.composeHint

Tarifs

per task

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

0,001 $US/ exécution
returned 20 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 20 enregistrements ; toute unité incomplète est arrondie à 20 enregistrements.

0,003 $US/ 20 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,003 $US / 20 enregistrements