zq.titan007.com APIzq.titan007.com ↗
Access live football scores, match stats, bookmaker odds (1x2, Asian handicap, over/under), and competition listings from zq.titan007.com via 7 endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/69a47c61-f9da-4d24-b9d0-d490df5a89c1/get_live_scores' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch all current live and today's match scores. Returns an array of all matches scheduled or in progress for the current day, including scores and match status.
No input parameters required.
{
"type": "object",
"fields": {
"matches": "array of match objects containing match_id, league, home_team, away_team, match_time, status, home_score, away_score, home_half_score, away_half_score"
},
"sample": {
"data": {
"matches": [
{
"league": "芬女杯",
"status": "3",
"match_id": "2986770",
"away_team": "汉卡女足",
"home_team": "赫尔辛基帕利斯尔B队女足",
"away_score": "5",
"home_score": "0",
"match_time": "16:00",
"away_half_score": "3",
"home_half_score": "0"
}
]
},
"status": "success"
}
}About the zq.titan007.com API
The Titan007 football API covers 7 endpoints returning live match scores, detailed match statistics, and odds from multiple bookmakers across hundreds of competitions. Starting with get_live_scores, you can retrieve every match scheduled or in progress for the current day — including score, status, and half-time score — then drill into individual matches for corners, fouls, possession data, and full event timelines.
Live Scores and Match Data
get_live_scores returns an array of all today's matches with fields including match_id, league, home_team, away_team, match_time, status, home_score, away_score, and home_half_sc. These match_id values are the key that unlocks every other endpoint. get_match_detail takes a match_id and returns a stats object breaking down corner_kicks, fouls, shots, shots_on_target, passes, attacks, dangerous_attacks, and possession per team, plus an events array with each event's half, team_id, type, and minute, and a match_info block that includes weather and temperature at the time of the match.
League and Season Browsing
get_competitions_list returns all available leagues and cups with their numeric id and Chinese-language name. That id feeds into get_league_matches, which accepts a league_id (required) and an optional season string in YYYY-YYYY format. The response includes a teams array — each entry carrying team_id, Chinese name, traditional name, English name, and logo path — alongside a matches array of historical results with round, match_time, team IDs, and scores.
Bookmaker Odds
Three dedicated odds endpoints each accept a match_id and return an odds array, one entry per bookmaker. get_1x2_odds gives opening and current win/draw/loss lines. get_asian_handicap_odds gives handicap lines with numeric handicap values and text representations. get_over_under_odds gives over/under totals with both total (text) and total_num (numeric) fields and over/under prices. All three include opening and current values, enabling movement tracking across the life of a market.
- Build a live football dashboard that refreshes today's scores using
get_live_scoresand shows half-time vs. full-time results. - Compare bookmaker 1x2 opening and closing lines via
get_1x2_oddsto study market movement before kick-off. - Aggregate Asian handicap odds from multiple bookmakers per match for a handicap-line comparison tool.
- Reconstruct full match event timelines including goal minutes and team attribution using
get_match_detailevents. - Populate a historical results database for a specific league and season using
get_league_matcheswith theseasonparameter. - Monitor in-play statistics like possession and shots on target by polling
get_match_detailduring a live match. - Map all available competition IDs with
get_competitions_listbefore building league-specific schedule scrapers.
| 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 zq.titan007.com have an official developer API?+
What does `get_match_detail` return beyond the score?+
get_match_detail returns a stats object with per-team counts for corner kicks, fouls, shots, shots on target, passes, attacks, dangerous attacks, and possession percentage. It also returns an events array listing each match event with its half, minute, team, and type, plus a match_info block that includes weather and temperature at the venue.Do the odds endpoints include in-play (live) odds?+
get_1x2_odds, get_asian_handicap_odds, and get_over_under_odds — each return opening and current odds values, which reflect pre-match line movement. In-play odds streaming during a live match is not currently exposed. The API covers pre-match and updated current lines. You can fork it on Parse and revise to add a live-odds polling endpoint if needed.Are player-level statistics available, such as scorers or assists?+
events array in get_match_detail includes event type and minute but does not name individual players. Team-level stats and event timelines are what the current endpoints expose. You can fork the API on Parse and revise it to add player-attribution fields if the source makes them available.How are competitions identified, and are the names in English?+
get_competitions_list are in Chinese. The numeric id for each competition is what you pass as league_id to get_league_matches. The endpoint description notes English Premier League as id 36 and La Liga as id 31 as reference points.