Lozo APIlozo.com ↗
Search for grocery coupons by brand, keyword, or category to find current deals with discount amounts, coupon details, and direct links to the offers. Save money on your shopping by quickly discovering available coupons from Lozo's database.
curl -X POST 'https://api.parse.bot/scraper/2689dd27-5474-443e-b836-9b9cfa5a391b/search_coupons' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"page": "1",
"query": "Tide",
"category": "food_and_drink"
}'Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace lozo-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Lozo grocery coupons SDK — bounded, re-runnable; every call capped."""
from parse_apis.lozo_com_api import Lozo, Category, InvalidCategory
client = Lozo()
# Search coupons by brand name
for coupon in client.coupons.search(query="Tide", limit=3):
print(coupon.label, coupon.discount_amount, coupon.brands)
# Filter by category
item = client.coupons.search(category=Category.FOOD_AND_DRINK, limit=1).first()
if item:
print(item.description, item.source_url)
# Typed error handling
try:
for c in client.coupons.search(category=Category.HOUSEHOLD, query="Crest", limit=2):
print(c.label, c.root_category, c.stores)
except InvalidCategory as e:
print("bad category:", e.category)
print("exercised: coupons.search")
Search grocery coupons by brand/keyword and/or category. Returns paginated coupon results with discount details, brand associations, categories, and source links. Results are auto-iterated across pages; each page contains up to ~22 coupons.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| query | string | Search term to filter coupons by brand or product name (e.g. 'Tide', 'Crest', 'cereal'). |
| category | string | Filter by top-level coupon category. Omitting returns coupons from all categories. |
{
"type": "object",
"fields": {
"page": "integer — current page number",
"coupons": "array of coupon objects with id, label, description, discount_amount, discount_symbol, brands, categories, root_category, source_url, image_url, source_name, access_type, stores",
"results_count": "integer — number of coupons returned on this page",
"total_site_coupons": "integer — total coupons available on the site"
},
"sample": {
"data": {
"page": 1,
"coupons": [
{
"id": 715087,
"label": "$3.00 off",
"brands": [
"Tide®"
],
"stores": [],
"image_url": "https://new-lozo-prod.s3.amazonaws.com/offers/images/offer_712024.jpeg",
"categories": [
"Pod Laundry Detergent"
],
"source_url": "https://lozo.com/print-coupon/get-now/715087",
"access_type": "cashback_rebates",
"description": "Save $3.00 OFF ONE Tide PODS Laundry Detergent 102 ct TO 112 ct",
"source_name": "P&G Good Everyday",
"root_category": "Laundry Detergent",
"discount_amount": "3.00",
"discount_symbol": "$"
}
],
"results_count": 22,
"total_site_coupons": 2588
},
"status": "success"
}
}About the Lozo API
The Lozo API on Parse exposes 1 endpoint for the publicly available data on lozo.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.