Setlist.fm Search Scraper

This actor allows you to search and scrape setlists from Setlist.fm by providing a search URL. It automatically handles pagination and extracts comprehensive setlist information including artist details, venue information, performance dates, set times, and song lists.

Features

• URL-based Scraping: Find setlists by providing a Setlist.fm search URL
• Automatic Pagination: Automatically navigates through pages to collect all available setlists
• Comprehensive Setlist Data: Extract detailed information about each performance including:
  • Performance date and title
  • Artist name and profile URL
  • Venue name and location
  • Set times (doors and show times)
  • Complete song lists
• Data Enrichment: Each record includes the original search URL and timestamp for traceability

Input Parameters

Field	Type	Required	Description
searchUrl	string	Yes	Complete Setlist.fm search URL to scrape
maxItems	integer	No	Maximum number of setlists to fetch

Output

The output is a main list of setlist objects, each containing:

• searchUrl: The original search URL used
• uniqueId: Unique identifier for the setlist
• date: Performance date
• setlistTitle: Title of the setlist
• setlistUrl: URL to the full setlist page
• setlistId: Setlist identifier
• artistName: Name of the performing artist
• artistUrl: URL to the artist's profile page
• venueName: Name of the venue
• venueUrl: URL to the venue page
• setTimes: Door and show times information
• songs: Array of songs performed
• setSummaryText: Summary text of the performance
• scrapedAt: Timestamp of when the setlist was scraped

Example output:

[
  {
    "searchUrl": "https://www.setlist.fm/search?query=ye",
    "uniqueId": "434bf7bf",
    "date": "Feb 5, 2026",
    "setlistTitle": "Ye Vagabonds at The Ark, Ann Arbor, MI, USA",
    "setlistUrl": "setlist/ye-vagabonds/2026/the-ark-ann-arbor-mi-434bf7bf.html",
    "setlistId": "434bf7bf",
    "artistName": "Ye Vagabonds",
    "artistUrl": "setlists/ye-vagabonds-1bf69180.html",
    "venueName": "The Ark, Ann Arbor, MI, USA",
    "venueUrl": "venue/the-ark-ann-arbor-mi-usa-73d6ca29.html",
    "setTimes": "",
    "songs": [],
    "setSummaryText": "",
    "scrapedAt": "2026-02-06T10:30:00.000Z"
  },
  {
    "searchUrl": "https://www.setlist.fm/search?query=ye",
    "uniqueId": "734b9afd",
    "date": "Feb 2, 2026",
    "setlistTitle": "Ye Vagabonds at Johnny Brenda's, Philadelphia, PA, USA",
    "setlistUrl": "setlist/ye-vagabonds/2026/johnny-brendas-philadelphia-pa-734b9afd.html",
    "setlistId": "734b9afd",
    "artistName": "Ye Vagabonds",
    "artistUrl": "setlists/ye-vagabonds-1bf69180.html",
    "venueName": "Johnny Brenda's, Philadelphia, PA, USA",
    "venueUrl": "venue/johnny-brendas-philadelphia-pa-usa-7bd6da88.html",
    "setTimes": "",
    "songs": ["Blue is the Eye", "On Sitric Road", "The Flood", "Cuckoo Storm", "Tuaim", "Four Walls", "Young Again", "Long Grass"],
    "setSummaryText": "Blue is the Eye On Sitric Road The Flood Cuckoo Storm Tuaim Four Walls Young Again Long Grass",
    "scrapedAt": "2026-02-06T10:30:01.000Z"
  },
  ...
]

Use Cases

• Music research and artist performance history analysis
• Concert tour tracking and venue research
• Fan community setlist databases
• Music journalism and reporting
• Historical performance data collection

Notes

• Results are automatically paginated until reaching the end or max items limit
• Setlists may include partial song lists if not fully documented
• Some setlists may not include set times or complete song lists
• The actor includes random delays between actions to avoid rate limiting

---

Start discovering setlists on Setlist.fm today!