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.

Source · en-USRevenir à la traduction

Collecte de données E-commerce & Retail Amazon Products

Aperçu

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 ID	Product title	Current price	Rating score	Keyword	Ad tag
B0HG365ZZV-US	HP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD	$899.99	4.8	laptop	No
B0H72JH23T-US	HP 14 inch Laptop, 4GB DDR5 RAM, 128GB SSD, Intel N150 Processor	$299.99	5.0	laptop	No

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.

Périmètre et limites

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.

Adapté pour
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.

À 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 Japan-marketplace, order, or seller-backend data — this App covers public non-Japan search listings only.

Gestion des échecs

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

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.
2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
3Retry later after rate limiting, temporary unavailability, or a timeout.
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.

Champ	Nom métier	Type	Requis	Défaut	Énum / Contraintes	Exemple	Description
search_url	Amazon search results URL	string	Oui	—	—	https://www.amazon.com/s?k=ipad+mini&crid=3F8PFA9JP0GNF&sprefix=ipad%2Caps%2C387&ref=nb_sb_ss_p13n-expert-pd-ops-ranker_7_4	A 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_count	Expected result count	string	Oui	—	—	1	Expected 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.

Sortie

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

Champ	Nom métier	Type	Exemple	Description
ad_tag	Ad tag	boolean	false	Whether the product card is marked as an advertisement on the search results page.
biz_id	Business ID	string	https://www.amazon.com/s?k=laptop	Business identifier associated with the record; in the current data shape this is the search results URL.
crawl_rate	Collection status	string	running	Collection status text returned with the source record.
crawl_time	Collected at	string	2026-09-15T14:46:17	Collection time for this product card; the source does not specify a timezone.
current_price	Current price	string	$899.99	Current price text shown on the search results card, including the displayed currency symbol.
delivery	Delivery	string	FREE delivery Tomorrow, Sep 16 Only 10 left in stock - order soon.	Delivery timing and conditions shown on the search results card.
image_url	Image URL	string	https://m.media-amazon.com/images/I/81bCsTL5XWL._AC_UY218_.jpg	Product image URL shown on the search results card.
in_stock	Stock info	string	Only 10 left in stock - order soon.	Stock status text shown on the search results card.
item_id	Item ID	string	https://www.amazon.com/s?k=laptop	Collection-item identifier for the search results page this record belongs to.
keyword	Keyword	string	laptop	Search keyword associated with this product card.
original_price	Original price	string	$1,799.99	Original or struck-through price text shown on the search results card, including the displayed currency symbol.
product_id	Product ID	string	B0HG365ZZV-US	Product identifier for this search result listing.
product_title	Product title	string	HP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD	Product title shown on the search results card.
rating_count	Rating count	string	12	Number of ratings shown on the search results card.
rating_score	Rating score	string	4.8	Rating score shown on the search results card.
recent_purchase	Recent purchases	string	500+ bought in past month	Recent purchase text shown on the search results card.
search_front_category	Front category	string	Electronics	Front-of-search category text when the card provides it.
shipping_free	Free shipping	string	FREE delivery	Free-shipping text shown on the search results card.
shipping_price	Shipping price	string	$0.00	Shipping price text shown on the search results card.
site_code	Site code	string	US	Amazon marketplace site code for this listing, such as US.
sku_id	SKU ID	string	B0HG365ZZV-US	SKU identifier returned with this search result.
source_crawl_time	Source time	string	1789454777823	Source collection timestamp returned as text with the listing.
listing_status	Listing status	string	有效	Listing status text returned with the record, in the source wording.
source_item	Source item	string	https://www.amazon.com/s?k=laptop	Search results URL associated with the collection item that produced this record.
no_data	No-data marker	boolean	false	Indicates whether the collection item produced no matching product cards.

Schema de l'enregistrement

La sortie est renvoyée enregistrement par enregistrement. 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
}

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.

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": {
    "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>" }
    }
  }
}

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

20 returned records

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 enregistrement ; toute unité incomplète est arrondie à 20 enregistrement.

0,001 $US/ 20 enregistrement

Per task submitted

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

0,0001 $US/ exécution

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

Amazon search results URLsearch_url*A 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.

Expected result countcrawl_count*Expected 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.

Veuillez d'abord renseigner les paramètres requis

À partir de 0,001 $US / 20 enregistrement