GlobalWineScore API Documentation

Name: GlobalWineScore API Documentation API
Brand: GlobalWineScore API Documentation
Availability: InStock

★ Only Publicly Available OpenAPI DocumentData EnrichmentData TransformationapiKey2 EndpointsREST

For Agents

Look up consolidated wine scores and historical rating trends from GlobalWineScore, the aggregator of major critic ratings.

Install Jentic One Beta

Connect the GlobalWineScore API Documentation to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GlobalWineScore API Documentation, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with GlobalWineScore API Documentation API.

Retrieve the latest GlobalWineScore for every wine in the catalogue in one call

Pull the historical score timeline for a wine to chart how its rating has evolved

Sort scores by date or score (ascending or descending) to surface the highest-rated or newest entries

GET STARTED

Start building with GlobalWineScore API Documentation API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use GlobalWineScore API Documentation API for, with concrete tasks.

★ Wine Retailer Catalogue Enrichment

Online wine retailers can enrich product pages with a critic-aggregated score by mapping their SKUs to GlobalWineScore wines and reading /globalwinescores/latest/ on a daily schedule. Showing a normalised score next to each bottle lifts conversion versus listing several critic scores side by side. Integration is a few hours given the small surface area.

GET /globalwinescores/latest/ with ordering=-score, paginate, and write each wine's score onto the matching SKU in the retailer's catalogue.

Investment-Grade Wine Trend Analysis

Wine investment platforms and merchants tracking secondary-market value can pull historical scores via /globalwinescores/?ordering=-date to chart how a vintage's rating has moved over time, then correlate against auction prices. The API returns JSON or XML so it slots into existing analytical pipelines with minimal transformation.

GET /globalwinescores/?ordering=-date and filter the response to a single wine ID, then build a time series of date-versus-score values.

AI Sommelier Recommendations

An AI sommelier agent can use GlobalWineScore through Jentic to back its recommendations with a critic-aggregated score, returning answers like "this 2016 vintage scored 94 on GlobalWineScore - higher than the 2015 you tried." Because the API is two endpoints, the agent only needs one Jentic search to integrate the data source.

Search Jentic for 'latest wine scores', load the schema for GET /globalwinescores/latest/, and execute it with a wine name filter, then summarise the top result.

Key Endpoints

2 endpoints — globalwinescore aggregates wine ratings from major critics into a single normalised score per wine and vintage, then exposes the catalogue through a small restful api.

METHOD

PATH

DESCRIPTION

GET

/globalwinescores/latest/

List the latest GlobalWineScore for every wine

GET

/globalwinescores/

List all historical GlobalWineScore entries

GET

/globalwinescores/latest/

List the latest GlobalWineScore for every wine

GET

/globalwinescores/

List all historical GlobalWineScore entries

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

GlobalWineScore tokens are stored encrypted in the Jentic vault. Agents receive a scoped credential reference and the Authorization header is injected at execution, so the raw token never appears in the agent's prompt.

Intent-based discovery

Agents search Jentic by intent ('latest wine scores', 'historical wine rating') and Jentic returns the right GlobalWineScore endpoint with its parameters, so the agent does not need to remember the /globalwinescores/latest/ vs /globalwinescores/ split.

Time to first call

Direct GlobalWineScore integration: 2-4 hours for token auth, paging, and rate-limit handling. Through Jentic: under 30 minutes - search, load, execute.

FAQs

Specific to using GlobalWineScore API Documentation API through Jentic.

What authentication does the GlobalWineScore API use?

GlobalWineScore uses token authentication. Send Authorization: Token {YOUR-API-TOKEN} on each request over HTTPS. The keyword Token is required by the API. Tokens are issued from the My account > API page after applying through globalwinescore.com/api/. Through Jentic the token is held in the vault.

What are the rate limits for the GlobalWineScore API?

The published limit is 10 requests per minute. Catalogue-sync jobs should poll /globalwinescores/?ordering=-date and ingest only newer records rather than crawling the full catalogue on every run, as recommended in the official documentation.

Can I get the historical score timeline for a wine?

Yes. GET /globalwinescores/ returns historical scores and supports ordering by date or score. Filter the response client-side by wine ID to build a per-wine time series.

How do I sync my retailer catalogue through Jentic?

Search Jentic for 'latest wine scores', load the schema for GET /globalwinescores/latest/, and execute it. Page through results and upsert into your product table. Run pip install jentic to get started.

Does the API support XML output?

Yes. The API supports JSON (default) and XML. Send Accept: application/xml or pass format=xml as a query parameter to receive the response in XML for legacy importers.

Is the GlobalWineScore API free?

GlobalWineScore offers tiered usage plans rather than a free public tier; details are at globalwinescore.com/plans. Apply for a token via the API page to see the plan attached to your account.