Peated
Peated
Sign inCreate account
ActivityBottlesDistillersBottlers

Peated API

Peated publishes its whisky catalog through a JSON API.

Read the catalog

The API lives at api.peated.com/v1. Call it from a command line or server. Public catalog GET requests return JSON without a token.

curl "https://api.peated.com/v1/bottles?query=Ardbeg&limit=10"

This searches bottle names for “Ardbeg” and returns up to 10 matches. Bottle lists put records in results. When rel.nextCursor contains a number, pass that number as cursor to read the next page. A page can contain up to 100 records.

API reference

The live API reference lists every path, query parameter, and response field. Tools that read OpenAPI can use the JSON specification.

Account access

Actions tied to a member need an OAuth bearer token. Peated registers OAuth clients manually; ask in Discord if you are building an integration.

Identify automated clients when possible, keep request rates reasonable, and do not degrade the service.

API resources

  • Live API referenceBrowse paths and response fields
  • OpenAPI specificationOpenAPI 3.1 JSON
  • Source on GitHub
  • Peated on DiscordAsk about access or integrations
Peated

A public record of whisky bottles, critic scores, and tasting notes from the people who drank them.

Explore

  • Locations
  • Brands
  • Whisky events

Reference

  • Catalog guide
  • Whisky categories
  • Tasting wheel
  • Rating guide
  • SMWS distillery codes

Project

  • About
  • Recent changes
  • API
  • Source
Explore
  • Locations
  • Brands
  • Whisky events
Reference
  • Catalog guide
  • Whisky categories
  • Tasting wheel
  • Rating guide
  • SMWS distillery codes
Project
  • About
  • Recent changes
  • API
  • Source

Edited by members · corrections welcome

Drink responsibly

TermsPrivacy