Developer 👨🏼‍💻

This page is for developers who want to integrate with WHISKY:EDITION. We provide a public API that allows access to our whisky reviews. Information about licensing and usage can be found in the Imprint.

API

The public API is read-only and returns JSON.

• Main endpoint: /api/whisky-reviews/?page=1&per_page=24
• Search endpoint: /api/search/?q=lagavulin&limit=20
• OpenAPI spec: /openapi.yaml

Request examples

• List reviews: /api/whisky-reviews/?page=1&per_page=24
• Review detail: /api/whisky-reviews/<slug>
• Search: /api/search/?q=ardbeg&limit=10

Parameters

• page: optional, starts at 1
• per_page: optional, range 1..100
• q (search): required, minimum 2 characters
• limit (search): optional, range 1..100

Errors

• 400: invalid request parameters
• 404: review slug not found
• 429: rate limited
• 500: data temporarily unavailable

Contact

For integration questions, email hello@thewhiskyedition.com.