Vinisfoods APIvinisfoods.com ↗
Access the complete Vini's Foods product catalog via API. Retrieve titles, prices, variants, availability, and images for Italian-inspired grocery products shipped across India.
What is the Vinisfoods API?
The Vini's Foods API exposes the store's full product catalog through a single list_products endpoint, returning up to the complete inventory in one response with 9 fields per product object including title, price, vendor, variants, tags, and image URL. It is suited for price monitoring, catalog integration, and building food-focused shopping tools targeting the Indian market.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/8b06c09b-e98c-484f-89b4-e4494cfc1d66/list_products' \ -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 vinisfoods-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: Vini's Foods SDK — bounded, re-runnable; every call capped."""
from parse_apis.vinisfoods_com_api import VinisFoods, ParseError
client = VinisFoods()
# List all products and print name + price info
for product in client.products.list(limit=3):
variant = product.variants[0] if product.variants else None
price = variant.price if variant else "N/A"
print(product.title, product.product_type, price)
# Get first product and inspect its details
item = client.products.list(limit=1).first()
try:
print(item.title, item.handle, item.vendor, item.tags)
for v in item.variants:
print(f" {v.title}: Rs.{v.price} (available={v.available})")
except ParseError as e:
print(f"error: {e.code}")
print("exercised: products.list")
Retrieve all products from the Vini's Foods catalog. Each product includes title, type, vendor, tags, variant details (size, price, availability), and image URL. Results are returned in a single page containing the complete catalog.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer count of products returned",
"products": "array of product objects with id, title, handle, product_type, vendor, tags, variants, image_url, published_at"
},
"sample": {
"data": {
"total": 31,
"products": [
{
"id": 7065624707208,
"tags": [
"Pasta and Pizza sauce",
"Sicily Range"
],
"title": "Pizza Sauce",
"handle": "pizza-sauce-classic",
"vendor": "Vini's Foods",
"variants": [
{
"id": 46132059537544,
"price": "275.00",
"title": "300 gm",
"available": true,
"compare_at_price": "275.00"
}
],
"image_url": "https://cdn.shopify.com/s/files/1/0591/5312/1416/files/PS-F.jpg?v=1784132150",
"product_type": "Sauce",
"published_at": "2026-06-23T05:48:00-04:00"
}
]
},
"status": "success"
}
}About the Vinisfoods API
What the API Returns
The list_products endpoint returns the complete Vini's Foods catalog in a single response. Each product object includes id, title, handle, product_type, vendor, tags, published_at, and image_url. The variants array within each product carries size options, per-variant pricing, and availability status — making it straightforward to track stock and price changes across SKUs.
Variants and Availability
Variant-level data is where the most actionable information lives. Each entry in the variants array corresponds to a distinct size or pack option, carrying its own price and availability flag. This allows you to distinguish between, for example, a 250g and 500g version of the same product without additional requests.
Coverage and Scope
The API covers Vini's Foods' Italian-inspired grocery range, including packaged foods, condiments, and specialty ingredients available for delivery across India. The product_type and tags fields allow downstream filtering and categorization of catalog items. The response also includes vendor data, which can help distinguish house-brand products from third-party items stocked by the store.
Pagination
Results are returned in a single page containing the full catalog. There are no pagination parameters or cursor tokens — one call to list_products yields the entire product set along with a total integer count confirming how many products were returned.
The Vinisfoods API is a managed, monitored endpoint for vinisfoods.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when vinisfoods.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official vinisfoods.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor price changes across Vini's Foods variants by polling
list_productsand comparing per-variant prices over time. - Build a product availability tracker that alerts when a specific SKU's availability flag changes to out-of-stock.
- Aggregate Italian specialty grocery data from multiple Indian online stores, using
product_typeandtagsfor normalization. - Populate a comparison shopping tool for Italian-inspired ingredients available for delivery in India.
- Index the full catalog into a search engine using
handle,title, andtagsas searchable fields. - Feed product images and descriptions into a recipe or meal-planning app using
image_urlandproduct_type. - Track catalog growth over time by recording the
totalcount andpublished_atdates from periodic API calls.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Vini's Foods have an official developer API?+
What does the `list_products` endpoint return for each product?+
id, title, handle, product_type, vendor, tags, published_at, image_url, and a variants array. The variants carry size options, individual prices, and availability status. The response also includes a top-level total field indicating how many products were returned.Can I filter products by type, tag, or vendor through the API?+
list_products endpoint takes no input parameters and returns the full catalog in one response. Filtering by product_type, tags, or vendor needs to be done client-side after retrieving the data. You can fork this API on Parse and revise it to add server-side filtering parameters.Does the API return customer reviews or ratings for products?+
How fresh is the catalog data, and does the API reflect real-time stock changes?+
list_products. For near-real-time stock tracking, polling at regular intervals is the recommended approach.