# Stopandshop Parser Spider (`getdataforme/stopandshop-parser-spider`) Actor

The Stopandshop Parser Spider is an Apify Actor that scrapes comprehensive product data from Stopandshop.com, including names, descriptions, images, GTINs, and categories....

- **URL**: https://apify.com/getdataforme/stopandshop-parser-spider.md
- **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community)
- **Categories:** E-commerce, Jobs, Real estate
- **Stats:** 6 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $9.00 / 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.

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

## Stopandshop Parser Spider

The Stopandshop Parser Spider is a powerful Apify Actor designed to scrape detailed product information from Stopandshop.com. It extracts comprehensive data such as product names, descriptions, images, categories, and more, enabling efficient data collection for various business needs. This tool ensures reliable and structured output, making it ideal for e-commerce analysis and automation.

### Features

- **Comprehensive Data Extraction**: Scrapes key product details including GTIN, item IDs, marketing descriptions, and custom content like bullet points.
- **High-Quality Media Handling**: Retrieves multiple product images with descriptions, MIME types, and URLs for visual assets.
- **Flexible URL Input**: Supports multiple product URLs for batch processing, allowing scalable scraping operations.
- **Proxy Integration**: Utilizes Apify's residential proxies to avoid IP blocks and ensure uninterrupted data collection.
- **Structured JSON Output**: Delivers clean, parseable data in a consistent format, perfect for integration with databases or analytics tools.
- **Error-Resilient**: Handles variations in product pages gracefully, minimizing failed extractions.
- **Fast and Efficient**: Optimized for performance, processing multiple products quickly without compromising data accuracy.

### Input Parameters

| Parameter | Type | Required | Description | Example |
|-----------|------|----------|-------------|---------|
| Urls | array | Yes | A list of URLs to product pages on Stopandshop.com for scraping. Each URL must be a valid HTTP/HTTPS link. | ["https://stopandshop.com/product/hillshire-farm-polska-kielbasa-rope-14-oz-pkg/61536"] |
| proxyConfiguration | object | No | Configures proxy settings to mask the scraper's origin, using Apify's proxy service for residential IPs. | {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]} |

### Example Usage

To run the Actor, provide input parameters in JSON format:

