GlobalWineScore API Documentation API

Overview

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 <a href="https://www.globalwinescore.com/plans" target="_blank">our plans</a>. # 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 <b>Token</b> must be written. Your requests must also use the <b>HTTPS</b> protocol. If you don't have a token yet, you need to apply for one [here](https://www.globalwinescore.com/api/). Your personal token can be found under the <a href="https://www.globalwinescore.com/account/api/" target="_blank">My account > API</a> section of the GlobalWineScore website # Format The API provides several rendering formats which you can control using the `Accept` header or `format` query parameter. - JSON (default): no header or `Accept: application/json` - XML: `Accept: application/xml` # Rate limiting For API requests, the rate limit allows for up to 10 requests per minute. # Error handling Whether a request succeeded is indicated by the HTTP status code. A 2xx status code indicates success, whereas a 4xx status code indicates failure. When a request fails, the response body is still JSON, but always contains a `detail` field with a description of the error, which you can inspect for debugging. For example, trying to access the API without proper authentication will return code 403 along with the message: `{"detail": "Authentication credentials were not provided."}` Found a bug ? send us an email at <a href="mailto:[email protected]">[email protected]</a> # Ordering At the moment, GlobalWineScores may be sorted by `date` and `score`. Use "-" to sort in descending order. # Continuous synchronization If you need to synchronize your database with our API, you can query our API using `?ordering=-date` to get the newest scores first, which means you won't have to crawl the whole catalog every time :-) # Quick search interface If you need to search our catalog (e.g. to align it with yours), we're providing you with a handy interface accessible here: <a href="https://api.globalwinescore.com/search/" target="_blank">https://api.globalwinescore.com/search/</a> You need to be logged in (email/password) to access this page, but other than that you can share it with anyone in your team and start searching right away ! # Resources The details about available endpoints can be found below. You can click on each endpoint to find information about their parameters.

GlobalWineScore API Documentation is an open data API from globalwinescore.com. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 2 endpoints.

At a glance

Authentication

API key

HTTPS

Yes

CORS

Unknown

Category

Open Data

Base URL

https://api.globalwinescore.com

Version

8234aab51481d37a30757d925b7f4221a659427e

Endpoints

2

OpenAPI

Specification ↗

Spec updated

2020-11-02

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

curl -X GET "https://api.globalwinescore.com/globalwinescores/" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch("https://api.globalwinescore.com/globalwinescores/", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);

import requests

response = requests.request(
    "GET",
    "https://api.globalwinescore.com/globalwinescores/",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

Questions