Galeria do Samba – Historical Samba School Roster Scraper

Extract the complete carnival history from Galeria do Samba (galeriadosamba.com.br) — the authoritative archive of Brazilian samba schools with results, samba-enredo data, and school metadata going back to 1932.

What you get

One structured record per school-year combination, covering:

• School identity — slug, name, current group, status (active / inactive-extinct), founding date, colors, symbol, barrio
• Carnival results — year, final position, final score, parade order slot
• Samba enredo — title, enredo theme, carnavalesco, composers, intérprete
• Technical sheet — presidente, mestre-sala, porta-bandeira
• Source URL for verification

Coverage

Dimension	Scope
Groups	Grupo Especial, Grupo A (Série Ouro), Grupo D (Série Prata), Grupo E (Série Bronze), Grupo B, Grupo F (Avaliação), Inativas ou Extintas
Schools	50+ active + all extinct schools
Years	1932 to present
Estimated records	~5,000 – 10,000 school-year tuples

Use cases

• Music royalty tracking — samba-enredo composers earn royalties on Carnival TV broadcasts; this is the only structured catalogue covering all 90+ years of compositions
• Academic research — UFRJ samba studies, ethnomusicology programs, digital humanities
• Patrimônio Cultural Imaterial — Brazilian heritage NGO data feeds for UNESCO applications
• Tourism and media — historical context for Carnival coverage

Input

Field	Type	Default	Description
maxItems	integer	10	Maximum records to extract. Set to 0 for no limit (full archive).

Output sample

{
  "school_slug": "portela",
  "school_name": "Portela",
  "current_group": "Grupo Especial",
  "school_status": "active",
  "founded_date": "11 de abril de 1923",
  "barrio": "Oswaldo Cruz",
  "colors": ["Azul", "Branco"],
  "symbol": "Águia",
  "carnival_year": 2025,
  "parade_order_slot": 4,
  "final_position": 5,
  "final_score": 269,
  "samba_enredo_title": "Cantar será buscar o caminho que vai dar no Sol. Uma homenagem a Milton Nascimento",
  "samba_enredo_composers": [],
  "carnavalesco": "André Rodrigues e Antônio Gonzaga",
  "intérprete": "Gilsinho",
  "presidente": "Fábio Pavão",
  "mestre_sala": "Squel Jorgea",
  "porta_bandeira": "Marlon Lamar",
  "source_url": "https://www.galeriadosamba.com.br/escolas-de-samba/portela/2025/"
}

Notes

• Rate limiting — the actor crawls at 3 concurrent requests to respect Galeria do Samba's small server. Full-archive runs require a generous timeout (4 hours default).
• Data completeness — older records (pre-1980) may lack composers, intérprete, and technical sheet fields; the site itself has incomplete coverage for those years.
• Language — all data is in Brazilian Portuguese with full diacritics (UTF-8).