```json
{
  "Urls": [
    "https://stopandshop.com/product/hillshire-farm-polska-kielbasa-rope-14-oz-pkg/61536"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
````

Example output:

```json
[
  {
    "Pod Id": "61536",
    "GTIN": "00044500341225",
    "itemMaster ID": "76cd0622-31f0-439f-81a1-c1c638c13375",
    "Product Name": "Hillshire Farm Polska Kielbasa Smoked Sausage, 14 oz.",
    "Created in itemMaster": "2024-09-19-03:53",
    "Updated in itemMaster": "2026-01-13-03:37",
    "Category": "Mixed Species Meat/Poultry Prepared/Processed",
    "Type": "GS-1",
    "Private Label Item": false,
    "Item Status": "P",
    "Marketing Description": "Est. 1934. Fully cooked. Heat & eat.",
    "Other Description": "For the full recipe and other quick and easy meal solutions, visit www.hillshirefarm.com/recipes.",
    "Ecommerce Description": "When a hungry family asks for a meal, Hillshire Farm Smoked Sausage is the delicious answer to weeknight dinners. Fully cooked and ready in minutes, the flavorful smoked sausage is the perfect centerpiece for a farmhouse-quality meal with rich, bold flavor. From soups to stews, it\u2019s an instant family favorite. Perfectly seasoned and smoked to perfection, this kielbasa sausage can be prepared using a stove top or grill. For a tasty meal the whole family can enjoy, cook this delicious sausage and serve in a skillet with roasted vegetables and potatoes. Includes one 14 oz package of Hillshire Farm Polska Kielbasa Smoked Sausage. Hard work, dedication, and integrity are the values Hillshire Farm lives by\u2014and the ingredients put into every package of Hillshire Farm Smoked Sausage. Since 1934, the Hillshire Farm brand has stood for the honest, carefully crafted meats families love, made with the ingredients they deserve. The commitment to quality can be tasted in every bite.",
    "Media": [
      {
        "Image View": "EA1A3",
        "Image Mime Type": "image/jpeg",
        "Image Description": "E-Commerce Front",
        "url": "https://assets.syndigo.cloud/cdn/8fc951f9-8ef3-44ec-b244-18f273a72dbd/fileType_jpg;size_600x600/8fc951f9-8ef3-44ec-b244-18f273a72dbd"
      },
      {
        "Image View": "FACTS",
        "Image Mime Type": "image/jpeg",
        "Image Description": "Nutritional Panel",
        "url": "https://assets.syndigo.cloud/cdn/11dbbc25-ecf0-4fd7-9917-d98c83933cfb/fileType_jpg;size_600x600/11dbbc25-ecf0-4fd7-9917-d98c83933cfb"
      },
      {
        "Image View": "Images[0]",
        "Image Mime Type": "image/jpeg",
        "Image Description": "ContentPlus Image 1",
        "url": "https://assets.syndigo.cloud/cdn/33eb8e9a-4f2b-4aca-8a2a-426c90990a2a/fileType_jpg;size_600x600/33eb8e9a-4f2b-4aca-8a2a-426c90990a2a"
      },
      {
        "Image View": "Images[1]",
        "Image Mime Type": "image/jpeg",
        "Image Description": "ContentPlus Image 2",
        "url": "https://assets.syndigo.cloud/cdn/f9277f47-7e41-477a-b5af-1538ee7b5dbd/fileType_jpg;size_600x600/f9277f47-7e41-477a-b5af-1538ee7b5dbd"
      },
      {
        "Image View": "A7C1",
        "Image Mime Type": "image/jpeg",
        "Image Description": "Back of Pack",
        "url": "https://assets.syndigo.cloud/cdn/016c964f-b1a7-422e-94c4-0676c150468f/fileType_jpg;size_600x600/016c964f-b1a7-422e-94c4-0676c150468f"
      },
      {
        "Image View": "MOBL",
        "Image Mime Type": "image/jpeg",
        "Image Description": "Mobile Image",
        "url": "https://assets.syndigo.cloud/cdn/20171c8e-e5c6-47ce-ad05-d899f7688c91/fileType_jpg;size_600x600/20171c8e-e5c6-47ce-ad05-d899f7688c91"
      }
    ],
    "Custom Content": {
      "Ecommerce Description": "When a hungry family asks for a meal, Hillshire Farm Smoked Sausage is the delicious answer to weeknight dinners. Fully cooked and ready in minutes, the flavorful smoked sausage is the perfect centerpiece for a farmhouse-quality meal with rich, bold flavor. From soups to stews, it\u2019s an instant family favorite. Perfectly seasoned and smoked to perfection, this kielbasa sausage can be prepared using a stove top or grill. For a tasty meal the whole family can enjoy, cook this delicious sausage and serve in a skillet with roasted vegetables and potatoes. Includes one 14 oz package of Hillshire Farm Polska Kielbasa Smoked Sausage. Hard work, dedication, and integrity are the values Hillshire Farm lives by\u2014and the ingredients put into every package of Hillshire Farm Smoked Sausage. Since 1934, the Hillshire Farm brand has stood for the honest, carefully crafted meats families love, made with the ingredients they deserve. The commitment to quality can be tasted in every bite.",
      "Bullet Points": [
        {
          "Bullet": "One 14 oz. Hillshire Farm Polska Kielbasa Smoked Sausage Rope"
        },
        {
          "Bullet": "Perfectly seasoned and smoked to perfection"
        },
        {
          "Bullet": "Easy to prepare for a weeknight dinner"
        },
        {
          "Bullet": "Great for meals the whole family can enjoy"
        },
        {
          "Bullet": "Fully cooked and ready in minutes"
        },
        {
          "Bullet": "Simply heat on the stovetop or grill"
        }
      ]
    }
  }
]
```

### Use Cases

- **Market Research**: Gather product details for analyzing trends in grocery items and consumer preferences.
- **Competitive Intelligence**: Compare Stopandshop products with competitors by extracting descriptions and pricing data.
- **Price Monitoring**: Track product availability and updates for dynamic pricing strategies.
- **Content Aggregation**: Collect images and descriptions for building product catalogs or e-commerce platforms.
- **Academic Research**: Study food industry data, including categories and marketing content.
- **Business Automation**: Automate data feeds for inventory management or supply chain optimization.

### Installation and Usage

1. Search for "Stopandshop Parser Spider" in the Apify Store
2. Click "Try for free" or "Run"
3. Configure input parameters
4. Click "Start" to begin extraction
5. Monitor progress in the log
6. Export results in your preferred format (JSON, CSV, Excel)

### Output Format

The Actor outputs data in JSON format as an array of objects. Each object represents a scraped product and includes fields like "Pod Id", "GTIN", "Product Name", "Category", "Marketing Description", "Media" (an array of image objects with URLs and descriptions), and "Custom Content" (containing e-commerce descriptions and bullet points). This structured format ensures easy parsing and integration.

### Support

For custom/simplified outputs or bug reports, please contact:

- Email: support@getdataforme.com
- Subject line: "custom support"
- Contact form: https://getdataforme.com/contact/

We're here to help you get the most out of this Actor!

# Actor input Schema

## `Urls` (type: `array`):

The urls for the spider.

## `proxyConfiguration` (type: `object`):

Specifies proxy servers that will be used by the scraper in order to hide its origin.

## Actor input object example

```json
{
  "Urls": [
    "https://stopandshop.com/product/hillshire-farm-polska-kielbasa-rope-14-oz-pkg/61536"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getdataforme/stopandshop-parser-spider").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    } }

# Run the Actor and wait for it to finish
run = client.actor("getdataforme/stopandshop-parser-spider").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 '{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call getdataforme/stopandshop-parser-spider --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=getdataforme/stopandshop-parser-spider",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Stopandshop Parser Spider",
        "description": "The Stopandshop Parser Spider is an Apify Actor that scrapes comprehensive product data from Stopandshop.com, including names, descriptions, images, GTINs, and categories....",
        "version": "0.0",
        "x-build-id": "vcdV8wnWSK0g6GgVY"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/getdataforme~stopandshop-parser-spider/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-getdataforme-stopandshop-parser-spider",
                "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/getdataforme~stopandshop-parser-spider/runs": {
            "post": {
                "operationId": "runs-sync-getdataforme-stopandshop-parser-spider",
                "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/getdataforme~stopandshop-parser-spider/run-sync": {
            "post": {
                "operationId": "run-sync-getdataforme-stopandshop-parser-spider",
                "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": {
                    "Urls": {
                        "title": "Urls",
                        "minItems": 1,
                        "type": "array",
                        "description": "The urls for the spider.",
                        "default": [
                            "https://stopandshop.com/product/hillshire-farm-polska-kielbasa-rope-14-oz-pkg/61536"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Specifies proxy servers that will be used by the scraper in order to hide its origin.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
