winecompanion.com.au APIwinecompanion.com.au ↗
Access Australian winery data from Wine Companion: contact details, regions, ratings, facilities, and winemaker info via 5 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/dc25aad6-8545-43c2-860a-9de838e2c7eb/list_wineries?page_size=10&page_number=1' \ -H 'X-API-Key: $PARSE_API_KEY'
List wineries from the Wine Companion directory with pagination. Returns basic winery info including name, region, state, rating, and facilities. Max page size is 50.
| Param | Type | Description |
|---|---|---|
| state | string | Filter by state (e.g., 'victoria', 'south australia', 'western australia') |
| region | string | Filter by wine region (e.g., 'barossa valley', 'margaret river', 'yarra valley') |
| page_size | integer | Results per page (max 50) |
| facilities | string | Filter by facilities (e.g., 'accommodation', 'cellardoor', 'food') |
| page_number | integer | Page number (1-indexed) |
{
"type": "object",
"fields": {
"count": "integer number of wineries returned on this page",
"wineries": "array of winery objects with basic info",
"page_size": "integer number of results per page",
"page_number": "integer current page number",
"total_results": "integer total number of wineries matching filters"
},
"sample": {
"data": {
"count": 10,
"wineries": [
{
"state": "South Australia",
"rating": 5,
"region": "Coonawarra",
"winery_id": "0dce19ec-b602-450a-8f01-e35fb6a1affa",
"facilities": [
"CellarDoor|Food"
],
"winery_name": "Parker Estate",
"winery_image": "https://cdn.winecompanion.com.au/-/media/wc/articles/wine-lists/coonawarra2022/parker-winery-tile.ashx",
"current_rating": 5,
"winery_url_path": "/wineries/south-australia/coonawarra/parker-estate",
"is_out_of_business": false,
"winecompanion_profile_url": "https://winecompanion.com.au/wineries/south-australia/coonawarra/parker-estate"
}
],
"page_size": 10,
"page_number": 1,
"total_results": 3569
},
"status": "success"
}
}About the winecompanion.com.au API
The Wine Companion API exposes 5 endpoints covering Australian winery listings, regional data, and full contact profiles sourced from winecompanion.com.au. The list_wineries endpoint returns paginated results with names, states, regions, ratings, and facilities, while get_winery_details surfaces phone, email, address, website, winemaker, established year, and opening hours for individual wineries. Filters across state, region, and facilities are supported throughout.
Winery Listings and Search
The list_wineries and search_wineries endpoints both return paginated arrays of winery objects with basic info: name, region, state, rating, and facilities. Both accept the same filter parameters — state (e.g., 'victoria', 'south australia'), region (e.g., 'barossa valley', 'margaret river'), and facilities (e.g., 'accommodation', 'cellardoor', 'food'). Page size is capped at 50, and each response includes total_results so you can calculate how many pages remain. The practical difference between the two endpoints is orientation: list_wineries is suited to browsing and pagination; search_wineries is oriented toward filtered lookups.
Individual Winery Profiles
get_winery_details accepts a url_path string (e.g., '/wineries/victoria/yarra-valley/de-bortoli') available in listing results and returns a richer record: phone, email, address, website_url, winemaker, established, state, region, and winery_name. Fields that are absent on the source profile are returned as null rather than omitted, so response shapes are consistent. The source_page field records which profile URL the data came from.
Regional Reference Data
get_regions returns a flat list of all Australian wine regions in the directory, each with a region_id, region_name, state, state_short, and region_url. Passing a state filter narrows results to that state's regions. This endpoint is useful for building valid filter values before calling the listing or search endpoints, since region names must match the directory's own slugs.
Bulk Detail Retrieval
get_all_wineries_with_details combines listing and detail lookups into a single batched response. limit and offset control which slice of the filtered winery list is processed, and the delay parameter controls the pause between individual profile fetches. Each returned winery object includes the full contact fields from get_winery_details. total_wineries_available tells you the full scope of the filtered dataset so you can page through it incrementally.
- Build a directory of Australian cellar doors filterable by state, region, and facilities like food or accommodation.
- Compile winery contact lists (phone, email, address) for a specific wine region such as the Barossa Valley.
- Enrich a wine tourism app with winemaker names, establishment years, and opening hours from individual profiles.
- Generate regional wine maps using
get_regionsto enumerate all Wine Companion region slugs and their states. - Batch-export contact details for all Victorian wineries using
get_all_wineries_with_detailswith a state filter. - Identify wineries offering accommodation or food by filtering the
facilitiesparameter in listing endpoints. - Track Wine Companion ratings across regions by pulling paginated listing data segmented by state.
| 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 | 250 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 Wine Companion have an official developer API?+
What is the difference between `list_wineries` and `search_wineries`?+
state, region, facilities, page_size, page_number) and return the same response shape. list_wineries is suited to sequential browsing of the full directory; search_wineries is oriented toward starting from a filter and retrieving matching results. If you are filtering by region or facilities, either endpoint works identically.Does the API return wine ratings or tasting notes for individual wines?+
What happens when a winery profile is missing contact fields like phone or email?+
get_winery_details returns null for any field not present on the winery's profile page — including phone, email, address, website_url, winemaker, and established. The response shape is consistent regardless of how complete the source profile is, so you can safely access every field without existence checks.Is the listing data limited to specific Australian states, or does it cover the full country?+
state filter accepts values like 'victoria', 'south australia', 'western australia', 'new south wales', and others present in the Wine Companion directory. Use get_regions without a state parameter to see the full geographic scope before filtering.