logo
languageESdown
menu

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.

Original · en-USVolver a la traducción

Descripción general

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.

Alcance y límites

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.

  • Adecuada para
  • 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.
  • No usar para
  • 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.

Gestión de fallos

Comportamiento de fallos y reintentos declarado por el autor. Recomendamos incluirlo en tu prompt del sistema al integrar.

  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.

Entrada

Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.

CampoNombre de negocioTipoObligatorioPredeterminadoEnum / RestriccionesEjemploDescripción
search_urlAmazon Japan search results URLstringSí——https://www.amazon.co.jp/s?k=ipad+miniA full HTTPS Amazon Japan search results page URL. The link must be an amazon.co.jp search results page and at most 512 characters.
crawl_countExpected result countstringSí——1Expected number of search-result products, from 1 to 10000. Actual returned records will not exceed this value.

Salida

Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.

CampoNombre de negocioTipoEjemploDescripción
ad_tagAd tagbooleanfalseWhether the product card is marked as an advertisement on the search results page.
biz_idBusiness IDstringhttps://www.amazon.co.jp/s?k=ipad+miniBusiness identifier associated with the record; in the current data shape this is the search results URL.
crawl_rateCollection statusstringrunningCollection status text returned with the source record.
crawl_timeCollected atstring2026-09-02T10:54:24Collection time for this product card; the source does not specify a timezone.
current_priceCurrent pricestringJP¥56,566Current price text shown on the search results card, including the displayed currency symbol.
deliveryDeliverystring免费配送, 预计明天, 9月3日送达Delivery timing and conditions shown on the search results card.
image_urlImage URLstringhttps://m.media-amazon.com/images/I/71YBUkZO2BL._AC_UL320_.jpgProduct image URL shown on the search results card.
in_stockStock infostring—Stock status text shown on the search results card.
item_idItem IDstringhttps://www.amazon.co.jp/s?k=ipad+miniCollection-item identifier for the search results page this record belongs to.
keywordKeywordstringipad miniSearch keyword associated with this product card.
original_priceOriginal pricestring—Original or struck-through price text shown on the search results card, including the displayed currency symbol.
product_idProduct IDstringB0BKPXSKNQ-JPProduct identifier for this search result listing.
product_titleProduct titlestring【翻新产品】Apple iPad mini (第6代)Wi-Fi + Cellular 64GB 太空灰Product title shown on the search results card.
rating_countRating countstring193Number of ratings shown on the search results card.
rating_scoreRating scorestring3.8Rating score shown on the search results card.
recent_purchaseRecent purchasesstring过去一个月有50+顾客购买Recent purchase text shown on the search results card.
search_front_categoryFront categorystring—Front-of-search category text when the card provides it.
shipping_freeFree shippingstring—Free-shipping text shown on the search results card.
shipping_priceShipping pricestring—Shipping price text shown on the search results card.
site_codeSite codestringJPAmazon marketplace site code for this listing, such as JP.
sku_idSKU IDstringB0BKPXSKNQ-JPSKU identifier returned with this search result.
source_crawl_timeSource timestring1788317664075Source collection timestamp returned as text with the listing.
listing_statusListing statusstring有效Listing status text returned with the record, in the source wording.
source_itemSource itemstringhttps://www.amazon.co.jp/s?k=ipad+miniSearch results URL associated with the collection item that produced this record.
no_dataNo-data markerbooleanfalseIndicates whether the collection item produced no matching product cards.

Schema del registro

