Public content API

Public read-only reference access. Cite Uncle Larry’s Adventures with the returned page URL. Rights remain with their owners; this API grants no image/video republication license. Research listings are not scored visits; written recipes are not measured kitchen tests.

Read endpoints

CollectionList / detail
restaurants/api/public/catalog/restaurants
/api/public/catalog/restaurants/{slug}
rankings/api/public/catalog/rankings
/api/public/catalog/rankings/{slug}
festivals/api/public/catalog/festivals
/api/public/catalog/festivals/{slug}
recipes/api/public/catalog/recipes
/api/public/catalog/recipes/{slug}
episodes/api/public/catalog/episodes
/api/public/catalog/episodes/{slug}

Filters and pagination

All lists accept q, city, category, page (default 1) and limit (default 20, maximum 50). City and category matching ignores punctuation and case. Festival date filters from and to use YYYY-MM-DD and include overlapping events.

GET /api/public/catalog/recipes?category=Pasta&page=1&limit=10
GET /api/public/catalog/recipes/sausage-and-peppers
GET /api/public/catalog/festivals?from=2026-11-01&to=2026-12-31

Response contract

Responses contain data, total, page, limit, next_page and attribution. Every record includes its slug, title, category, citation URL, source URL and last-verified date. Unknown dates and scores are null—not guessed. Details return one record. Missing slugs return 404; invalid filters return 400.

Evidence and scores

Research-based restaurants are unscored. Owner pepper ratings are distinct from the five-category score. City rankings exist only after three real scored visits; otherwise the ranking list is empty. Read the scoring method. No private submissions, browser history, account data or admin drafts are exposed.

Caching and limits

Successful API responses may be cached for five minutes. API and catalog MCP reads share a site-wide limit of 3,000 uncached requests per minute, without storing IP addresses. At the limit, HTTP returns 429 and Retry-After: 60. Database failures return 503 rather than incomplete data. CORS permits public read requests; writes are not supported.

Shop recommendations

Larry’s Gift Finder uses existing Fourthwall products and Amazon product links already featured on the site. Purchases go directly to the seller, not this API. As an Amazon Associate, Uncle Larry Adventures earns from qualifying purchases. Prices are listed USD snapshots; no inventory, delivery or discount claims are supplied. Its anonymous selection and click counts are private owner reports, not public API records.

AI assistants and MCP

The existing public MCP server at https://unclelarryadventures.com/mcp exposes read-only search_restaurants, get_ranking, find_festivals, get_recipe and get_episode tools with citation URLs. It requires no login. Input/result limits apply. The API limit applies to these catalog tools.

llms.txt · Full citation text

Contact Larry

Recipe questions, restaurant tips, gear ideas, press and collabs — send it here.