Ze Delivery Product Scraper

Extract products with real prices and discounts from Ze Delivery, Brazil's largest beverage delivery platform. Supports 15 categories including beer, wine, spirits, and snacks with location-based pricing.

---

Quick Start

Scrape beers (default category)

{
  "mode": "products",
  "categorySlug": "cervejas"
}

Scrape wines with a custom address and product limit

{
  "mode": "products",
  "categorySlug": "vinhos",
  "maxProducts": 50,
  "address": {
    "latitude": -22.9068,
    "longitude": -43.1729,
    "street": "Avenida Atlantica",
    "number": "1702",
    "neighborhood": "Copacabana",
    "city": "Rio de Janeiro",
    "province": "RJ",
    "zipcode": "22021-001"
  }
}

List all available categories

{
  "mode": "categories"
}

Tip: Prices vary by location. Provide an address with lat/lng to get accurate local pricing. Defaults to Sao Paulo (Av. Paulista).

---

Features

Feature	Description
15 Product Categories	Beers, wines, spirits, snacks, ice cream, and more
Location-Based Pricing	Real prices and discounts for any delivery address in Brazil
Two Extraction Modes	Extract products by category or list all available categories
Structured JSON Output	Clean, validated data ready for analysis — no browser needed

---

Use Cases

• Price Monitoring — Track beverage prices across different regions and detect discounts or promotions
• Competitor & Market Analysis — Compare product availability, brands, and pricing across categories
• Product Catalog Building — Build a structured database of all products available on Ze Delivery
• Regional Pricing Research — Analyze how delivery location affects product prices and availability

---

Input Parameters

Parameter	Type	Default	Description
mode	string	"products"	Extraction mode: products or categories
categorySlug	string	"cervejas"	Category slug (see Supported Categories below)
categoryUrl	string	—	Full category URL (alternative to categorySlug)
address	object	Sao Paulo	Delivery address with latitude, longitude, street, number, neighborhood, city, province, zipcode
maxProducts	integer	0	Max products to extract. 0 = all products
maxPages	integer	50	Max pages to fetch (pagination limit, 1-100)
maxRetries	integer	3	Max retry attempts on failure (1-10)
useApifyProxy	boolean	true	Enable Apify proxy. Recommended for reliability
proxyCountry	string	"BR"	Proxy country code. Use BR for best results

Note: Residential proxy with proxyCountry: "BR" is recommended for production use. Ze Delivery requires a Brazilian IP for accurate product data. Proxy usage is billed separately to your Apify account.

---

Output Example

Product output (mode: "products")

[
  {
    "product_id": "54075",
    "name": "Brahma 350ml - Pack Economico (12 unidades)",
    "brand": "Brahma",
    "category": "Cervejas",
    "price": 43.09,
    "price_max": 43.09,
    "discount": {
      "value": 0.0278,
      "discount_type": "2",
      "final_value": 41.89
    },
    "has_discount": true,
    "is_available": true,
    "images": [
      "https://courier-images-prod.imgix.net/produc_variant/00054075_..."
    ],
    "url": "https://www.ze.delivery/produtos/54075/brahma-350ml-pack-economico-12-unidades",
    "position": 0,
    "category_slug": "cervejas"
  },
  {
    "product_id": "105144",
    "name": "Skol Zero Zero 350ml",
    "brand": "SKOL",
    "category": "Cervejas",
    "price": 3.79,
    "price_max": 3.79,
    "is_available": true,
    "images": [
      "https://courier-images-prod.imgix.net/produc_variant/00105144_..."
    ],
    "url": "https://www.ze.delivery/produtos/105144/skol-zero-zero-350ml",
    "position": 1,
    "category_slug": "cervejas"
  }
]

Category output (mode: "categories")

[
  {
    "slug": "cervejas",
    "name": "Cervejas",
    "icon_url": "https://courier-images-prod.imgix.net/root-categories/category_cervejas_2x.png",
    "order": 33,
    "url": "https://www.ze.delivery/produtos/categoria/cervejas"
  }
]

Note: The discount field only appears when a product has an active promotion. Products without discounts omit this field; has_discount is always present.

---

Supported Categories

Slug	Name	Description
cervejas	Cervejas	Beers — lagers, IPAs, craft, and packs
vinhos	Vinhos	Wines — red, white, rose, and sparkling
destilados	Destilados	Spirits — whisky, vodka, gin, rum, cachaca
drinks-prontos	Drinks Prontos	Ready-to-drink cocktails and mixed drinks
ofertas	Ofertas	Special offers and promotions
nao-alcoolicos	Nao Alcoolicos	Non-alcoholic — sodas, juices, energy drinks
zero-fit	Zero e Fit	Zero-sugar and fitness beverages
salgadinhos	Salgadinhos	Snacks — chips, nuts, and party food
churrasco	Churrasco	BBQ — charcoal, meats, and accessories
chopp	Chopp	Draft beer — kegs and dispensers
aguas-gelo	Aguas e Gelo	Water and ice
sobremesas	Sobremesas	Desserts — chocolates and sweets
mercearia	Mercearia	Grocery — basic pantry items
conveniencia	Conveniencia	Convenience — quick essentials
sorvetes	Sorvetes	Ice cream and frozen treats

---

FAQ

---

Support

1. Check the FAQ above for common solutions
2. Test with default values using the cervejas category example
3. Contact support through Apify for additional assistance