# Amazon Price History & Title Lookup API (`dev00/amazon-price-history-title-lookup-api`) Actor Instantly retrieve current prices, product titles, and multiple historical price history graph links using ASIN and marketplace. - **URL**: https://apify.com/dev00/amazon-price-history-title-lookup-api.md - **Developed by:** [dev00](https://apify.com/dev00) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $5.00 / 1,000 amazon price history lookups This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🔗 Amazon Price History & Title Lookup Actor Instantly retrieve product titles, current pricing benchmarks, and multiple historical price history graph links using ASIN and marketplace. This Actor integrates with a high-performance Cloudflare Worker edge API to query, clean, and format pricing data in real time. It features a simplified input schema and automatically saves the results in both the Apify dataset (for bulk exports) and the default Key-Value Store under the `OUTPUT` record (for direct single-record reads). --- ### 🌟 Key Features & Architecture * **Realtime Lookup**: Instantly resolves product titles and current price mappings for Amazon retail, third-party marketplace new, and third-party marketplace used offers. * **Dual Price History Charts**: Provides pre-formatted image links to multiple high-resolution price history graphs (one standard history graph and one Keepa-compatible history graph). * **Extensive Locales**: Supports international marketplaces including the United States (US), United Kingdom (UK), Germany (DE), France (FR), Italy (IT), Spain (ES), Canada (CA), Japan (JP), Mexico (MX), Brazil (BR), India (IN), and Australia (AU). * **Edge Cleansing**: Purges tracking parameters, link phrases, internal cookies, and other metadata from the upstream source to yield a clean, lightweight JSON response. * **Reliable Dispatches**: Connects via a resilient edge network with built-in automatic retries to gracefully handle transient network timeouts or upstream rate limits. * **Deep Auditing**: Automatically logs the complete raw JSON response payload to the default Key-Value Store under the `OUTPUT` key for easy API integration. --- ### 📥 Input Parameters | Field | Type | Description | Prefill Example | | :--- | :--- | :--- | :--- | | **ASIN** | `string` | The 10-character Amazon Standard Identification Number of the target product. | `B0DK3W6TV6` | | **Marketplace** | `string` | The marketplace country/locale code. Defaults to `US`. | `US` | #### Input JSON Example ```json { "asin": "B0DK3W6TV6", "marketplace": "US" } ```` *** ### 📤 Output Data Structure The dataset outputs the complete JSON response returned by the price history lookup: #### Output JSON Example ```json { "success": true, "data": { "asin": "B0DK3W6TV6", "created_at": "2024-10-16T00:01:33.000-07:00", "currency_symbol": "$", "title": "Apple iPad mini (A17 Pro): Apple Intelligence, 8.3-inch Liquid Retina Display, 128GB, Wi-Fi 6E, 12MP Front/12MP Back Camera, Touch ID, All-Day Battery Life — Space Gray", "prices": { "price_amazon": 47400, "price_new": null, "price_used": 44580 }, "last_price": { "price_amazon": 47400, "price_new": null, "price_used": 44580 }, "highest_pricing": { "price_amazon": { "created_at": "Oct 22, 2024", "price": 49999 }, "price_new": { "created_at": "Dec 02, 2025", "price": 52000 }, "price_used": { "created_at": "Dec 09, 2024", "price": 59528 } }, "lowest_pricing": { "price_amazon": { "created_at": "Aug 08, 2025", "price": 37900 }, "price_new": { "created_at": "Dec 20, 2024", "price": 49900 }, "price_used": { "created_at": "Feb 15, 2025", "price": 32718 } }, "full_chart_image": "https://charts.camelcamelcamel.com/us/B0DK3W6TV6/amazon-new-used.png?force=1&zero=0&w=900&h=265&fo=1&desired=false&legend=1&ilt=1&tp=all&lang=en", "keepa_graph_url": "https://graph.keepa.com/pricehistory.png?asin=B0DK3W6TV6&domain=com" } } ``` # Actor input Schema ## `asin` (type: `string`): Provide the Amazon Standard Identification Number (ASIN) (e.g., 'B0DK3W6TV6'). ## `marketplace` (type: `string`): Select or provide the marketplace locale (e.g. US, UK, DE, FR, IT, ES, CA, JP). Defaults to US. ## Actor input object example ```json { "asin": "B0DK3W6TV6", "marketplace": "US" } ``` # Actor output Schema ## `results` (type: `string`): No description ## `keyValueStoreResult` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "asin": "B0DK3W6TV6", "marketplace": "US" }; // Run the Actor and wait for it to finish const run = await client.actor("dev00/amazon-price-history-title-lookup-api").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "asin": "B0DK3W6TV6", "marketplace": "US", } # Run the Actor and wait for it to finish run = client.actor("dev00/amazon-price-history-title-lookup-api").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "asin": "B0DK3W6TV6", "marketplace": "US" }' | apify call dev00/amazon-price-history-title-lookup-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dev00/amazon-price-history-title-lookup-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Amazon Price History & Title Lookup API", "description": "Instantly retrieve current prices, product titles, and multiple historical price history graph links using ASIN and marketplace.", "version": "1.0", "x-build-id": "GuW7xof4hqaUBby6Z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dev00~amazon-price-history-title-lookup-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dev00-amazon-price-history-title-lookup-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/dev00~amazon-price-history-title-lookup-api/runs": { "post": { "operationId": "runs-sync-dev00-amazon-price-history-title-lookup-api", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/dev00~amazon-price-history-title-lookup-api/run-sync": { "post": { "operationId": "run-sync-dev00-amazon-price-history-title-lookup-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "asin" ], "properties": { "asin": { "title": "ASIN", "type": "string", "description": "Provide the Amazon Standard Identification Number (ASIN) (e.g., 'B0DK3W6TV6')." }, "marketplace": { "title": "Marketplace / Locale", "type": "string", "description": "Select or provide the marketplace locale (e.g. US, UK, DE, FR, IT, ES, CA, JP). Defaults to US.", "default": "US" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```