Vinatis Wine Enricher

Enrich your wine catalogue with data from Vinatis.com — grape varieties, alcohol, tasting notes, reviews, food pairings, and labels. Paste Vinatis IDs (or CSV / URL), run, and get structured JSON + CSV. One input field, zero configuration for basic use.

---

Why Use This Actor?

Save Time

• No more manual copy-paste from product pages
• Process hundreds of wines in minutes with parallel requests
• Single field: paste IDs, CSV, or a CSV URL

Complete Data

• Grape varieties, alcohol, vintage, tasting notes (eye, nose, palate)
• Food pairings, ratings, customer reviews (up to 10 per wine)
• Labels ( organic, HVE, sulfites ), awards, storage instructions
• Vinatis prices, manufacturer info, domain description
• Canonical Vinatis URL for each wine

Reliable & Fast

• CheerioCrawler (HTTP) — 10× lighter than browser; Vinatis pages are static HTML with embedded JSON
• Residential proxy (Apify) to avoid 403 blocks on cloud runs
• 5 retries with proxy rotation on transient errors (590, 403, timeouts)
• CSV export with UTF-8 BOM (Excel-ready)

---

Perfect For

• Wine merchants — Enrich product feeds for e-commerce platforms
• Sommeliers — Build searchable databases with tasting notes and pairings
• Wine clubs — Add descriptions, scores, and recommendations to member catalogues
• Market research — Aggregate Vinatis data for price/composition analysis
• Data enrichment — Extend existing wine lists (CSV/IDs) with full Vinatis metadata

---

Quick Start

Minimal Input (paste IDs)

{
  "input": "81791\n81173\n79090",
  "maxItems": 0,
  "concurrency": 5
}

Supported Formats

Format	Example
IDs (one per line)	81791 81173 79090
IDs (comma-separated)	81791, 81173, 79090
CSV	id;name 81791;Ylirum 2024 - Vega Demara
CSV URL	https://example.com/wines.csv

💡 Bulk run: Put a CSV URL in input to process hundreds of wines in one go.

---

What You Get

Output: Dataset (JSON items) + Key-Value Store (enriched-wines.csv)

Category	Fields	Description
Identity	id, name, domaine, type, couleur	Wine ID, name, producer, type, color
Origin	pays, region, appellation, appellation_type	Country, region, AOC/IGP
Composition	cepage, millesime, alcool_vol, contenance	Grape(s), vintage, alcohol, volume
Service	temperature_service, service	Serving temp, bottle/carafe
Pricing	prix_vinatis, prix_vinatis_meilleur, prix_litre	Vinatis prices, price per liter
Ratings	note_sur_20, nb_votes	Score (out of 20), vote count
Flavors	taste_style, sucrosite, tanins	Taste profile (Fruité, Sec…), sweetness (Sec/Demi-sec/Moelleux/Liquoreux), tannins (fondus, souples, tannique)
Tasting	gouts, notes_degustation_oeil, notes_degustation_nez, notes_degustation_bouche	Flavor profile, eye/nose/palate notes
Pairings	accords_categories, accords_recommandes	Food pairing categories and suggestions
Labels	pictos, contient_sulfites	Organic, HVE, sulfites
Content	description, description_longue	Short and long descriptions
Reviews	avis_1 … avis_10, dernier_avis	Customer reviews (note, text, date)
Metadata	manufacturer_name, domaine_description, to_drink_until, recompenses	Producer, drink-by year, awards
Technical	url_vinatis, scrape_error	Canonical URL, error if page not found

Fields like appellation, vins_recommandes, and scrape_error are sometimes empty — that’s expected.

---

Input Options

Parameter	Type	Default	Description
input	string	—	Vinatis IDs (one per line or comma), pasted CSV, or CSV file URL
maxItems	integer	0	Max wines to process. 0 = all
concurrency	integer	5	Parallel requests. 5 recommended with residential proxy (1–15)
proxyConfiguration	object	Residential FR	Required on Apify Cloud to avoid 403. Use Apify proxy UI

Advanced (API / JSON): wines (array), csvUrl, csvPath, saveCsv, liveCsvPath

CSV Format (; separator)

Required columns: id, name (used to build https://www.vinatis.com/{id}-{slug(name)})

Optional columns preserved in output: domaine, type, region, appellation, couleur, Prix HT, PV TTC, etc.

id;name;domaine;type;region;appellation;couleur;Prix HT;PV TTC
81791;Ylirum 2024 - Vega Demara;Vega Demara;Vin;Castilla la Mancha;La Mancha;Rouge;5,75 €;6,90 €

Input CSV in Latin-1/Windows-1252 (Excel) is auto-detected. Output CSV is UTF-8 with BOM.

---

How to Use

Apify Console

1. Open the Actor and paste your Vinatis IDs (or CSV / URL) into IDs or data to enrich
2. Leave Limit at 0 for all wines, or set a cap for testing
3. Set Concurrency to 5 (default with proxy)
4. Use Proxy defaults (Residential FR)
5. Click Start
6. Download the Dataset or enriched-wines.csv from the Key-Value Store

Local Testing

1. Create or edit storage/key_value_stores/default/INPUT.json:

{
  "input": "81791\n81173\n79090",
  "maxItems": 0,
  "concurrency": 5
}

2. Run: apify run

3. Results: storage/datasets/default/ (JSON) and storage/key_value_stores/default/enriched-wines.csv

Important: Local storage is not synced to Apify Console. Use apify push and run on the platform to see results in the Console.

---

Storage & Output

Storage	Content	Use case
Dataset (default)	One JSON object per wine	API, integrations, Apify Console
Key-Value Store	enriched-wines.csv	Excel, imports, sharing

• Local: storage/datasets/default/ + storage/key_value_stores/default/enriched-wines.csv
• Apify Cloud: Dataset + Key-Value Store in the run (downloadable from Console)

To disable CSV export: "saveCsv": false in input.

---

Technical Notes

• Residential proxy — Required on Apify Cloud (Vinatis returns 403 from datacenter IPs). FR by default. Disabled for local runs.
• CheerioCrawler (HTTP) — No browser; faster and lighter. Vinatis product pages are static HTML with embedded JSON.
• Concurrency — 5 default with proxy (slower, more stable). Up to 15 without proxy locally.
• Retries — 5 attempts with proxy rotation on 590 UPSTREAM502, 403, and timeouts.
• Timeout — 60 seconds per request for slower residential proxies.

---

Deploy

$apify push

Then run from the Apify Console or via API.

---

Last updated: February 2026