FGC Tournament Scraper — start.gg and Liquipedia Data

Aggregate fighting game (FGC) and Smash tournament results from start.gg and Liquipedia. Returns structured tournament records — name, game, dates, location, prize pool, entrant count, and placement data — for Street Fighter 6, Tekken 8, Smash Ultimate, Melee, Guilty Gear: Strive, KoF XV, and more.

What does the FGC Tournament Scraper do?

The scraper pulls from two live sources:

• start.gg — Uses the GraphQL API to fetch tournament listings and per-event standings. Requires a free API token from start.gg/admin/profile/developer (sign in, go to Settings > Developer > API Token). Returns player handle, placement, team, and country for each entrant.
• Liquipedia — Uses the MediaWiki API on the fighters and smash sub-wikis (no token required). Parses tournament infoboxes for name, organizer, prize pool, participant count, city, and country.

Limitations

tabletop.tools is listed as a third source but is currently not scraped — it returns no records and is skipped with a warning. Only start.gg and Liquipedia are active.

Placement and player handle fields are only populated for start.gg results. Liquipedia records carry tournament-level metadata but not per-player placement rows (those fields will be null). This is expected behavior, not a bug — Liquipedia's API does not expose structured bracket data.

{
  "source": "startgg",
  "tournament_name": "EVO 2026",
  "game_or_format": "sf6",
  "start_date": "2026-08-01",
  "country": "United States",
  "prize_pool_usd": 10000,
  "participant_count": 3200,
  "placement": 1,
  "player_handle": "MenaRD",
  "country_player": "DO",
  "team_name": "Bandai Namco"
}

What data does it extract?

Field	Type	Description
source	string	startgg or liquipedia
tournament_id	string	Tournament identifier
tournament_name	string	Tournament name
game_or_format	string	Game slug (e.g. sf6, tekken8, melee)
start_date	string	Tournament start date (ISO)
end_date	string	Tournament end date (ISO)
city	string	City
country	string	Country
is_online	boolean	Whether the event is online
prize_pool_usd	number	Prize pool in USD
participant_count	number	Number of entrants
placement	number	Final placement (start.gg only)
player_handle	string	Player gamertag (start.gg only)
player_real_name	string	Player real name (start.gg only)
country_player	string	Player country code (start.gg only)
winnings_usd	number	Winnings in USD (start.gg only)
team_name	string	Team name (start.gg only)
sponsor	string	Tournament sponsor (Liquipedia)
source_url	string	URL to the tournament page

How to use it

{
  "sources": ["liquipedia"],
  "games": ["sf6", "tekken8"],
  "dateFrom": "2026-01-01",
  "dateTo": "2026-12-31",
  "maxItems": 500
}

{
  "sources": ["startgg"],
  "games": ["sf6"],
  "startggApiToken": "YOUR_TOKEN_HERE",
  "maxItems": 200
}

Field	Type	Default	Description
sources	array	["startgg", "liquipedia"]	Which sources to query
games	array	["sf6", "tekken8"]	Game slugs to filter
dateFrom	string	—	Filter tournaments starting on or after (YYYY-MM-DD)
dateTo	string	—	Filter tournaments starting on or before (YYYY-MM-DD)
onlineOnly	boolean	false	Return only online events
startggApiToken	string	—	Required for start.gg source
maxItems	integer	10	Maximum records to return

Supported game slugs:

Slug	Game	start.gg	Liquipedia
sf6	Street Fighter 6	Yes	Yes
sf5	Street Fighter V	No	Yes
tekken8	Tekken 8	Yes	Yes
tekken7	Tekken 7	Yes	Yes
melee	Super Smash Bros. Melee	Yes	Yes
ultimate	Super Smash Bros. Ultimate	Yes	Yes
kof	KoF XV	Yes	Yes
guilty_gear	Guilty Gear: Strive	Yes	Yes

Use cases

• Sponsorship scouting — Track which players are placing top-8 consistently across the FGC circuit. Filter by game, date range, and prize pool threshold to identify rising talent before they sign.
• Community analytics — Monitor event activity by game, country, or organizer across a season to understand where the scene is growing.
• Tournament organizer benchmarking — Compare your event's entrant count and prize pool against comparable events in the same game and region.
• Player tracking — Follow a specific player handle's placements across games and events over time.
• Media and journalism — Pull structured historical data on prize money distribution, top players, and event growth for FGC reporting.

Pricing

This actor uses pay-per-record pricing at $0.001 per record plus $0.10 per run start. A run returning 1,000 tournament records costs approximately $1.10.

FAQ

Do I need a start.gg API token? Only if you include startgg in sources. The token is free — no credit card. Liquipedia requires no token.

What data does the output contain for Liquipedia vs. start.gg? Liquipedia records have tournament-level fields (prize pool, entrant count, city, country, sponsor). start.gg records additionally include per-player placement, handle, team, and winnings. The placement and player_handle fields are null in Liquipedia records by design.