Globalwinescore

GlobalWineScore API Documentation

The GlobalWineScore API is designed as a RESTful API, providing several resources and methods depending on your usage plan. For further information please…

Data & analytics#openapi#open-data

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

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 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 requests must also use the HTTPS protocol.

If you don't have a token yet, you need to apply for one here.

Your personal token can be found under the My account > API 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 api@globalwinescore.com

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: https://api.globalwinescore.com/search/

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.

Endpoints 2

GlobalWineScore

  • GETList all historical GWS/globalwinescores/?wine_id=114959,114952&vintage=2000&color=red&is_primeurs=false&lwin=1014033&lwin_11=10140332000&limit=100&offset=100&ordering=-dateReturns all available GWS
  • GETList all latest GWS/globalwinescores/latest/?wine_id=114959,114952&vintage=2000&color=red&is_primeurs=false&lwin=1014033&lwin_11=10140332000&limit=100&offset=100&ordering=-dateReturns the latest GWS available per wine/vintage.

API details

Base URL
https://api.globalwinescore.com
Authentication
An API key in the Authorization header
Operations
2 operations on 2 pathsGET 2
Main resources
GlobalWineScore 2
Response formats
application/json application/xml
Description format
OpenAPI 3.0.0, API version 8234aab51481d37a30757d925b7f4221a659427e
Listed from
APIs.guru OpenAPI Directory (CC0-1.0)
Source updated

How to test the GlobalWineScore API Documentation in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the GlobalWineScore API Documentation collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List all historical GWS” (GET /globalwinescores/?wine_id=114959,114952&vintage=2000&color=red&is_primeurs=false&lwin=1014033&lwin_11=10140332000&limit=100&offset=100&ordering=-date), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the GlobalWineScore API Documentation?

The GlobalWineScore API is designed as a RESTful API, providing several resources and methods depending on your usage plan. For further information please… It is listed under Data & analytics and has 2 endpoints.

Who publishes the GlobalWineScore API Documentation?

It is listed from Globalwinescore's public API description (an OpenAPI document), not published by Globalwinescore on Swastik Codes. Anyone who controls globalwinescore.com can claim the profile by adding a DNS TXT record.

What is the base URL of the GlobalWineScore API Documentation?

Requests go to https://api.globalwinescore.com. Endpoint paths are added to this base URL.

How do I authenticate with the GlobalWineScore API Documentation?

With an API key in the Authorization header.

How many endpoints does the GlobalWineScore API Documentation have?

2 operations on 2 paths (2 GET). The largest groups are GlobalWineScore.

Is forking the GlobalWineScore API Documentation free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.