# Sears Product Scraper (`kawsar/sears-product-scraper`) Actor Sears product scraper that crawls product pages and category listings on Sears.com to extract prices, ratings, availability, and SKUs, so you can track competitors and monitor pricing without writing custom code. - **URL**: https://apify.com/kawsar/sears-product-scraper.md - **Developed by:** [Kawsar](https://apify.com/kawsar) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## Sears Product Scraper: extract product data, specs, and pricing from Sears.com Sears product scraper pulls structured product data directly from the Sears internal API. Give it one or more Sears product page URLs and it returns everything the API knows about each product: name, price, discount, stock status, brand, model number, UPC, full specifications, all images, category path, and SEO metadata. No browser automation, no bot detection issues. It calls `https://www.sears.com/api/sal/v3/products/details/{productId}` for each URL. Pricing and availability are location-aware, so you can pass a ZIP code to get accurate local prices. ### Use cases - **Price monitoring**: track Sears product prices over time by running the actor on a schedule and comparing current vs original prices - **SEO auditing**: extract seoTitle and seoDescription from hundreds of Sears product pages to audit metadata quality without manual clicking - **Competitor pricing**: collect prices, discounts, and availability across Sears product lines to benchmark against other retailers - **Product catalog sync**: pull brand, model number, UPC, specifications, and images to keep an internal catalog in sync with Sears listings - **Inventory tracking**: monitor the `availability` field across multiple products to catch when items go out of stock - **Market research**: gather star ratings, review counts, and full specification sheets for product analysis and comparison ### Input | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `startUrls` | array | none | Direct Sears product page URLs ending in `/p-[productId]` | | `maxProducts` | integer | 100 | Maximum products to collect per run (up to 1000) | | `zipCode` | string | `10101` | US ZIP code for location-specific pricing and availability | | `timeoutSecs` | integer | 300 | Overall run timeout in seconds | | `proxyConfiguration` | object | disabled | Optional proxy for rate-limited large runs | #### URL format Every URL in `startUrls` must be a direct Sears product page. The product ID is at the end after `/p-`: ```` https://www.sears.com/ge-appliances-psb48ysnss-profile-48inch-smart-side-by/p-A105601864 ^^^^^^^^^^ product ID ```` Category pages and search result pages are not supported. To find product URLs, open any product on Sears.com and copy the URL from your browser. #### Example input ```json { "startUrls": [ "https://www.sears.com/ge-appliances-psb48ysnss-profile-48inch-smart-side-by/p-A105601864", "https://www.sears.com/pj-jewelry-14k-white-gold-over-silver-8mm/p-A097585815" ], "maxProducts": 50, "zipCode": "90210" } ```` ### What data does this actor extract? Each product record contains: ```json { "url": "https://www.sears.com/ge-appliances-psb48ysnss-profile-48inch-smart-side-by/p-A105601864", "productId": "A105601864", "productName": "GE Profile Series PSB48YSNSS 48 Built-in 28.7 cu.ft Side by Side refrigerator Stainless Steel", "currentPrice": 11529.99, "originalPrice": 0.0, "discountPct": 0.0, "starRating": 0.0, "reviewCount": 0, "brand": "GE Profile Series", "sku": "PSB48YSNSS", "partNumber": "04682793000", "upc": "084691845270", "availability": "Out of Stock", "imageUrl": "https://c.shld.net/rpx/i/s/i/spin/10052543/prod_26700505912", "allImageUrls": [ "https://c.shld.net/rpx/i/s/i/spin/10052543/prod_26700505412", "https://c.shld.net/rpx/i/s/i/spin/10052543/prod_26700505512" ], "shortDescription": "The GE Appliance 48 smart refrigerator offers ample food storage benefits with interior LED lighting, automatic defrost system, and full-extension freezer baskets.", "specifications": { "Standard or Counter Depth": "Standard Depth", "Height to Top of Case (in.)": "83.5", "Width w/ Door Closed (In.)": "48", "Overall Capacity (Cu Ft)": "28.7", "Freezer Capacity (Cu Ft)": "11.52", "ENERGY STAR Certified": "Yes", "Color Family": "Stainless steel" }, "categoryPath": "Appliances > Refrigerators > Side-by-Side Refrigerators", "seoTitle": "GE Profile Series PSB48YSNSS 48 Built-in 28.7 cu.ft Side by Side refrigerator Stainless Steel", "seoDescription": "The GE Appliances Profile 48 Smart Side-by-Side Refrigerator not only embellishes your modular kitchen, but also offers ample food storage benefits.", "scrapedAt": "2026-05-05T09:47:05.300Z" } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `url` | string | Full Sears product page URL | | `productId` | string | Sears product identifier (sSin) | | `productName` | string | Full product name from the Sears API | | `currentPrice` | number | Current sale or regular price in USD | | `originalPrice` | number | Pre-discount price; 0 if no discount is active | | `discountPct` | number | Percentage off the original price; 0 if no discount | | `starRating` | number | Average customer rating on a 1-5 scale; 0 if not yet rated | | `reviewCount` | integer | Total number of customer reviews | | `brand` | string | Brand or manufacturer name | | `sku` | string | Manufacturer model number or SKU | | `partNumber` | string | Sears internal part number | | `upc` | string | Universal Product Code (barcode number) | | `availability` | string | Stock status: `In Stock` or `Out of Stock` | | `imageUrl` | string | Main product image URL | | `allImageUrls` | array | All product image URLs returned by the API | | `shortDescription` | string | Short product description with HTML stripped | | `specifications` | object | Full spec sheet as key-value pairs (dimensions, capacity, features, etc.) | | `categoryPath` | string | Full category breadcrumb, e.g. `Appliances > Refrigerators > Side-by-Side` | | `seoTitle` | string | SEO page title from the Sears product listing | | `seoDescription` | string | SEO meta description from the Sears product listing | | `scrapedAt` | string | ISO 8601 timestamp of when the record was collected | ### How it works 1. Reads the list of Sears product page URLs from `startUrls` 2. Extracts the product ID from each URL (the alphanumeric code after `/p-`) 3. Calls `https://www.sears.com/api/sal/v3/products/details/{productId}` with the configured ZIP code 4. Maps the JSON response to the output schema, stripping HTML from descriptions and flattening the specification groups 5. Saves each record to the dataset in real time The actor uses the same internal API that the Sears.com website uses to render product pages, so the data is identical to what you see in a browser. ### How to find product URLs Open any product on [sears.com](https://www.sears.com), copy the URL from your browser, and paste it into `startUrls`. The URL will look like: ``` https://www.sears.com/[product-name]/p-[productId] ``` You can add as many URLs as you need. The actor fetches them one by one and stores all results in a single dataset. ### Pricing and ZIP code Sears prices and stock availability can vary by ZIP code. The default ZIP is `10101` (New York). Change the `zipCode` input to get prices for a different location. This is useful when tracking regional pricing differences or checking availability in specific markets. ### FAQ **What URL format does this actor accept?** Only direct product page URLs ending in `/p-[productId]`. Category pages (ending in `/b-[number]`) and search result pages are not supported. **How do I scrape multiple products at once?** Add all product URLs to the `startUrls` list, one per line. The actor fetches them all in a single run and outputs one record per product. **Where do I find the product ID in the URL?** It is the alphanumeric code at the very end of the URL, after `/p-`. For example, in `https://www.sears.com/ge-appliances.../p-A105601864`, the product ID is `A105601864`. **Does it need a proxy?** No. The Sears product API does not use Akamai or browser-level bot protection. The actor works without any proxy configuration. Proxies are available as an option if you encounter rate limiting on very large runs. **Why does `starRating` show 0 for some products?** Some Sears products have no customer reviews yet. The API returns `null` for those fields, which the actor maps to 0. **What does the `specifications` field contain?** A flat key-value object built from the full specification sheet. For appliances this includes dimensions, capacity, energy rating, color, and features. For electronics it includes resolution, connectivity, and power specs. The exact keys depend on what Sears has on file for the product. **Can I schedule the actor to run automatically?** Yes. Use the Apify scheduler to run the actor on a daily or weekly schedule. Combine it with a webhook to notify your system when new data arrives. **Does the `availability` field update in real time?** The actor calls the API at run time, so the stock status reflects what Sears reports at that moment. Run the actor on a schedule to track changes over time. ### Integrations Connect Sears Product Scraper with other tools using [Apify integrations](https://apify.com/integrations). Works with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and more. Use [webhooks](https://docs.apify.com/integrations/webhooks) to push new product records to your system the moment each run completes. # Actor input Schema ## `startUrls` (type: `array`): Direct Sears.com product page URLs. Each URL must end in /p-\[productId], for example https://www.sears.com/ge-appliances-psb48ysnss-profile-48inch-smart-side-by/p-A105601864. Add one URL per line. ## `maxProducts` (type: `integer`): Maximum number of products to collect per run. Useful as a cost safeguard on large URL lists. ## `zipCode` (type: `string`): US ZIP code used for pricing and availability lookups. Sears prices and stock status can vary by location. ## `timeoutSecs` (type: `integer`): Overall actor timeout in seconds. The run stops after this limit regardless of how many products remain. ## `proxyConfiguration` (type: `object`): Optional proxy for API requests. The Sears API does not use browser-level bot protection, so proxies are usually not required. Enable only if you encounter rate limiting on large runs. ## Actor input object example ```json { "startUrls": [ "https://www.sears.com/ge-appliances-psb48ysnss-profile-48inch-smart-side-by/p-A105601864", "https://www.sears.com/pj-jewelry-14k-white-gold-over-silver-8mm/p-A097585815" ], "maxProducts": 100, "zipCode": "90210", "timeoutSecs": 300, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 = { "startUrls": [ "https://www.sears.com/ge-appliances-psb48ysnss-profile-48inch-smart-side-by/p-A105601864" ], "zipCode": "10101", "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("kawsar/sears-product-scraper").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 = { "startUrls": ["https://www.sears.com/ge-appliances-psb48ysnss-profile-48inch-smart-side-by/p-A105601864"], "zipCode": "10101", "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("kawsar/sears-product-scraper").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 '{ "startUrls": [ "https://www.sears.com/ge-appliances-psb48ysnss-profile-48inch-smart-side-by/p-A105601864" ], "zipCode": "10101", "proxyConfiguration": { "useApifyProxy": false } }' | apify call kawsar/sears-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kawsar/sears-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Sears Product Scraper", "description": "Sears product scraper that crawls product pages and category listings on Sears.com to extract prices, ratings, availability, and SKUs, so you can track competitors and monitor pricing without writing custom code.", "version": "0.0", "x-build-id": "nmWjFiWwVtwuKoCsY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kawsar~sears-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kawsar-sears-product-scraper", "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/kawsar~sears-product-scraper/runs": { "post": { "operationId": "runs-sync-kawsar-sears-product-scraper", "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/kawsar~sears-product-scraper/run-sync": { "post": { "operationId": "run-sync-kawsar-sears-product-scraper", "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", "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct Sears.com product page URLs. Each URL must end in /p-[productId], for example https://www.sears.com/ge-appliances-psb48ysnss-profile-48inch-smart-side-by/p-A105601864. Add one URL per line.", "items": { "type": "string" } }, "maxProducts": { "title": "Max products", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of products to collect per run. Useful as a cost safeguard on large URL lists.", "default": 100 }, "zipCode": { "title": "ZIP code", "type": "string", "description": "US ZIP code used for pricing and availability lookups. Sears prices and stock status can vary by location.", "default": "10101" }, "timeoutSecs": { "title": "Run timeout (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Overall actor timeout in seconds. The run stops after this limit regardless of how many products remain.", "default": 300 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy for API requests. The Sears API does not use browser-level bot protection, so proxies are usually not required. Enable only if you encounter rate limiting on large runs." } } }, "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 } } } } } } } } } } ```