La salida se devuelve registro a registro. detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "ad_tag": {
      "type": "boolean",
      "title": "Ad tag",
      "description": "Whether the product card is marked as an advertisement on the search results page.",
      "prefill": false
    },
    "biz_id": {
      "type": "string",
      "title": "Business ID",
      "description": "Business identifier associated with the record; in the current data shape this is the search results URL.",
      "prefill": "https://www.amazon.co.jp/s?k=ipad+mini"
    },
    "crawl_rate": {
      "type": "string",
      "title": "Collection status",
      "description": "Collection status text returned with the source record.",
      "prefill": "running"
    },
    "crawl_time": {
      "type": "string",
      "title": "Collected at",
      "description": "Collection time for this product card; the source does not specify a timezone.",
      "prefill": "2026-09-02T10:54:24"
    },
    "current_price": {
      "type": "string",
      "title": "Current price",
      "description": "Current price text shown on the search results card, including the displayed currency symbol.",
      "prefill": "JP¥56,566"
    },
    "delivery": {
      "type": "string",
      "title": "Delivery",
      "description": "Delivery timing and conditions shown on the search results card.",
      "prefill": "免费配送, 预计明天, 9月3日送达"
    },
    "image_url": {
      "type": "string",
      "title": "Image URL",
      "description": "Product image URL shown on the search results card.",
      "prefill": "https://m.media-amazon.com/images/I/71YBUkZO2BL._AC_UL320_.jpg"
    },
    "in_stock": {
      "type": "string",
      "title": "Stock info",
      "description": "Stock status text shown on the search results card."
    },
    "item_id": {
      "type": "string",
      "title": "Item ID",
      "description": "Collection-item identifier for the search results page this record belongs to.",
      "prefill": "https://www.amazon.co.jp/s?k=ipad+mini"
    },
    "keyword": {
      "type": "string",
      "title": "Keyword",
      "description": "Search keyword associated with this product card.",
      "prefill": "ipad mini"
    },
    "original_price": {
      "type": "string",
      "title": "Original price",
      "description": "Original or struck-through price text shown on the search results card, including the displayed currency symbol."
    },
    "product_id": {
      "type": "string",
      "title": "Product ID",
      "description": "Product identifier for this search result listing.",
      "prefill": "B0BKPXSKNQ-JP"
    },
    "product_title": {
      "type": "string",
      "title": "Product title",
      "description": "Product title shown on the search results card.",
      "prefill": "【翻新产品】Apple iPad mini (第6代)Wi-Fi + Cellular 64GB 太空灰"
    },
    "rating_count": {
      "type": "string",
      "title": "Rating count",
      "description": "Number of ratings shown on the search results card.",
      "prefill": "193"
    },
    "rating_score": {
      "type": "string",
      "title": "Rating score",
      "description": "Rating score shown on the search results card.",
      "prefill": "3.8"
    },
    "recent_purchase": {
      "type": "string",
      "title": "Recent purchases",
      "description": "Recent purchase text shown on the search results card.",
      "prefill": "过去一个月有50+顾客购买"
    },
    "search_front_category": {
      "type": "string",
      "title": "Front category",
      "description": "Front-of-search category text when the card provides it."
    },
    "shipping_free": {
      "type": "string",
      "title": "Free shipping",
      "description": "Free-shipping text shown on the search results card."
    },
    "shipping_price": {
      "type": "string",
      "title": "Shipping price",
      "description": "Shipping price text shown on the search results card."
    },
    "site_code": {
      "type": "string",
      "title": "Site code",
      "description": "Amazon marketplace site code for this listing, such as JP.",
      "prefill": "JP"
    },
    "sku_id": {
      "type": "string",
      "title": "SKU ID",
      "description": "SKU identifier returned with this search result.",
      "prefill": "B0BKPXSKNQ-JP"
    },
    "source_crawl_time": {
      "type": "string",
      "title": "Source time",
      "description": "Source collection timestamp returned as text with the listing.",
      "prefill": "1788317664075"
    },
    "listing_status": {
      "type": "string",
      "title": "Listing status",
      "description": "Listing status text returned with the record, in the source wording.",
      "prefill": "有效"
    },
    "source_item": {
      "type": "string",
      "title": "Source item",
      "description": "Search results URL associated with the collection item that produced this record.",
      "prefill": "https://www.amazon.co.jp/s?k=ipad+mini"
    },
    "no_data": {
      "type": "boolean",
      "title": "No-data marker",
      "description": "Indicates whether the collection item produced no matching product cards.",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": false
}

Integración

Esta App se puede integrar mediante MCP, API, SDK o exportación de archivos — todos los canales comparten las mismas capacidades y precios. Cada solicitud se autentica con la cabecera Authorization: Bearer usando una API Key (de larga duración, creada en la consola de Data Hub); los clientes MCP también pueden iniciar sesión con OAuth sin clave. Más opciones como CLI y Skill están en camino.

Con MCP (Model Context Protocol) puedes llamar a esta App directamente desde clientes de IA como Claude y Cursor. Elige tu cliente y el modo de autenticación, y copia la configuración de abajo.

Configuración del cliente

Sustituye el valor tras Bearer por tu API Key de larga duración. Funciona en cualquier cliente, CI o entorno sin interfaz.

mcpServers config
{
  "mcpServers": {
    "meme_today__amazon-keyword-list-jp": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=meme_today/amazon-keyword-list-jp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Deja que la IA lo configure por ti

¿No quieres editar configuraciones a mano? Copia el prompt de instalación y pégalo en cualquier cliente de IA: completará la configuración a su manera. (El prompt le pide a la IA que te solicite tu API Key, de modo que las credenciales nunca queden en el historial de chat ni en configuraciones compartidas.)

detail.access.mcp.composeHint

Precios

per task

Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.

0,001 US$/ ejecución
returned 20 record

Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran. Se factura en unidades de 20 registro; cualquier unidad parcial se redondea a 20 registro.

0,003 US$/ 20 registro

Los distintos eventos de facturación se acumulan de forma independiente. Consulta cada elemento para más detalles. Las ejecuciones fallidas no se cobran.

Ver créditos

Pruébalo ahora

Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.

Ejemplo
Los parámetros se validan contra input.schema antes del envío
Rellena primero los parámetros obligatorios
Desde 0,003 US$ / 20 registro