Developer

This page is for developers who want to integrate with WHISKY:EDITION. The API returns JSON and is intended for integrations. Licensing and usage details are documented in the Imprint.

If you use the API in a website, app, dashboard, or internal tool, you must link to WHISKY:EDITION as the source.

We are genuinely interested in real use cases. Please send us a short email and tell us why and how you use the API: hello@thewhiskyedition.com

API Endpoints

Public endpoints and examples for integrating with the API.

English endpoints


                                
                                    Name
                                    Reviews List
                                
                                
                                    Endpoint
                                    GET https://thewhiskyedition.com/api/whisky-reviews/?page=<page>&per_page=<per_page>
                                
                                
                                    Example
                                    curl "https://thewhiskyedition.com/api/whisky-reviews/?page=1&per_page=24"
                                
                                
                                    Response
                                    {"ok":true,"lang":"en|de","count":...,"total":...,"page":...,"per_page":...,"items":[...]}


                                
                                    Name
                                    Review Detail
                                
                                
                                    Endpoint
                                    GET https://thewhiskyedition.com/api/whisky-reviews/<slug>
                                
                                
                                    Example
                                    curl "https://thewhiskyedition.com/api/whisky-reviews/wild-turkey-rare-breed"
                                
                                
                                    Response
                                    {"ok":true,"lang":"en|de","item":{...}}


                                
                                    Name
                                    Search
                                
                                
                                    Endpoint
                                    GET https://thewhiskyedition.com/api/search/?q=<query>&limit=<limit>
                                
                                
                                    Example
                                    curl "https://thewhiskyedition.com/api/search/?q=ardbeg&limit=10"
                                
                                
                                    Response
                                    {"ok":true,"lang":"en|de","query":"...","count":...,"items":[...]}


                                
                                    Name
                                    OpenAPI
                                
                                
                                    Endpoint
                                    GET https://thewhiskyedition.com/openapi.yaml
                                
                                
                                    Example
                                    curl "https://thewhiskyedition.com/openapi.yaml"
                                
                                
                                    Response
                                    YAML (OpenAPI 3.0)

German endpoints


                                
                                    Name
                                    Testberichte List
                                
                                
                                    Endpoint
                                    GET https://whiskyedition.de/api/whisky-testberichte/?page=<page>&per_page=<per_page>
                                
                                
                                    Example
                                    curl "https://whiskyedition.de/api/whisky-testberichte/?page=1&per_page=24"
                                
                                
                                    Response
                                    {"ok":true,"lang":"en|de","count":...,"total":...,"page":...,"per_page":...,"items":[...]}


                                
                                    Name
                                    Testbericht Detail
                                
                                
                                    Endpoint
                                    GET https://whiskyedition.de/api/whisky-testberichte/<slug>
                                
                                
                                    Example
                                    curl "https://whiskyedition.de/api/whisky-testberichte/wild-turkey-rare-breed"
                                
                                
                                    Response
                                    {"ok":true,"lang":"en|de","item":{...}}


                                
                                    Name
                                    Search
                                
                                
                                    Endpoint
                                    GET https://whiskyedition.de/api/search/?q=<query>&limit=<limit>
                                
                                
                                    Example
                                    curl "https://whiskyedition.de/api/search/?q=ardbeg&limit=10"
                                
                                
                                    Response
                                    {"ok":true,"lang":"en|de","query":"...","count":...,"items":[...]}


                                
                                    Name
                                    OpenAPI
                                
                                
                                    Endpoint
                                    GET https://whiskyedition.de/openapi.yaml
                                
                                
                                    Example
                                    curl "https://whiskyedition.de/openapi.yaml"
                                
                                
                                    Response
                                    YAML (OpenAPI 3.0)

Parameters

Parameters: List endpoint

page optional, result page (min 1)
per_page optional, items per page (1..100)
q optional, full-text filter across title/description/metadata
country optional filter
region optional filter
distillery optional filter
bottler optional filter
flavour optional filter
type optional filter
min_age optional minimum age
max_age optional maximum age
min_abv optional minimum ABV
max_abv optional maximum ABV
min_price optional minimum price per liter
max_price optional maximum price per liter

Parameters: Detail endpoint

slug required path parameter

Parameters: Search

q required, minimum 2 characters
limit optional, result limit (1..100, default: 50)

Error Codes

Error Codes: Reviews API

400 Invalid request parameters.
404 Review or endpoint not found.
405 Method not allowed.
429 Too many requests.
500 Server error.

Error Codes: Search API

400 Invalid search query or request parameters.
405 Method not allowed.
500 Server error.