visitlondon APIvisitlondon.com ↗
Search and filter London events from visitlondon.com by date range and category. Returns titles, prices, ratings, coordinates, and pagination across all results.
What is the visitlondon API?
The visitlondon.com API exposes 1 endpoint — search_events — that returns paginated London event listings with 9 fields per event including title, category, date range, price, rating, rating count, and geographic coordinates. You can filter by start and end date using D-M-YYYY format and narrow results to a specific event category, making it practical for building event finders, itinerary tools, or location-aware city guides.
curl -X GET 'https://api.parse.bot/scraper/6cc28352-f0f2-4334-9b42-6edf2ccd27c6/search_events?page=1&to_date=28-7-2026&category=art-and-exhibitions&from_date=14-7-2026' \ -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 visitlondon-com-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: visitlondon_com_api SDK — bounded, re-runnable; every call capped."""
from parse_apis.visitlondon_com_api import VisitLondon, Category, InvalidInput
client = VisitLondon()
# Search all events starting from today, capped at 3 results
for event in client.events.search(from_date="14-7-2026", limit=3):
print(event.title, event.category, event.price)
# Filter by category with a date range
for event in client.events.search(
from_date="14-7-2026", to_date="31-7-2026", category=Category.THEATRE, limit=3
):
print(event.title, event.date, event.latitude, event.longitude)
# Typed error catch around a search with invalid input
try:
client.events.search(from_date="bad-date", limit=1).first()
except InvalidInput as e:
print("invalid input:", e)
print("exercised: events.search")
Search London events with optional date range and category filters. Returns paginated results including event title, category, dates, price, ratings, and coordinates. Results are auto-iterated across pages.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results. |
| to_date | string | End date in D-M-YYYY format (e.g. 31-7-2026). Filters events occurring on or before this date. |
| category | string | Event category filter. Omitted or empty returns all categories. |
| from_date | string | Start date in D-M-YYYY format (e.g. 14-7-2026). Filters events occurring on or after this date. |
{
"type": "object",
"fields": {
"page": "current page number",
"events": "array of event objects with title, url, category, date, price, rating, rating_count, latitude, longitude",
"total_pages": "total number of available pages"
},
"sample": {
"data": {
"page": 1,
"events": [
{
"url": "https://www.visitlondon.com/things-to-do/event/6573327-wicked-at-the-apollo-victoria-theatre",
"date": null,
"price": "From £25.00",
"title": "Wicked at the Apollo Victoria Theatre",
"rating": "4.4",
"category": "Musical",
"latitude": 51.495775,
"longitude": -0.142679,
"rating_count": "Tripadvisor - 7651 ratings"
}
],
"total_pages": 6
},
"status": "success"
}
}About the visitlondon API
What the API Returns
The search_events endpoint returns a paginated list of events sourced from visitlondon.com's What's On listings. Each event object includes a title, url, category, date range, price, rating, rating_count, and geographic coordinates (latitude, longitude). The response also surfaces page and total_pages so you can walk the full result set programmatically.
Filtering and Pagination
Two date parameters — from_date and to_date — accept dates in D-M-YYYY format (e.g. 14-7-2026 and 31-7-2026) and filter events occurring within that window. The optional category parameter narrows results to a specific event type such as theatre, exhibitions, or concerts; omitting it returns events across all categories. The page parameter selects which result page to retrieve, and the API auto-iterates across pages, so total_pages tells you how many calls are needed to exhaust a query.
Coverage and Scope
Listings cover the breadth of events that appear on visitlondon.com's What's On section — concerts, theatre, exhibitions, family events, and more throughout Greater London. Each result includes a direct url back to the full event detail page on visitlondon.com, and coordinates allow downstream mapping or proximity filtering in your own application.
The visitlondon API is a managed, monitored endpoint for visitlondon.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when visitlondon.com 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 visitlondon.com 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?+
- Build a date-range event finder that queries search_events with from_date and to_date to surface upcoming London activities for a specific trip window.
- Populate a map with London event pins using the latitude and longitude fields returned per event.
- Filter free or low-cost events by category and inspect the price field to surface budget-friendly options.
- Aggregate rating and rating_count fields across categories to identify the highest-rated event types in a given period.
- Create a category-specific newsletter by querying search_events with a fixed category filter each week and paginating through all results.
- Feed event titles, dates, and URLs into a chatbot or itinerary planner to answer 'what's on in London this weekend' queries.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.