快速上手
大約五分鐘就能從 API 取得即時足球比分。選一條適合你的路徑。
本頁內容
1建立 API 金鑰
登入後建立金鑰。請立即複製。完整金鑰只會顯示一次。
取得免費金鑰2發送第一個請求
把 REPLACE_WITH_YOUR_KEY 換成你的金鑰。把兩行指令貼到終端機，按 Enter。
export TIPSME_API_KEY="REPLACE_WITH_YOUR_KEY"
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/matches/live"也可直接在瀏覽器試用。 開啟試玩區
Windows 及其他語言
$env:TIPSME_API_KEY = "REPLACE_WITH_YOUR_KEY"
curl.exe -H "Authorization: Bearer $env:TIPSME_API_KEY" "https://api.tipsme.hk/v1/football/matches/live"請勿把金鑰寫入原始碼或公開截圖。此變數只適用於目前的終端機工作階段。
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/matches/live"Python · 設定與執行
需要 Python 3 及 requests 套件。先執行下方安裝指令，再把 Python 請求存為 tipsme.py 並在同一終端機執行。若系統使用 python3，請在所有指令中使用 python3。
python -m pip install requests
# Save the request as tipsme.py, then:
python tipsme.pyJavaScript · 設定與執行
需要 Node.js 18 或更新版本。把 JavaScript 請求存為 tipsme.mjs，再執行 node tipsme.mjs。此範例在 Node.js 中運行，透過 process.env 讀取金鑰。
// Save the request as tipsme.mjs, then run in a terminal:
// node tipsme.mjsC# · 設定與執行
需要 .NET 8 SDK 或更新版本。按下方指令建立主控台專案，以 C# 請求取代 Program.cs，再執行。毋須額外套件。
dotnet new console -o TipsmeExample
cd TipsmeExample
# Replace Program.cs with the C# request, then:
dotnet run3閱讀回應
比賽位於 data 內。每場比賽的 id 可用於詳情及賠率；Plus 和 Pro 亦可查詢分析。球隊原始名稱可用時，homeLogo 和 awayLogo 會提供圖片網址。以下為示例。
{
"data": [
{
"id": 98224,
"kickoffUtc": "2026-09-08T12:00:00Z",
"competition": {
"name": "英格蘭超級聯賽",
"nameOriginal": "English Premier League"
},
"home": {
"name": "阿仙奴",
"nameOriginal": "阿仙奴",
"ranking": "3"
},
"away": {
"name": "車路士",
"nameOriginal": "車路士",
"ranking": "5"
},
"homeLogo": "https://assets.tipsme.hk/UploadFolder/Teams/%E9%98%BF%E4%BB%99%E5%A5%B4.png",
"awayLogo": "https://assets.tipsme.hk/UploadFolder/Teams/%E8%BB%8A%E8%B7%AF%E5%A3%AB.png",
"status": "live",
"minute": "63",
"score": {
"current": "2-1",
"halfTime": "1-0"
},
"homeCards": {
"yellow": 1,
"red": 0
},
"awayCards": {
"yellow": 2,
"red": 0
},
"corners": "4-3",
"isNeutralVenue": false,
"isCup": false,
"isBracket": false,
"isHkjc": true
}
]
}data 是空的，代表現在沒有進行中的賽事。改用賽程端點查看即將開賽的賽事。
請求失敗時，請查看錯誤代碼說明。 錯誤代碼
4常見用法
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/matches?date=2026-10-02&tz=480"tz 是以分鐘表示的 UTC 時差：480 代表香港（UTC+8），用於決定日期篩選所採用的日曆日。
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/matches/98224/odds/hdp/2"盤口有三種：had（主客和）、hdp（讓球）、hilo（大細）。2 是莊家 id，完整列表在 /odds/bookmakers。
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/matches/98224/analysis/ai-basic"使用 Plus 或 Pro 金鑰，以及從賽程取得的比賽 ID。報告尚未發佈時傳回 404。
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/meta/plans"公開方案資料不需要金鑰，會列出各方案的分析權限及請求上限。
開始之前，你可能想知道
免費方案夠用嗎？
測試用足夠。免費方案每個帳戶每日 30 次請求，賽程列表另加每日 50 次。分析需要 Plus 或 Pro；兩者的賽程列表額度分別為每日 500 次及 2000 次。
時間用哪個時區？
kickoffUtc 等時間都是 UTC。要按香港日期篩選賽程，請傳 tz=480。每日額度在香港時間午夜重設。
回應是空的，是出錯嗎？
不是。200 加上 data: [] 代表沒有符合的項目。404 代表該項目不存在，例如尚未公佈的陣容。
費用會失控嗎？
不會。超出額度的請求會被拒絕，不會額外收費。付費方案會自動續期。在帳單頁取消後，仍可用到期末。
金鑰應該放在哪裏？
放在你的伺服器。不要放進網站或手機 App，任何人都能讀到。你也可以把金鑰限制在伺服器的 IP 位址。
由免費方案開始
一條 API 金鑰，每個帳戶每日 30 次請求，另加每日 50 次免費賽程列表請求。真實數據，毋須信用卡。