Rosselli Group APIrosselligroup.eu ↗
Retrieve menu PDF links, reservation details, and social profiles from Rosselli Group venue pages like Forte dei Cappuccini in one API call.
What is the Rosselli Group API?
The Rosselli Group EU API exposes 1 endpoint — get_venue_menu_links — that returns up to 8 structured fields per venue page, including every menu PDF link (with label, URL, category, and year), reservation contact details, social profile links, and the latest-year menu set. It covers confirmed venue slugs such as forte-dei-cappuccini and pub-due and resolves current menus automatically by comparing file-name years.
curl -X GET 'https://api.parse.bot/scraper/b8e4e78d-b850-40e1-9c42-b5b592a7d3ea/get_venue_menu_links?page_slug=forte-dei-cappuccini' \ -H 'X-API-Key: $PARSE_API_KEY'
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 rosselligroup-eu-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: Rosselli Group venue menus — fetch menus and reservation info."""
from parse_apis.rosselligroup_eu_api import RosselliGroup, VenueNotFound
client = RosselliGroup()
# Fetch venue details by page slug (defaults to forte-dei-cappuccini).
try:
venue = client.venues.get(page_slug="forte-dei-cappuccini")
except VenueNotFound:
print("Venue page not found")
raise
print(f"{venue.name} — last modified {venue.page_last_modified}")
print(f"Latest menu year: {venue.latest_menu_year}")
# Current-year menus: restaurant cards, wine lists, etc.
for menu in venue.current_menus:
print(f" [{menu.category}] {menu.label} ({menu.year}) -> {menu.url}")
# Full archive of all menu links across years.
for menu in venue.menu_links:
print(f" {menu.label} ({menu.year}): {menu.url}")
# Reservation details
res = venue.reservation
if res is not None:
print(f"Phone: {res.phone}")
print(f"Booking URL: {res.booking_url}")
print(f"Request form on page: {res.request_form_on_page}")
# Social links
for link in venue.social_links:
print(f"{link.label}: {link.url}")
print("exercised: venues.get")
Returns every menu PDF link published on one Rosselli Group venue page, in one round trip. Each menu link carries its on-page label, absolute URL, a category inferred from the label/filename (restaurant, wine, drinks, dessert, or other) and the year found in the file name (null when the file name has no year). latest_menu_year is the highest year among the links and current_menus is the subset of menu_links for that year, so callers get the current season's menus without filtering. reservation reports what the page offers for booking: booking_url is null when the venue has no online booking link (the venues checked publish a phone number and an on-page request form instead), phone is the number shown in the reservation section, and request_form_on_page says whether a request form exists on the page. page_last_modified is the site's own last-edit timestamp (site local time, no offset). An unknown page_slug returns a stale_input (input_not_found) error; menu_links is never empty on success.
| Param | Type | Description |
|---|---|---|
| page_slug | string | Venue page slug as it appears in the page URL path on the site. Confirmed slugs: forte-dei-cappuccini, pub-due-ruote. |
{
"type": "object",
"fields": {
"venue": "venue name as titled on the page",
"page_url": "canonical URL of the venue page",
"menu_links": "array of {label, url, category, year} for every menu PDF on the page, in page order",
"reservation": "object {booking_url (string or null), phone (string or null), request_form_on_page (boolean), page_url}",
"social_links": "array of {label, url} social profile links shown on the page",
"current_menus": "array of menu link objects (same shape as menu_links) whose year equals latest_menu_year",
"latest_menu_year": "integer, highest year found among menu file names (null if none carry a year)",
"page_last_modified": "site last-edit timestamp of the page, ISO-like without offset"
},
"sample": {
"data": {
"venue": "FORTE DEI CAPPUCCINI",
"page_url": "https://www.rosselligroup.eu/forte-dei-cappuccini/",
"menu_links": [
{
"url": "https://www.rosselligroup.eu/wp-content/uploads/2023/05/FORTE-DEI-CAPPUCCINI-Menu-2022.pdf",
"year": 2022,
"label": "Sfoglia Il Menù",
"category": "restaurant"
},
{
"url": "https://www.rosselligroup.eu/wp-content/uploads/2026/03/FORTE-DEI-CAPPUCCINI-Menu-2026_BLU.pdf",
"year": 2026,
"label": "RISTORANTE",
"category": "restaurant"
},
{
"url": "https://www.rosselligroup.eu/wp-content/uploads/2025/05/PETISSO-Selection-2025_online.pdf",
"year": 2025,
"label": "PETISSO SELECTION",
"category": "other"
},
{
"url": "https://www.rosselligroup.eu/wp-content/uploads/2026/03/FORTE-DEI-CAPPUCCINI-Lista-vini-2026_BORDEAUX.pdf",
"year": 2026,
"label": "CARTA DEI VINI",
"category": "wine"
},
{
"url": "https://www.rosselligroup.eu/wp-content/uploads/2026/03/FORTE-DEI-CAPPUCCINI-Menu-dolci-2026_ARANCIO.pdf",
"year": 2026,
"label": "DOLCI",
"category": "dessert"
}
],
"reservation": {
"phone": "+39 0456 40 19 74",
"page_url": "https://www.rosselligroup.eu/forte-dei-cappuccini/",
"booking_url": null,
"request_form_on_page": true
},
"social_links": [
{
"url": "https://www.facebook.com/fortecappuccini",
"label": "Facebook"
}
],
"current_menus": [
{
"url": "https://www.rosselligroup.eu/wp-content/uploads/2026/03/FORTE-DEI-CAPPUCCINI-Menu-2026_BLU.pdf",
"year": 2026,
"label": "RISTORANTE",
"category": "restaurant"
},
{
"url": "https://www.rosselligroup.eu/wp-content/uploads/2026/03/FORTE-DEI-CAPPUCCINI-Lista-vini-2026_BORDEAUX.pdf",
"year": 2026,
"label": "CARTA DEI VINI",
"category": "wine"
},
{
"url": "https://www.rosselligroup.eu/wp-content/uploads/2026/03/FORTE-DEI-CAPPUCCINI-Menu-dolci-2026_ARANCIO.pdf",
"year": 2026,
"label": "DOLCI",
"category": "dessert"
}
],
"latest_menu_year": 2026,
"page_last_modified": "2026-03-30T23:21:47"
},
"status": "success"
}
}About the Rosselli Group API
What the API Returns
The single get_venue_menu_links endpoint accepts an optional page_slug parameter — a string matching the venue's URL path segment, such as forte-dei-cappuccini or pub-due. The response includes the venue's display name (venue), the canonical page URL (page_url), and the site's last-edit timestamp (page_last_modified) in an ISO-like format without timezone offset.
Menu Link Data
The menu_links array contains one object per PDF found on the page. Each object carries a label (the on-page text), an absolute url, a category inferred from the label or filename (restaurant, wine, drinks, dessert, or other), and a year integer extracted from the filename (or null if none is present). The current_menus field filters that array down to only the entries whose year matches latest_menu_year, making it straightforward to surface the most recent offerings without additional client-side logic.
Reservation and Social Data
The reservation object bundles the booking URL (booking_url, string or null), a phone number (phone, string or null), a flag indicating whether a request form appears on the page (request_form_on_page boolean), and the source page_url. The social_links array lists each social profile shown on the page as a {label, url} pair, covering platforms like Facebook or Instagram wherever they appear in the venue page.
The Rosselli Group API is a managed, monitored endpoint for rosselligroup.eu — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when rosselligroup.eu changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official rosselligroup.eu API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Embed current restaurant menus on a third-party hospitality aggregator by pulling
current_menusfor each venue slug - Build a wine-list browser by filtering
menu_linkswherecategoryequalswine - Sync reservation phone numbers and booking URLs into a CRM or booking widget using the
reservationobject - Track menu updates over time by storing and comparing
page_last_modifiedtimestamps across polling intervals - Populate a venue directory with social media profile links using the
social_linksarray - Alert staff when a new menu year appears by monitoring changes in
latest_menu_yearbetween requests
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Rosselli Group publish an official developer API for its venue data?+
How does `current_menus` differ from `menu_links`?+
menu_links contains every menu PDF found on the page in page order. current_menus is a filtered subset containing only those entries whose year field matches latest_menu_year — the highest year found across all menu filenames. If no filenames carry a year, both latest_menu_year and current_menus will reflect that with null or an empty result.Does the API cover multiple Rosselli Group venues?+
forte-dei-cappuccini and pub-due. These are the slugs documented in the page_slug parameter. Other venue pages on the domain are not currently covered. You can fork the API on Parse and revise it to add support for additional venue slugs.Can I retrieve menu item names, descriptions, or prices through this API?+
How fresh is the data returned by `get_venue_menu_links`?+
page_last_modified field reflects the site's own last-edit timestamp for the venue page, giving you a signal for when the source content changed. Freshness depends on how frequently you call the endpoint — there is no push or webhook mechanism, so stale data is possible if the page is updated between your requests.