Freshexpress APIfreshexpress.com ↗
Find and browse the latest coupons, promotional offers, and sweepstakes available for Fresh Express salad and produce products. Access current deals in one convenient place to save on your favorite Fresh Express items.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/65dbb541-be29-4a59-9097-8a4ff01df348/list_promotions' \ -H 'X-API-Key: $PARSE_API_KEY'
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 freshexpress-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: Fresh Express Promotions SDK — bounded, re-runnable; every call capped."""
from parse_apis.freshexpress_com_api import FreshExpress, PromotionType, PromotionsFetchError
client = FreshExpress()
# List all current promotions and offers, capped at 3
for promo in client.promotions.list(limit=3):
print(promo.title, promo.type, promo.discount_value, promo.entry_end)
# Filter sweepstakes using the enum
first = client.promotions.list(limit=1).first()
if first:
is_sweepstakes = first.type == PromotionType.SWEEPSTAKES
try:
print(first.title, "sweepstakes" if is_sweepstakes else "national", first.discount_value)
except PromotionsFetchError as e:
print("fetch error:", e)
print("exercised: promotions.list")
Retrieves all current Fresh Express promotions and offers, including national promotional campaigns and social media sweepstakes/giveaways. Each promotion includes title, description, dates, and discount value when available. Results are auto-iterated as a single page.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer count of promotions returned",
"promotions": "array of promotion objects with title, description, type, dates, and discount value"
},
"sample": {
"data": {
"total": 3,
"promotions": [
{
"id": 11632,
"link": "https://www.freshexpress.com/promotions/social-promotions-giveawayrules",
"slug": "social-promotions-giveawayrules",
"type": "national",
"title": "COOKING WITH ANTONI",
"entry_end": null,
"description": "Fresh Express is partnering with Emmy-winning TV personality Antoni Porowski for the Cooking with Antoni Sweepstakes! Enter now for a chance to win a virtual cooking session with Antoni himself, plus fresh prizes.",
"entry_start": null,
"date_modified": "2026-06-15T09:08:33",
"date_published": "2023-01-05T13:13:11",
"discount_value": null,
"featured_media_id": 20660
},
{
"id": 6567,
"link": "https://www.freshexpress.com/social-promotions/giveaway",
"slug": "giveaway",
"type": "sweepstakes",
"title": "ENTER NOW. IT'S FREE!",
"entry_end": "Tuesday, December 17, 2024",
"description": "",
"entry_start": "Wednesday, December 4, 2024",
"date_modified": "2024-12-13T14:03:44",
"date_published": "2021-11-01T11:18:53",
"discount_value": "$5.99",
"featured_media_id": 6568
}
]
},
"status": "success"
}
}About the Freshexpress API
The Freshexpress API on Parse exposes 1 endpoint for the publicly available data on freshexpress.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.