# Gopuff Scraper - US Quick-Commerce Prices & Assortment

**Use case:** 

Scrape Gopuff US. Search by location/product. Get price, promo, stock per fulfillment center. Monitor availability changes.

## Input

```json
{
  "mode": "categories",
  "locations": [
    "78701"
  ],
  "categoryInputs": [
    "https://www.gopuff.com/c/candy/txERmYDy"
  ],
  "discoverCategories": true,
  "inStockOnly": false,
  "productInputs": [
    "https://www.gopuff.com/p/banana---1ct/p198176"
  ],
  "maxItems": 20,
  "maxPages": 0,
  "pageSize": 50,
  "fetchDetails": false,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxNotifyListings": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

## Output

```json
{
  "kind": {
    "label": "Kind"
  },
  "productId": {
    "label": "Product id"
  },
  "sku": {
    "label": "Sku"
  },
  "url": {
    "label": "Url"
  },
  "title": {
    "label": "Title"
  },
  "brand": {
    "label": "Brand"
  },
  "categoryId": {
    "label": "Category id"
  },
  "categoryName": {
    "label": "Category name"
  },
  "locationId": {
    "label": "Location id"
  },
  "price": {
    "label": "Price"
  },
  "currency": {
    "label": "Currency"
  },
  "famPrice": {
    "label": "Fam price"
  },
  "priceChannel": {
    "label": "Price channel"
  },
  "pricePerUnitUsd": {
    "label": "Price per unit usd"
  },
  "unit": {
    "label": "Unit"
  },
  "famPricePerUnitUsd": {
    "label": "Fam price per unit usd"
  },
  "hasPromotion": {
    "label": "Has promotion"
  },
  "promotions": {
    "label": "Promotions"
  },
  "priceCallout": {
    "label": "Price callout"
  },
  "badges": {
    "label": "Badges"
  },
  "sizeLabel": {
    "label": "Size label"
  },
  "availability": {
    "label": "Availability"
  },
  "quantityAvailable": {
    "label": "Quantity available"
  },
  "snapEligible": {
    "label": "Snap eligible"
  },
  "famOnly": {
    "label": "Fam only"
  },
  "sponsored": {
    "label": "Sponsored"
  },
  "imageUrl": {
    "label": "Image url"
  },
  "description": {
    "label": "Description"
  },
  "detailPrice": {
    "label": "Detail price"
  },
  "detailAvailability": {
    "label": "Detail availability"
  },
  "detailCategory": {
    "label": "Detail category"
  },
  "detailImageUrl": {
    "label": "Detail image url"
  },
  "priceScope": {
    "label": "Price scope"
  },
  "changeType": {
    "label": "Change type"
  },
  "changedFields": {
    "label": "Changed fields"
  },
  "firstSeenAt": {
    "label": "First seen at"
  },
  "lastSeenAt": {
    "label": "Last seen at"
  }
}
```

## About this Actor

This example demonstrates how to use [Gopuff Scraper - US Quick-Commerce Prices & Assortment](https://apify.com/abotapi/gopuff-prices-assortment-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/abotapi/gopuff-prices-assortment-scraper.md) to learn more, explore other use cases, and run it yourself.


## 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.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/abotapi/gopuff-prices-assortment-scraper.md

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