sportpulse.kyd.net API

Intelligent sports event pulse and categorization system

Version 2.14.0 • Last updated: Nov 22, 2025

Quick Start

Get today's top sports events ranked by importance:

curl "https://sportpulse.kyd.net/?category=sports_today&ret=json"

Returns JSON with ranked sports events, live status, scores, and TV networks.

Endpoints

GET Sports Today

https://sportpulse.kyd.net/?category=sports_today&ret=json

Top ranked sports events for today. Cache: 5 minutes.

Simple Mode: https://sportpulse.kyd.net/?category=sports_today&simple=1&ret=json
Force Refresh: https://sportpulse.kyd.net/?category=sports_today&force=1&ret=json

Response Format

{
  "source": "sportpulse.kyd.net API",
  "scraped_at": "2016-11-03T05:47:12.123456",
  "file_created_nice": "Nov 2 at 10:47:12 PM PT",
  "url": "https://site.api.espn.com/apis/v2/scoreboard/header",
  "took_secs": 0.2,
  "total_items": 1,
  "category": "Top Sports",
  "date": "2016-11-03",
  "date_nice": "Nov 3 PT",
  "date_epg": "20161103000000 +0000",
  "rate_limit": {
    "remaining": 99,
    "hourly_remaining": 99,
    "daily_remaining": 999,
    "reset_time": 1757984400,
    "reset_time_nice": "2025-09-16T01:00:00+00:00"
  },
  "items": [
    {
      "rank": 1,
      "title": "Chicago Cubs at Cleveland Indians",
      "league": "Major League Baseball",
      "league_abbr": "MLB",
      "status": "In Progress",
      "score": "6 - 6",
      "game_progress": "Top 10th",
      "game_progress_2": null,
      "pulse": 248,
      "pulse_reason": "MLB: +80, Mult: 3.1x, Live: +0.5x, Championship Finals: +0.6x, Overtime (Extra Innings): +0.5x, Tie Game: +0.2x, Prime Time (8:47 PM): +0.2x, National Broadcast: +0.1x",
      "networks": [
        "FOX",
        "MLB Network",
        "ESPN Radio"
      ],
      "is_national_broadcast": true,
      "date": "2016-11-03T01:08:00Z",
      "epg_timestamp": "20161103010800 +0000",
      "is_live": true,
      "is_close_game": true,
      "odds": {
        "details": "CLE -105",
        "over_under": 7.5,
        "spread": -0.5,
        "moneyline_home": -105,
        "moneyline_away": 105,
        "most_competitive": 105
      },
      "espn_link": "https://www.espn.com/mlb/game/_/gameId/401123456",
      "espn_bet_link": "https://espnbet.app.link/integrations?...",
      "location": "Progressive Field",
      "away": "Chicago Cubs",
      "away_logo": "https://a.espncdn.com/i/teamlogos/mlb/500-dark/scoreboard/chc.png",
      "away_record": "103-58",
      "home": "Cleveland Indians",
      "home_logo": "https://a.espncdn.com/i/teamlogos/mlb/500-dark/scoreboard/cle.png",
      "home_record": "94-67"
    }
  ]
}

Examples

cURL

curl "https://sportpulse.kyd.net/?category=sports_today&ret=json"

Simple Mode (bypass fallback):

curl "https://sportpulse.kyd.net/?category=sports_today&simple=1&ret=json"

JavaScript

fetch("https://sportpulse.kyd.net/?category=sports_today&ret=json")
  .then(response => response.json())
  .then(data => console.log(data));

Python

import requests
response = requests.get("https://sportpulse.kyd.net/?category=sports_today&ret=json")
data = response.json()

Live API Demo

Ready to run
https://sportpulse.kyd.net/?category=sports_today&ret=json
Click "Run API Call" to see live data...

Rate Limiting

API requests are rate limited to ensure fair usage:

  • 100 requests per hour per IP address
  • 1000 requests per day per IP address
  • • Rate limits reset every hour/day

Rate limit exceeded? You'll receive a 429 status code. Wait for the limit to reset or contact us for higher limits.

Pulse Score System

v2.14.0

Events ranked by pulse score (1-999) using multiplier-based system:

final_score = base_score × (1.0 + sum_of_multipliers)

Base Sport Weights

🏈 NFL
100
🎓 NCAAF
90
🏀 NBA
85
MLB
80
🏒 NHL
70
🎾 Tennis
65

Key Multipliers

Live Game
+0.5x
Close Game
+0.2x
Championship
+0.6x
Overtime
+0.5x
Prime Time
+0.2x
National TV
+0.1x

Close Game Thresholds

🏈 Football ≤7 pts (late: ≤14)
🏀 Basketball ≤3 pts (late: ≤6)
⚾ Baseball ≤2 runs (late: ≤3)
🏒 Hockey ≤1 goal (late: ≤2)
"Late" = 4th quarter/period or later

Pattern Sports

🎾 Tennis: Close sets
Golf: Tied positions
🏁 NASCAR: Top 5
🥊 UFC: Decisions

Examples

NFL Live OT 240
MLB World Series 240
NBA Close 145
NHL Playoff 140

Pulse Score Ranges

300+
Playoff OT
150+
Tie games
75+
Competitive
1-74
Regular

← Back to SportPulseAPI Docs