Authentication

All API requests require authentication via a Bearer token in the Authorization header.

Getting an API Key

1

Create an account

Register on our developer page. You get a free 14-day trial with full API access.
2

Generate your API key

In your dashboard, navigate to Settings → API Keys to create a new key.
3

Store your key securely

Your API key is shown only once. Store it in a secure location like an environment variable.

Using your API Key

Include your API key as a Bearer token in the Authorization header of every request:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://grapeminds.eu/api/public/v1/wines

Example with different languages

Use the Accept-Language header to receive descriptions in your preferred language:

# German
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept-Language: de" \
     "https://grapeminds.eu/api/public/v1/wines/9146"

# French
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept-Language: fr" \
     "https://grapeminds.eu/api/public/v1/wines/9146"

Authentication Errors

401 Unauthenticated

The API key is missing or invalid. Ensure you include a valid Bearer token.

{ "message": "Unauthenticated." }

403 Forbidden

Your API key does not have permission to access this resource. Enterprise endpoints require an Enterprise subscription.

Security Best Practices

Never expose your API key in client-side code or public repositories.

Use environment variables to store your API key.

Rotate your API key periodically. You can do this in your dashboard under Settings → API Keys.

Always use HTTPS when making API requests.

Ready to get started?

Try the grapeminds Wine API free for 14 days.