Metztea APImetztea.hk ↗

Discover and browse METZ Tea's collection of premium teas, viewing product names, ingredients, and detailed specifications for each tea in their catalog. Find the perfect luxury tea by accessing comprehensive information about available options.

This API takes change requests — .

Endpoint health

monitored

get_tea_details

list_teas

Checks pendingself-healing

Endpoints

Updated

3h ago

This call costs1 credit / call— charged only on success

Try it

No input parameters required.

→ api.parse.bot/scraper/8ac5d335-37b2-499b-9696-ebef66f8c8f9/<endpoint>

Ready to send

Fill in the parameters and hit sign in to send to see live response data here.

Call it over HTTPgrab a free API key at signup

curl -X GET 'https://api.parse.bot/scraper/8ac5d335-37b2-499b-9696-ebef66f8c8f9/list_teas' \
  -H 'X-API-Key: $PARSE_API_KEY'

Python SDK · recommended

Typed, relational, agent-ready

A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.

Fully typed · autocompletes
Objects link to objects
Typed errors & pagination

Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:

uv add parse-sdk
uv run parse init
uv run parse add --marketplace metztea-hk-api

uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.

"""Walkthrough: METZ Tea SDK — bounded, re-runnable; every call capped."""
from parse_apis.metztea_hk_api import MetzTea, TeaNotFound

client = MetzTea()

# List all teas and print name + ingredients
for tea in client.tea_summaries.list(limit=3):
    print(tea.name, tea.ingredients)

# Drill into a specific tea's full details via the summary's navigation op
item = client.tea_summaries.list(limit=1).first()
full = item.details()
print(full.name, full.ingredients, full.origin, full.caffeine_content)

# Direct lookup by handle with typed error handling
try:
    detail = client.teas.get(handle="jasmine-dragon-tears")
    print(detail.name, detail.ingredients, detail.weight)
except TeaNotFound as e:
    print("not found:", e.handle)

print("exercised: tea_summaries.list / TeaSummary.details / teas.get")

All endpoints · 2 totalmissing one? ·

Retrieve all teas in the METZ Tea catalog with their names and ingredients. Returns the complete collection in a single response. Some teas may have null ingredients when the product listing does not include that information.

Input

No input parameters required.

Response

{
  "type": "object",
  "fields": {
    "teas": "array of tea objects with name, ingredients, and handle",
    "total": "integer total count of teas"
  },
  "sample": {
    "data": {
      "teas": [
        {
          "name": "Jasmine Dragon Tears",
          "handle": "jasmine-dragon-tears",
          "ingredients": "Green tea, Jasmine petals"
        },
        {
          "name": "Scottish Caramel Pu’er",
          "handle": "scottish-caramel-pu-er",
          "ingredients": "Black tea (Pu'er style), Almond pieces, Natural flavors (Organic Compliant). **Allergen Alert - Contains Almonds"
        },
        {
          "name": "Hangover Helper Herbal Mocktail Tea //Improves Circulation//",
          "handle": "hangover-helper",
          "ingredients": "Tomato, Ginger, Beet pieces, Hibiscus, Cinnamon, Cardamom, Black and White Pepper, Clove, Nutmeg"
        }
      ],
      "total": 81
    },
    "status": "success"
  }
}

About the Metztea API

The Metztea API on Parse exposes 2 endpoints for the publicly available data on metztea.hk. Calls return JSON over HTTPS and are billed per successful response.

Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.