Creates an unofficial API by scraping Tabroom.com to facilitate tournament management and result tracking for the Speech and Debate community, supporting multiple programming languages.
Multiplatform API for Tabroom.com
Tabroom.com is a platform used by the Speech and Debate community to manage tournaments and post results. Since it does not have an official API, this repository scrapes the website to provide an API for developers to use.
api.tabroom.com?api.tabroom.com is a private API used by the Tabroom website that requires authentication.It's a good resource for getting surface-level information about yourself when you log in, but it doesn't provide the same level of detail as this API.
Maven
<dependencies>
<dependency>
<groupId>dev.gmitch215</groupId>
<artifactId>tabroom-api</artifactId>
<version>[VERSION]</version>
Gradle (Groovy)
dependencies {
implementation 'dev.gmitch215:tabroom-api:[VERSION]'
}
Gradle (Kotlin DSL)
dependencies {
implementation("dev.gmitch215:tabroom-api:[VERSION]")
}
NPM
npm install @gmitch215/tabroom-api
C/C++
#include <libtabroom_api_api.h>
gcc -o my_program my_program.c -ltabroom_api
<script src="https://cdn.gmitch215.dev/lib/TabroomAPI/tabroom-api-<version>.js"></script>
Contributions are welcome! Feel free to open an issue or submit a pull request.
import dev.gmitch215.tabroom.api.getTournament
import dev.gmitch215.tabroom.api.Entry
import dev.gmitch215.tabroom.api.Event
import dev.gmitch215.tabroom.api.Tournament
fun main() {
val tourney = getTournament(30082) // IDC Varsity State Championships 2024
val description = tourney.description
for (event in tourney.events) {
println("${event.name} Entries:") // Public Forum, Lincoln Douglas, Policy, Extemporanous Speaking, etc.
for (entry in event.entries) {
val school = entry.school // School name
val fullName = entry.name // Full name of the student
println("$fullName from $school is competing!")
}
}
}
import dev.gmitch215.tabroom.api.Entry;
import dev.gmitch215.tabroom.api.Event;
import dev.gmitch215.tabroom.api.TabroomAPI;
import dev.gmitch215.tabroom.api.Tournament;
public class Main {
public static void main(String[] args) {
// IDC Varsity State Championships 2024
Tournament tourney = TabroomAPI.getTournament(30082);
String description = tourney.getDescription();
for (Event event: tourney.getEvents()) {
System.out.println(event.getName() + " Entries:"); // Public Forum, Lincoln Douglas, Policy, Extemporanous Speaking, etc.
for (Entry entry : event.getEntries()) {
String school = entry.getSchool(); // School name
String fullName = entry.getName(); // Full name of the student
System.out.println(fullName + " from " + school + " is competing!");
}
}
}
}
tabroom.dev.gmitch215.tabroom.api.getTournament(30082)
.then(tournament => {
alert(tournament.description);
tournament.events.forEach(event => {
alert(event.name + " Entries:");
event.entries.forEach(entry => {
alert(entry.name + " from " + entry.school + " is competing!");
});
});
})
.catch(err => {
alert(err);
});
import * as tabroom from '@gmitch215/tabroom-api';
tabroom.dev.gmitch215.tabroom.api.getTournament(30082)
.then(tournament => {
console.log(tournament.description);
tournament.events.forEach(event => {
console.log(event.name + " Entries:");
event.entries.forEach(entry => {
console.log(entry.name + " from " + entry.school + " is competing!");
});
});
})
.catch(err => {
console.error(err);
});
Surfaced from shared tags and platforms — no rankings paid for.