Titan007 APIbf.titan007.com ↗
Get football match schedules and Pinnacle/Bet365 1X2 and Asian handicap odds for up to 7 days ahead via the bf.titan007.com API.
What is the Titan007 API?
The bf.titan007.com API exposes 2 endpoints covering football match schedules and pre-match odds data. Use list_matches to retrieve every match published for a given Beijing-time calendar day — today through 7 days ahead — and get_match_odds to pull Pinnacle and Bet365 1X2 and Asian handicap lines for a specific match, including both initial and current odds with payout percentages.
curl -X GET 'https://api.parse.bot/scraper/82022c31-6a3d-476d-aa9f-bb0fa46b1dbd/list_matches?date=2026-10-03' \ -H 'X-API-Key: $PARSE_API_KEY'
Lists every football match the site publishes for one Beijing-time (Asia/Shanghai, UTC+8) calendar day: today or up to 7 days ahead. One row per match with the site's numeric match_id, league, kickoff time (local Beijing time, 'YYYY-MM-DD HH:MM'), home/away team names (Simplified Chinese, as the site publishes them), and status. For today the live scoreboard is read, so status_code/status reflect the live state (not_started, first_half, half_time, second_half, extra_time, penalties, finished, cancelled, postponed, ...) and scores are filled for started matches; for future days the published schedule is read and every row is status not_started with null scores. A schedule day on the site runs roughly from 11:00 Beijing time to the following morning, so a future-day list can contain kickoffs dated the next calendar day; match_time always carries the row's own date. home_rank/away_rank are the site's league-position labels and are null when not published. Single request, no pagination; about 400-1300 rows per day. Dates in the past or more than 7 days ahead are rejected; a date within range but not yet published returns an empty matches list.
| Param | Type | Description |
|---|---|---|
| date | string | Beijing-time calendar day as YYYY-MM-DD. Omitted = today (Beijing time), which selects the live scoreboard source. |
{
"type": "object",
"fields": {
"date": "the requested Beijing-time day, YYYY-MM-DD",
"total": "number of matches returned",
"source": "'live' when read from today's live scoreboard, 'schedule' when read from the future schedule",
"matches": "array of match rows: match_id (string, input for get_match_odds), league, league_id, match_time ('YYYY-MM-DD HH:MM' Beijing time), timezone, status_code (site integer: 0 not started, 1/2/3 first half/half time/second half, 4 extra time, 5 penalties, -1 finished, -10 cancelled, -11 TBD, -12 abandoned, -13 interrupted, -14 postponed), status (label for status_code), home_team, away_team, home_score/away_score and half_time_* scores (null until the match has started), home_rank/away_rank (nullable label strings)"
},
"sample": {
"data": {
"date": "2026-10-03",
"total": 1265,
"source": "schedule",
"matches": [
{
"league": "墨西甲春",
"status": "not_started",
"match_id": "3024473",
"timezone": "Asia/Shanghai",
"away_rank": "春5",
"away_team": "FC美利达",
"home_rank": "春2",
"home_team": "拉巴斯竞技",
"league_id": "847",
"away_score": null,
"home_score": null,
"match_time": "2026-10-03 11:00",
"status_code": 0,
"half_time_away_score": null,
"half_time_home_score": null
}
]
},
"status": "success"
}
}About the Titan007 API
Match Schedule and Live Board
The list_matches endpoint accepts a single optional date parameter (Beijing time, YYYY-MM-DD). When omitted, it reads from today's live scoreboard; when a future date is supplied (up to 7 days ahead), it reads from the forward schedule. Each row in the matches array includes a numeric match_id (used as input to get_match_odds), league, league_id, match_time in YYYY-MM-DD HH:MM Beijing time, and home/away team names in Simplified Chinese. The source field in the response tells you whether the data came from the live board ('live') or the schedule ('schedule').
Per-Match Odds Detail
The get_match_odds endpoint takes a required match_id string from list_matches and returns a bookmakers object keyed by pinnacle and bet365. Each bookmaker entry carries two odds types: one_x_two (1X2) and Asian handicap. For 1X2, both initial and current sub-objects are returned, each containing home, draw, away decimal odds and a payout_pct (the bookmaker's implied payout percentage). For Asian handicap, multiple lines may be present — each line has its own initial and current values. The timezone field is always Asia/Shanghai, and all kickoff times are expressed in Beijing time.
Coverage and Data Shape
All team names, league names, and related labels are in Simplified Chinese, reflecting the source site's locale. The total field in list_matches gives the count of matches for the requested day. Odds reflect what the site publishes for Pinnacle and Bet365 only; other bookmakers are not included in the current response shape.
The Titan007 API is a managed, monitored endpoint for bf.titan007.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when bf.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 bf.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 pre-match odds comparison tool surfacing Pinnacle vs. Bet365 1X2 lines side by side
- Track opening-to-closing line movement using the initial and current odds fields from get_match_odds
- Calculate implied probabilities and payout margins from the payout_pct field for each bookmaker
- Populate a daily football fixture calendar for Asia/Shanghai timezone audiences using list_matches
- Identify Asian handicap line shifts between initial and current values for a specific match
- Aggregate weekly fixture lists by iterating list_matches across all 7 available future dates
- Filter upcoming matches by league_id to focus on a specific competition's odds data
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.