Top-rated beers a user has NOT had, from a candidate list
untappd_top_not_hadRecommends top Untappd-rated beers you haven't tried from a list of candidate beer IDs, with optional style filter.
Instructions
The "what should I order off this tap list?" tool. From a list of candidate beer ids, return the top N the user has NOT yet had, ranked by Untappd global rating, with an optional style filter. Not-had filtering uses the cache only (both sources, no API call). Beer ratings/styles come from a metadata cache; a beer/info API call is made only on a cache miss or if the cached metadata is >30 days old, capped at api_budget calls per run (~100 calls/hour limit) — if more are needed it returns partial: true / another_run_needed: true, so re-running fills the rest. Reports the same freshness/caveat block as untappd_cache_not_had. Omit username for your own account.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bids | Yes | Candidate beer ids (1–100) | |
| style | No | Case-insensitive substring filter; matches EITHER the beer style or its parent style (e.g. "ipa") | |
| top_n | No | How many top beers to return (default 2, max 10) | |
| username | No | Untappd username. Omit to use your own configured account (UNTAPPD_USERNAME). | |
| api_budget | No | Max beer/info API calls this run for uncached/stale metadata (default 25). Keep modest to respect the ~100 calls/hour rate limit. |