Zé Delivery Scraper

Extract product data with real prices from Zé Delivery — Brazil's largest beverage delivery platform owned by Ambev.

---

Table of Contents

• Quick Start
• Features
• Use Cases
• Input Parameters
• Output Examples
• Supported Categories
• Example Locations
• FAQ
• Support

---

Quick Start

Minimal Input (uses defaults)

{
  "categorySlug": "cervejas"
}

List All Categories

{
  "mode": "categories"
}

Full Input Example

Complete example with all available options:

{
  "mode": "products",
  "categorySlug": "cervejas",
  "address": {
    "latitude": -22.9068,
    "longitude": -43.1729,
    "street": "Avenida Atlântica",
    "number": "1000",
    "neighborhood": "Copacabana",
    "city": "Rio de Janeiro",
    "province": "RJ",
    "zipcode": "22010-000"
  },
  "maxProducts": 100,
  "maxPages": 10,
  "maxRetries": 3,
  "useApifyProxy": true,
  "proxyCountry": "BR"
}

Without Proxy (for testing)

{
  "categorySlug": "vinhos",
  "useApifyProxy": false
}

Note: If no address is provided, São Paulo (Av. Paulista, 1578) is used as default.

---

Features

Feature	Description
Real Prices	Actual prices by setting a delivery address
Discount Detection	Captures promotional prices and discount percentages
Complete Product Data	Names, brands, images, categories, and availability
15 Categories	Beers, wines, spirits, snacks, and more
Fast Extraction	Optimized for speed (no browser needed)
Structured Output	Clean JSON data ready for analysis

---

Use Cases

• Price Monitoring - Track beverage prices and promotions over time
• Market Research - Analyze product offerings and pricing strategies
• Competitor Analysis - Compare prices across different delivery platforms
• Inventory Tracking - Monitor product availability and stock
• Business Intelligence - Build datasets for beverage market insights
• E-commerce Integration - Sync product catalogs with your platform

---

Input Parameters

Basic Parameters

Parameter	Default	Description
mode	products	products = extract products, categories = list all categories
categorySlug	cervejas	Category to extract (only for products mode)
categoryUrl	-	Alternative: full category URL instead of slug

Address Object (Optional)

If not provided, uses São Paulo (Av. Paulista) as default. All fields are required when providing a custom address:

Field	Default	Description
latitude	-23.561414	Location latitude
longitude	-46.655882	Location longitude
street	Avenida Paulista	Street name
number	1578	Street number
neighborhood	Bela Vista	Neighborhood
city	São Paulo	City
province	SP	State code (2 letters)
zipcode	01310-200	ZIP code

Advanced Parameters

Parameter	Default	Description
maxProducts	0	Maximum products (0 = all)
maxPages	50	Maximum pagination pages
maxRetries	3	Retry attempts on failure
useApifyProxy	true	Enable Apify proxy (recommended)
proxyCountry	BR	Proxy country code (BR recommended)

---

Output Examples

Product

{
  "product_id": "54075",
  "name": "Brahma 350ml - Pack Econômico (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.jpg"
  ],
  "url": "https://www.ze.delivery/produtos/54075/brahma-350ml-pack-economico-12-unidades",
  "position": 15,
  "category_slug": "cervejas"
}

Note: Products without discounts will have has_discount: false and no discount field.

Category

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

---

Supported Categories

Slug	Category	Description
cervejas	Beers	All beer brands and types
vinhos	Wines	Red, white, rosé, sparkling
destilados	Spirits	Whisky, vodka, rum, gin, etc.
drinks-prontos	Ready-to-Drink	Pre-mixed cocktails
ofertas	Deals	Products on promotion
nao-alcoolicos	Non-Alcoholic	Sodas, juices, water
zero-fit	Zero & Fit	Low-calorie options
salgadinhos	Snacks	Chips, nuts, appetizers
churrasco	BBQ	Charcoal, meats, accessories
chopp	Draft Beer	Kegs and draft beer
aguas-gelo	Water & Ice	Bottled water, ice bags
sobremesas	Desserts	Sweets and desserts
mercearia	Grocery	Basic grocery items
conveniencia	Convenience	Quick grab items
sorvetes	Ice Cream	Ice cream and popsicles

---

Example Locations

Need coordinates for testing? Here are some popular Brazilian cities:

City	Latitude	Longitude	Address Example
São Paulo (default)	-23.561414	-46.655882	Av. Paulista, 1578
Rio de Janeiro	-22.9068	-43.1729	Av. Atlântica, 1000
Belo Horizonte	-19.9167	-43.9345	Praça da Liberdade
Brasília	-15.7942	-47.8822	Esplanada dos Ministérios
Salvador	-12.9714	-38.5014	Pelourinho
Curitiba	-25.4290	-49.2671	Rua XV de Novembro

How to get coordinates: Right-click on Google Maps and click on the coordinates to copy them.

---

FAQ

---

Support

Having issues?

1. Check the FAQ above for common solutions
2. Verify your input parameters match the examples
3. Test with defaults using just {"mode": "products", "categorySlug": "cervejas"}
4. Contact support through Apify for additional assistance