logo
languageJPdown
menu

Amazon Keyword Search

Give a non-Japan Amazon search results URL and an expected count to get product titles, prices, ratings, delivery, and listing details.

原文 · en-US訳文に戻す

データ収集E-commerce & RetailAmazonProducts

概要

Shoppers decide from Amazon 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 non-Japan Amazon 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 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, not a substitute for a full product page.

Data notes

Each row is one product card from a public non-Japan Amazon 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 Japan-marketplace listings, 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
B0HG365ZZV-USHP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD$899.994.8laptopNo
B0H72JH23T-USHP 14 inch Laptop, 4GB DDR5 RAM, 128GB SSD, Intel N150 Processor$299.995.0laptopNo

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 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.

適用範囲と境界

One non-Japan Amazon search results URL per task with an expected result count from 1 to 10000; results are returned in complete batches of 20 and may be rounded up; amazon.co.jp is not supported; coverage is limited to public search-result listings.

  • 適している用途
  • When you need product cards from a non-Japan Amazon keyword search results page.
  • When you need to compare list-page prices, ratings, delivery promises, and ad placement for a search query.
  • 適さない用途
  • When you need a full product page, variants, reviews, or price history — this App only returns search-result card information.
  • When you need Japan-marketplace, order, or seller-backend data — this App covers public non-Japan search listings only.

失敗時の処理

作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

  1. 1If no product cards are returned, confirm the link is a public non-Japan Amazon 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.

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

フィールド業務名称型必須デフォルト列挙値／制約例説明
search_urlAmazon search results URLstringはい——https://www.amazon.com/s?k=ipad+mini&crid=3F8PFA9JP0GNF&sprefix=ipad%2Caps%2C387&ref=nb_sb_ss_p13n-expert-pd-ops-ranker_7_4A full HTTPS Amazon search results page URL for a non-Japan marketplace. The link must be a search results page and at most 512 characters; amazon.co.jp is not supported.
crawl_countExpected result countstringはい——1Expected number of search-result products, from 1 to 10000. Results are returned in complete batches of 20, so the actual count may be rounded up.

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

フィールド業務名称型例説明
ad_tagAd tagbooleanfalseWhether the product card is marked as an advertisement on the search results page.
biz_idBusiness IDstringhttps://www.amazon.com/s?k=laptopBusiness 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-15T14:46:17Collection time for this product card; the source does not specify a timezone.
current_priceCurrent pricestring$899.99Current price text shown on the search results card, including the displayed currency symbol.
deliveryDeliverystringFREE delivery Tomorrow, Sep 16 Only 10 left in stock - order soon.Delivery timing and conditions shown on the search results card.
image_urlImage URLstringhttps://m.media-amazon.com/images/I/81bCsTL5XWL._AC_UY218_.jpgProduct image URL shown on the search results card.
in_stockStock infostringOnly 10 left in stock - order soon.Stock status text shown on the search results card.
item_idItem IDstringhttps://www.amazon.com/s?k=laptopCollection-item identifier for the search results page this record belongs to.
keywordKeywordstringlaptopSearch keyword associated with this product card.
original_priceOriginal pricestring$1,799.99Original or struck-through price text shown on the search results card, including the displayed currency symbol.
product_idProduct IDstringB0HG365ZZV-USProduct identifier for this search result listing.
product_titleProduct titlestringHP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSDProduct title shown on the search results card.
rating_countRating countstring12Number of ratings shown on the search results card.
rating_scoreRating scorestring4.8Rating score shown on the search results card.
recent_purchaseRecent purchasesstring500+ bought in past monthRecent purchase text shown on the search results card.
search_front_categoryFront categorystringElectronicsFront-of-search category text when the card provides it.
shipping_freeFree shippingstringFREE deliveryFree-shipping text shown on the search results card.
shipping_priceShipping pricestring$0.00Shipping price text shown on the search results card.
site_codeSite codestringUSAmazon marketplace site code for this listing, such as US.
sku_idSKU IDstringB0HG365ZZV-USSKU identifier returned with this search result.
source_crawl_timeSource timestring1789454777823Source 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.com/s?k=laptopSearch 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

