totalcorner.com APItotalcorner.com ↗
Access today's football matches, schedules, corner statistics, and team rankings from TotalCorner.com via a structured JSON API with 4 endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/5e0b4aab-b5da-44a3-8cdd-bde8123c3a08/get_today_matches' \ -H 'X-API-Key: $PARSE_API_KEY'
Get today's football match list with scores and corners. Returns all matches for the current day including live, completed, and upcoming matches.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer count of matches returned",
"matches": "array of match objects with league, time, status, teams, scores, and corners"
},
"sample": {
"data": {
"total": 6,
"matches": [
{
"time": "03:00",
"league": "Copa Sudamericana",
"status": "86",
"match_id": "192951152",
"away_team": "Macara2",
"home_team": "3Alianza Atletico",
"match_slug": "Alianza-Atletico-vs-Macara",
"full_time_score": "0 - 2",
"full_time_corners": "5 - 9",
"half_time_corners": "2-5"
}
]
},
"status": "success"
}
}About the totalcorner.com API
The TotalCorner API exposes 4 endpoints covering live and scheduled football match data, detailed per-match corner statistics, and league-level team rankings. The get_today_matches endpoint returns the full current-day match list with scores, corner counts, league names, and match status across all tracked competitions. Match slugs and IDs returned there feed directly into get_match_details for historical analysis and first-half goal data.
Match Data and Schedule
Two endpoints cover daily match coverage. get_today_matches returns all matches for the current day — live, completed, and upcoming — as an array of match objects including league, kickoff time, match status, team names, scores, and corner counts for each side. get_schedule returns a similar structure but scoped to the full day's schedule across all leagues. Both endpoints take no required inputs and return a total field alongside the matches array.
Match Details and Historical Analysis
get_match_details requires two inputs: a match_id and a slug (formatted like Alianza-Atletico-vs-Macara), both available from the listing endpoints. The response includes a history array of past encounters with team names, scores, and corner stats, plus total_matches_analyzed and goals_in_first_half_in_last_matches — a count of how many recent matches saw a goal before half-time. This makes the endpoint useful for pre-match research on scoring patterns and corner trends.
Team Rankings by Corner Statistics
get_top_teams_by_corners accepts an optional league_id parameter. Confirmed working values are 1 for the England Premier League and 2 for Spain La Liga; other league IDs may vary in availability. The response includes up to 10 team objects, each with rank, team name, played, corners_got, corners_lost, avg_corners_got, avg_corners_lost, and avg_total_corners. This endpoint is purpose-built for identifying teams with consistently high or low corner activity within a given league.
- Track live corner counts for in-play betting research using
get_today_matchesresponse fields - Build a daily football dashboard showing match status and scores across all leagues
- Analyze first-half goal frequency for specific fixtures using
goals_in_first_half_in_last_matchesfromget_match_details - Rank Premier League or La Liga teams by average corners gained per match for tactical analysis
- Pull historical head-to-head corner data for pre-match statistical models via
get_match_details - Monitor same-day match schedules and results across multiple leagues with no filter parameters required
- Compare a team's corners_got vs corners_lost averages to profile offensive vs defensive corner tendencies
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does TotalCorner have an official developer API?+
What does `get_match_details` return beyond the current match score?+
history array of past matches for both teams, including team names, scores, and corner statistics from those encounters. It also returns total_matches_analyzed (how many historical matches were included) and goals_in_first_half_in_last_matches (count of those matches where a first-half goal occurred). It does not return player-level stats or lineups.Which leagues are supported by `get_top_teams_by_corners`?+
1 (England Premier League) and 2 (Spain La Liga) are confirmed to return data. Other league IDs may work but results are not guaranteed. The API does not currently expose a league directory endpoint listing all valid IDs. You can fork the API on Parse and revise it to add a league listing endpoint that maps league names to their IDs.Does the API support filtering today's matches by league or competition?+
get_today_matches and get_schedule return all matches across all tracked leagues with no filter parameters. You can fork the API on Parse and revise it to add a league filter input that narrows the returned match array to a specific competition.