ScoreBat
Công cụ lập trình

API Video Bóng đá Chính thức

Bắt đầu nhanh

  1. Lấy token truy cập trong thẻ truy cập.
  2. Gọi một trong các endpoint API, ví dụ:
    GET
  3. Phân tích phản hồi JSON.
  4. Chèn mã HTML embed của một video trong phản hồi vào trang để hiển thị trình phát. Với ứng dụng di động, bạn có thể hiển thị video trong webview bằng cách trích xuất URL video từ mã nhúng.

Token truy cập

Bạn cần token truy cập API để sử dụng API Video.

Mỗi yêu cầu phải bao gồm token truy cập dưới dạng tham số token trong URL yêu cầu.

Bạn có thể lấy token truy cập trong thẻ truy cập.

Endpoint

Bạn có thể lấy mã nhúng của video ở định dạng JSON từ các endpoint sau:

Free Feed

GET

Endpoint Free Feed cho phép bạn truy cập một số highlight trận đấu giới hạn. Endpoint này bao gồm các giải được chọn và những trận cũ hơn, giúp bạn xem trước API Video đầy đủ.

  • Chỉ bao gồm một phần các giải đấu và trận đấu, thường là trận cũ hơn hoặc highlight được chọn.
  • Trả về video chính thức có thể nhúng từ các nguồn đã xác minh.
  • Lý tưởng để thử nghiệm.
  • Không bao gồm tất cả giải đấu hoặc cập nhật trực tiếp có trong các gói trả phí.

Featured Feed

GET

Trả về nguồn nội dung được tuyển chọn và phù hợp, gồm cả các trận gần đây lẫn trận đáng chú ý từ những giải bóng đá hàng đầu. Nguồn này làm nổi bật các trận phổ biến và đáng quan tâm nhất nhưng không bao gồm mọi trận đấu. Để truy cập toàn bộ video của một giải hoặc đội bóng cụ thể, hãy dùng endpoint giải đấu hoặc đội bóng.

  • Bao gồm các trận gần đây được chọn từ nhiều giải đấu.
  • Không bao gồm mọi trận đấu hoặc giải đấu — chỉ những nội dung phù hợp nhất.
  • Khả dụng với tất cả gói trả phí.

Giải đấu

GET

Bạn có thể truy vấn video của bất kỳ giải đấu nào bằng endpoint Giải đấu. Endpoint này trả về video từ các trận mới nhất của giải đấu được chỉ định.

Ví dụ, URL bên dưới trả về video từ các trận gần đây nhất của Premier League. Chuỗi england-premier-league là mã định danh (ID) duy nhất của Premier League.

Dưới đây là ID của một số giải đấu phổ biến nhất:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Bạn có thể xem danh sách ID của tất cả giải đấu tại đây.

Đội bóng

GET

Bạn có thể truy vấn video của bất kỳ đội bóng nào bằng endpoint Đội bóng. Endpoint này trả về video từ các trận mới nhất của đội bóng được chỉ định.

Ví dụ, URL bên dưới trả về video từ các trận gần đây nhất của Real Madrid. Chuỗi real-madrid là mã định danh (ID) duy nhất của Real Madrid.

Dưới đây là ID của một số đội bóng phổ biến nhất:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Bạn có thể xem danh sách ID của tất cả đội bóng tại đây.

Phát trực tiếp

GET

Chỉ trả về những trận có nội dung phát trực tiếp chính thức — gồm cả trận đang diễn ra và đã kết thúc. Các mục bắt đầu xuất hiện khoảng 5 phút trước giờ bóng lăn.

  • Chỉ hiển thị các trận có nội dung phát chính thức và có thể nhúng.
  • Bao gồm trận đang diễn ra và vừa kết thúc, kèm bản phát lại khi có sẵn.
  • Các mục bắt đầu xuất hiện khoảng 5 phút trước giờ bóng lăn dự kiến.

Endpoint đã cập nhật

GET

Endpoint này giúp bạn xác định nguồn dữ liệu giải đấu hoặc đội bóng nào vừa được cập nhật, nhờ đó không cần liên tục truy vấn từng endpoint riêng lẻ.

Cấu trúc phản hồi

Phản hồi là một đối tượng JSON chứa khóa response với một mảng các đối tượng trận đấu. Mỗi trận gồm thông tin cơ bản, chi tiết giải đấu liên quan và danh sách video hiện có.

JSON
{"response": [{"title": "Chelsea - Manchester United","competition": "ENGLAND: Premier League","matchviewUrl": "...","competitionUrl": "...","thumbnail": "...","date": "2029-05-18T15:00:00+0000","homeTeam": {"name": "Chelsea","slug": "chelsea","id": 229},"awayTeam": {"name": "Manchester United","slug": "manchester-united","id": 243},"videos": [{"title": "Highlights","embed": "..."},{"title": "Extended Highlights","embed": "..."}]},...]}

Khóa response chứa một mảng các đối tượng trận đấu. Mỗi đối tượng đại diện cho một trận bóng đá và bao gồm các trường sau:

  • title – Tên trận đấu (ví dụ: Chelsea - Manchester United).
  • competition – Tên giải đấu (ví dụ: England Premier League).
  • date – Ngày và giờ bắt đầu trận đấu.
  • thumbnail – URL của ảnh thu nhỏ cho trận đấu.
  • videos – Mảng chứa tất cả video hiện có của trận đấu. Mỗi đối tượng video gồm:
    • title – Tiêu đề video (ví dụ: Highlights hoặc Extended Highlights).
    • embed – Mã HTML nhúng video.
    • id – Mã định danh duy nhất của video.
  • homeTeam / awayTeam – Các đối tượng đại diện cho những đội tham gia trận đấu, bao gồm:
    • name – Tên đầy đủ của đội bóng (ví dụ: Chelsea).
    • slug – Slug của đội bóng dùng trong URL (ví dụ: chelsea).
    • id – Mã định danh duy nhất của đội bóng.
  • matchviewUrl – URL của trang widget xem trận đấu, chứa thông tin chi tiết như tỷ số trực tiếp, thống kê và bảng xếp hạng.
  • competitionUrl – URL của widget giải đấu, hiển thị bảng xếp hạng trực tiếp, kết quả và lịch thi đấu sắp tới.

Tự động phát

Bạn có thể bật tự động phát bằng cách thêm tham số autoplay=1 vào URL video.

Ví dụ:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Nếu sử dụng trực tiếp mã HTML embed, bạn có thể thêm &autoplay=1 vào URL video bên trong src của iframe.

Hạn mức

Mỗi gói có một giới hạn yêu cầu hằng tháng.

  • Mỗi lượt xem video hoặc hiển thị widget được tính là 1 request.
  • Mỗi lần gọi Video API được tính là 5 requests vào hạn mức hằng tháng.

Ví dụ:

  • Starter plan bao gồm 5.000 yêu cầu mỗi tháng.
  • Standard plan bao gồm 20.000 yêu cầu mỗi tháng.
  • Advanced plan bao gồm 100.000 yêu cầu mỗi tháng.
  • Nếu cần giới hạn cao hơn, hãy liên hệ với chúng tôi để tìm hiểu Enterprise plans.

Nếu vượt quá giới hạn yêu cầu hằng tháng, tài khoản sẽ tự động chuyển sang Free plan cho đến kỳ thanh toán tiếp theo. Trong thời gian đó, quảng cáo và logo ScoreBat sẽ xuất hiện trên widget và video, đồng thời chỉ endpoint Free Feed còn có thể truy cập.