LUX Event Listings Scraper
Pricing
from $5.95 / 1,000 results
Collect LUX event listings and return event titles, types, start and end dates, times, venues, booking links, images and descriptions. Choose a year, event type, keyword or event URL; the WordPress API can retrieve events back to 2011, beyond the latest listing page.
LUX page URLs as {"url":"https://lux.org.uk/whats-on/"} objects. Accepts /event/, /event/{slug}/, /event_catogories/{slug}/, /years/{year}/ and /?s={keyword}. Empty returns newest events. Listing URLs combine with filters; single event URLs ignore type, year and keyword filters. URLs share maxItems. Dead or blocked targets return no rows with warnings; correct the URL or retry with proxyConfiguration.
LUX page URLs as strings, e.g. ["https://lux.org.uk/event/showing-up/"]. Accepts the same listing, archive, search and event URLs as startUrls. Both lists combine in order, share maxItems and skip duplicate events. Default [] adds no URLs.
[]Positive LUX WordPress event IDs as strings, e.g. IDs from a previous dataset. Default [] adds none. Runs after URLs, shares maxItems and skips duplicates. Type, year and search filters do not apply; upcomingOnly and date windows do. Unknown IDs return no rows with a warning.
[]Event type to keep, as the lux.org.uk type slug, e.g. 'screening-talk' (the most common), 'exhibition', 'workshop', 'education', 'performance', 'online-exhibition', 'in-dialogue' or 'lux-salon'. Empty (default) = every type. An unknown type returns 0 events with a warning.
Alias of eventType for callers that prefer this name; accepts a slug ('screening-talk') or a type name ('Screening/Talk'). Ignored when eventType is set. Default: empty.
Programme year to keep, e.g. '2017'. The year archive covers 2017 to the current year (events before 2017 have no year tag: use search or the full listing for them). An unknown year returns 0 events with a warning. Default: every year.
Keyword to search event titles and descriptions for, e.g. 'workshop' or 'Zoom' (the site's own search). A term with no hits returns 0 events with a warning. Default: no keyword.
Include events ending on or after this YYYY-MM-DD date. Empty default applies no lower bound. Uses event dates, not publication dates. Combines with dateTo and other filters; undated events are excluded. Examines up to dateScanLimit per target.
Include events starting on or before this YYYY-MM-DD date. Empty default applies no upper bound. Inclusive overlap retains exhibitions spanning the window. Must be on or after dateFrom when both are set.
Maximum newest events examined per target when dateFrom or dateTo is set. Integer 1-1000, default 100; ignored without date bounds. Combine year or search to narrow archive scans. With upcomingOnly, the smaller of this and upcomingScanLimit applies. Only returned events are charged.
Set true to keep events ending today or later in UTC, e.g. true. Default false includes past events. Checks newest publications up to upcomingScanLimit and shares maxItems across targets. If no rows match, increase upcomingScanLimit, relax other filters or set false.
Number of newest events to examine when upcomingOnly=true, e.g. 40. Integer 1-1000, default 100; ignored when upcomingOnly=false. Each examined event requires a detail request, but only returned events are charged. Increase this if the upcoming scan returns no rows.
Maximum events saved across all URLs and filters, e.g. 10. Integer 0-10000, default 50; 0 collects all matching events up to 10000. Duplicate ids count once. Stops at this shared result limit or the run spending limit; only saved events are charged.
Set true to include contentHtml in each row, e.g. true (default). Set false to omit contentHtml and reduce output size; description remains as plain text.
Proxy configuration object, e.g. {"useApifyProxy":true} (default: Apify datacenter proxy). Blocked requests retry with fresh sessions. If warnings show persistent HTTP 403 or a block page, retry later or select a residential group in this object.
{ "useApifyProxy": true}