Vignerons Independants APIvignerons-independants.com ↗
Search the official directory of independent French winemakers. Filter by region, grape variety, wine color, farming method, medals, and activities.
What is the Vignerons Independants API?
The Vignerons Indépendants de France API exposes one endpoint — search_vignerons — that queries the official French independent winemakers directory and returns up to 12 paginated results per page. Each result includes the domaine name, owner, region, address, wine count, certification labels, and medals won. You can filter simultaneously by wine region, grape variety, cultural mode, wine color, competition awards, and winemaker activities.
curl -X GET 'https://api.parse.bot/scraper/af7e0de3-8ddf-4494-aacc-0b2784f460bb/search_vignerons?page=1&query=bordeaux&cultural_mode=vin_biologique__c' \ -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 vignerons-independants-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: Vignerons Indépendants SDK — search French independent winemakers."""
from parse_apis.vignerons_independants_com_api import (
VigneronsIndependants,
WineRegion,
WonCompetition,
CulturalMode,
InputFormatInvalid,
)
client = VigneronsIndependants()
# Search for organic (bio) vignerons in Bordeaux, capped at 5 results.
for vigneron in client.vignerons.search(
wine_region=WineRegion.BORDEAUX,
cultural_mode=CulturalMode.BIO,
limit=5,
):
print(vigneron.name, "|", vigneron.region, "|", vigneron.address)
# Find a single award-winning vigneron using .first()
winner = client.vignerons.search(
won_competition=WonCompetition.CONCOURS_PARIS_2022,
limit=1,
).first()
if winner is not None:
print(f"\nFeatured: {winner.name} ({winner.slug})")
print(f" Region: {winner.region}")
print(f" Owner: {winner.owner}")
print(f" Wines: {winner.wine_count}")
print(f" URL: {winner.url}")
# Free-text search for a grape variety, with error handling
try:
for v in client.vignerons.search(grape_variety="pinot-noir", limit=3):
print(v.name, "-", v.labels if v.labels else "no labels")
except InputFormatInvalid as e:
print(f"Invalid filter input: {e.message}")
print("\nexercised: vignerons.search with region/cultural_mode/won_competition/grape_variety filters")
Search the directory of Vignerons Indépendants de France. Returns paginated results of winemakers matching the specified filters. Each page returns up to 12 results. All filter parameters accept comma-separated values to select multiple options simultaneously. When no filters are provided, returns all vignerons in the directory.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. Each page contains up to 12 results. |
| query | string | Free-text search for domaine name, appellation, vigneron name, or wine. |
| activity | string | Winemaker activity/service filter. Comma-separated for multiple values. |
| wine_color | string | Wine color filter. Comma-separated for multiple values. |
| wine_region | string | Wine region filter. Comma-separated for multiple values. |
| cultural_mode | string | Culture/farming method filter. Comma-separated for multiple values. |
| grape_variety | string | Grape variety (cepage) filter. Comma-separated for multiple values. Examples: cabernet-sauvignon, merlot, chardonnay, pinot-noir. |
| won_competition | string | Competition/medal filter. Comma-separated for multiple values. |
| wine_characteristic | string | Wine characteristic/style filter. Comma-separated for multiple values. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"has_more": "boolean indicating if more pages are available",
"vignerons": "array of vigneron objects with name, slug, url, owner, region, address, wine_count, labels, and medals",
"total_results": "integer total number of matching vignerons"
},
"sample": {
"data": {
"page": 1,
"has_more": true,
"vignerons": [
{
"url": "https://www.vignerons-independants.com/annuaire-des-vignerons-independants-de-france/domaine-belle",
"name": "DOMAINE BELLE",
"slug": "domaine-belle",
"owner": "Valentin BELLE, Philippe BELLE",
"labels": [
"Bio"
],
"medals": "3 Medailles",
"region": "Vallee du Rhone",
"address": "510 Rue De La Croix 26600 LARNAGE France",
"wine_count": 5
}
],
"total_results": 1162
},
"status": "success"
}
}About the Vignerons Independants API
What the API returns
The search_vignerons endpoint searches the directory of Vignerons Indépendants de France, the national federation of independent French wine producers. Each response includes a vignerons array of producer objects, a total_results count, the current page number, and a has_more boolean for pagination. Individual vigneron objects carry the domaine name, slug, url, owner name, region, postal address, wine_count, certification labels (such as organic or biodynamic), and medals won in competitions.
Filtering and search
The endpoint accepts a free-text query parameter that matches against domaine name, appellation, vigneron name, or wine name. Structured filters include wine_region, wine_color, cultural_mode (farming method), grape_variety (e.g. cabernet-sauvignon, merlot, chardonnay), won_competition for medal filters, and activity for services offered by the producer. All filter parameters accept comma-separated values, so you can request multiple grape varieties or regions in a single call.
Pagination
Results are paginated at 12 vignerons per page. Use the page integer parameter to advance through result sets. The has_more boolean in each response tells you whether additional pages exist, and total_results gives the full match count across all pages.
The Vignerons Independants API is a managed, monitored endpoint for vignerons-independants.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when vignerons-independants.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 vignerons-independants.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?+
- Build a wine producer discovery tool filtered by region and grape variety using the
wine_regionandgrape_varietyparams - Compile a list of certified organic or biodynamic domaines by filtering on
cultural_modeand inspecting returnedlabels - Find medal-winning producers for a specific competition using the
won_competitionfilter and surface theirmedalsdata - Aggregate wine counts by region by iterating pages and summing the
wine_countfield per vigneron - Power a domaine search feature by passing user input to the
queryparameter for name, appellation, or wine lookups - Filter producers offering specific visitor activities (tastings, cellar tours) using the
activityparameter - Build a regional supplier database for a wine importer by extracting
owner,address, andurlfields per result
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does vignerons-independants.com provide an official developer API?+
What does a single vigneron object in the response look like?+
vignerons array includes: name (domaine name), slug, url (link to the producer's directory page), owner (winemaker's name), region, address, wine_count (number of wines listed), labels (certifications such as organic or biodynamic), and medals (competition awards the domaine has received).Can I retrieve individual producer detail pages — full wine lists, tasting notes, or contact forms?+
Are there any known limitations on coverage or filter values?+
grape_variety, wine_region, and activity must match the slugs used in the source directory; free-form strings that don't correspond to a recognized value will return zero results.