GlobalWineScore API Documentation

globalwinescore · Data

Data No Auth Free & Open open_data

The GlobalWineScore API is designed as a RESTful API, providing several resources and methods depending on your usage plan. For further information please refer to our plans . # Authentication The API uses token-based authentication. In order to authenticate your requests, you need to include a specific header in each of your requests: ``` Authorization: Token {YOUR-API-TOKEN} ``` The word Token must be written. Your

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET List all historical GWS

Returns all available GWS

https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores?lwin=example&color=red&limit=100&offset=0&lwin_11=example&vintage=example&wine_id=example&ordering=-date&is_primeurs=false

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/?lwin=example&color=red&limit=100&offset=0&lwin_11=example&vintage=example&wine_id=example&ordering=-date&is_primeurs=false"

import requests
params = {
    "lwin": "example",
    "color": "red",
    "limit": "100",
    "offset": "0",
    "lwin_11": "example",
    "vintage": "example",
    "wine_id": "example",
    "ordering": "-date",
    "is_primeurs": "false"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/');
url.searchParams.set('lwin', 'example');
url.searchParams.set('color', 'red');
url.searchParams.set('limit', '100');
url.searchParams.set('offset', '0');
url.searchParams.set('lwin_11', 'example');
url.searchParams.set('vintage', 'example');
url.searchParams.set('wine_id', 'example');
url.searchParams.set('ordering', '-date');
url.searchParams.set('is_primeurs', 'false');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/")
	q := baseURL.Query()
	q.Set("lwin", "example")
	q.Set("color", "red")
	q.Set("limit", "100")
	q.Set("offset", "0")
	q.Set("lwin_11", "example")
	q.Set("vintage", "example")
	q.Set("wine_id", "example")
	q.Set("ordering", "-date")
	q.Set("is_primeurs", "false")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/")
uri.query = URI.encode_www_form({
  "lwin" => "example",
  "color" => "red",
  "limit" => "100",
  "offset" => "0",
  "lwin_11" => "example",
  "vintage" => "example",
  "wine_id" => "example",
  "ordering" => "-date",
  "is_primeurs" => "false"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/?" . http_build_query([
    "lwin" => "example",
    "color" => "red",
    "limit" => "100",
    "offset" => "0",
    "lwin_11" => "example",
    "vintage" => "example",
    "wine_id" => "example",
    "ordering" => "-date",
    "is_primeurs" => "false"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET List all latest GWS

Returns the latest GWS available per wine/vintage.

https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/latest?lwin=example&color=red&limit=100&offset=0&lwin_11=example&vintage=example&wine_id=example&ordering=-date&is_primeurs=false

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/latest/?lwin=example&color=red&limit=100&offset=0&lwin_11=example&vintage=example&wine_id=example&ordering=-date&is_primeurs=false"

import requests
params = {
    "lwin": "example",
    "color": "red",
    "limit": "100",
    "offset": "0",
    "lwin_11": "example",
    "vintage": "example",
    "wine_id": "example",
    "ordering": "-date",
    "is_primeurs": "false"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/latest/",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/latest/');
url.searchParams.set('lwin', 'example');
url.searchParams.set('color', 'red');
url.searchParams.set('limit', '100');
url.searchParams.set('offset', '0');
url.searchParams.set('lwin_11', 'example');
url.searchParams.set('vintage', 'example');
url.searchParams.set('wine_id', 'example');
url.searchParams.set('ordering', '-date');
url.searchParams.set('is_primeurs', 'false');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/latest/")
	q := baseURL.Query()
	q.Set("lwin", "example")
	q.Set("color", "red")
	q.Set("limit", "100")
	q.Set("offset", "0")
	q.Set("lwin_11", "example")
	q.Set("vintage", "example")
	q.Set("wine_id", "example")
	q.Set("ordering", "-date")
	q.Set("is_primeurs", "false")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/latest/")
uri.query = URI.encode_www_form({
  "lwin" => "example",
  "color" => "red",
  "limit" => "100",
  "offset" => "0",
  "lwin_11" => "example",
  "vintage" => "example",
  "wine_id" => "example",
  "ordering" => "-date",
  "is_primeurs" => "false"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/globalwinescore.com/8234aab51481d37a30757d925b7f4221a659427e/globalwinescores/latest/?" . http_build_query([
    "lwin" => "example",
    "color" => "red",
    "limit" => "100",
    "offset" => "0",
    "lwin_11" => "example",
    "vintage" => "example",
    "wine_id" => "example",
    "ordering" => "-date",
    "is_primeurs" => "false"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with GlobalWineScore API Documentation?

GlobalWineScore API Documentation is a Data API. Developers commonly use data APIs for:

enriching your app with third-party datasets
building data pipelines and ETL workflows
querying and searching large datasets
powering research, analysis, and reporting tools
syncing reference data into your own systems

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. GlobalWineScore API Documentation is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