出力はレコード単位で 1 件ずつ返されます。 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.com/s?k=laptop"
    },
    "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-15T14:46:17"
    },
    "current_price": {
      "type": "string",
      "title": "Current price",
      "description": "Current price text shown on the search results card, including the displayed currency symbol.",
      "prefill": "$899.99"
    },
    "delivery": {
      "type": "string",
      "title": "Delivery",
      "description": "Delivery timing and conditions shown on the search results card.",
      "prefill": "FREE delivery Tomorrow, Sep 16 Only 10 left in stock - order soon."
    },
    "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/81bCsTL5XWL._AC_UY218_.jpg"
    },
    "in_stock": {
      "type": "string",
      "title": "Stock info",
      "description": "Stock status text shown on the search results card.",
      "prefill": "Only 10 left in stock - order soon."
    },
    "item_id": {
      "type": "string",
      "title": "Item ID",
      "description": "Collection-item identifier for the search results page this record belongs to.",
      "prefill": "https://www.amazon.com/s?k=laptop"
    },
    "keyword": {
      "type": "string",
      "title": "Keyword",
      "description": "Search keyword associated with this product card.",
      "prefill": "laptop"
    },
    "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.",
      "prefill": "$1,799.99"
    },
    "product_id": {
      "type": "string",
      "title": "Product ID",
      "description": "Product identifier for this search result listing.",
      "prefill": "B0HG365ZZV-US"
    },
    "product_title": {
      "type": "string",
      "title": "Product title",
      "description": "Product title shown on the search results card.",
      "prefill": "HP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD"
    },
    "rating_count": {
      "type": "string",
      "title": "Rating count",
      "description": "Number of ratings shown on the search results card.",
      "prefill": "12"
    },
    "rating_score": {
      "type": "string",
      "title": "Rating score",
      "description": "Rating score shown on the search results card.",
      "prefill": "4.8"
    },
    "recent_purchase": {
      "type": "string",
      "title": "Recent purchases",
      "description": "Recent purchase text shown on the search results card.",
      "prefill": "500+ bought in past month"
    },
    "search_front_category": {
      "type": "string",
      "title": "Front category",
      "description": "Front-of-search category text when the card provides it.",
      "prefill": "Electronics"
    },
    "shipping_free": {
      "type": "string",
      "title": "Free shipping",
      "description": "Free-shipping text shown on the search results card.",
      "prefill": "FREE delivery"
    },
    "shipping_price": {
      "type": "string",
      "title": "Shipping price",
      "description": "Shipping price text shown on the search results card.",
      "prefill": "$0.00"
    },
    "site_code": {
      "type": "string",
      "title": "Site code",
      "description": "Amazon marketplace site code for this listing, such as US.",
      "prefill": "US"
    },
    "sku_id": {
      "type": "string",
      "title": "SKU ID",
      "description": "SKU identifier returned with this search result.",
      "prefill": "B0HG365ZZV-US"
    },
    "source_crawl_time": {
      "type": "string",
      "title": "Source time",
      "description": "Source collection timestamp returned as text with the listing.",
      "prefill": "1789454777823"
    },
    "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.com/s?k=laptop"
    },
    "no_data": {
      "type": "boolean",
      "title": "No-data marker",
      "description": "Indicates whether the collection item produced no matching product cards.",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": false
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key（長期有効。Data Hub コンソールで作成）を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。

MCP（Model Context Protocol）を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config
{
  "mcpServers": {
    "meme_today__amazon-keyword-list": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=meme_today/amazon-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
自分の API Keys を表示 →

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します（プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません）。

detail.access.mcp.composeHint

料金

20 returned records

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。

$0.001/ 20 件
Per task submitted

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル
パラメータは送信前に input.schema で検証されます
まず必須パラメータを入力してください
$0.001 / 20 件から