Titan007 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.
What is the Titan007 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace zq-titan007-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""
Titan007 Football Data API - Usage Example
Get your API key from: https://parse.bot/settings
"""
from parse_apis.titan007_football_data_api import Titan007, LeagueId, Season
titan = Titan007()
# List available competitions
for comp in titan.competitions.list():
print(comp.id, comp.name)
# Get today's live matches
for match in titan.matches.live(limit=5):
print(match.match_id, match.home_team, "vs", match.away_team, match.match_time, match.status)
# Get EPL 2024-2025 season data using enums
season = titan.leagueseasons.get(league_id=LeagueId.EPL, season=Season.S_2024_2025)
for league_match in season.matches:
print(league_match.match_id, league_match.match_time, league_match.home_score, league_match.away_score)
# Construct a match and access sub-resources
match = titan.match("2590898")
# Get match detail
detail = match.detail.get()
print(detail.match_info, detail.stats)
# Get 1x2 odds for a match
for odds in match.odds_1x2.list():
print(odds.bookmaker, odds.opening, odds.current)
# Get Asian Handicap odds
for ah in match.odds_asian_handicap.list():
print(ah.bookmaker, ah.opening, ah.current)
# Get Over/Under odds
for ou in match.odds_over_under.list():
print(ou.bookmaker, ou.opening, ou.current)
Fetch all current live and today's match scores. Returns all matches scheduled or in progress for the current day, including scores and match status. Matches include both major and minor leagues worldwide. Status field indicates match state (0=not started, 1=first half, 2=half time, 3=second half, -1=finished).
No input parameters required.
{
"type": "object",
"fields": {
"matches": "array of match objects with 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": "0",
"match_id": "2974271",
"away_team": "奥林匹克湾",
"home_team": "奥克兰FC后备队",
"away_score": "0",
"home_score": "0",
"match_time": "15:00",
"away_half_score": "",
"home_half_score": ""
}
]
},
"status": "success"
}
}About the Titan007 API
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.
The Titan007 API is a managed, monitored endpoint for zq.titan007.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when zq.titan007.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official zq.titan007.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.