TutorialGetting Started

Getting Started with the PulseScore API

5 min read

Getting Started with PulseScore

PulseScore provides real-time Bet365 odds via a simple REST API and WebSocket feed. This guide walks you through your first API call.

Step 1: Create an Account

Head to pulsescore.net and sign up for a free account. The BASIC plan gives you 100 API requests per month — enough to test your integration.

Step 2: Generate an API Key

Once signed in, go to your Dashboard and click Generate API Key. Copy the key — you'll need it for authentication.

Important: Your full API key is only shown once. Store it securely.

Step 3: Make Your First Request

bash
curl -X GET "https://api.pulsescore.net/api/v2/bet365/live-events?sport=soccer" \
  -H "X-Secret: YOUR_API_KEY"

You'll receive a JSON array with all live events:

json
[
  {
    "fi": "98734521",
    "sport": "Soccer",
    "league": "Premier League",
    "home": "Liverpool",
    "away": "Man City",
    "live": 1,
    "mg": [
      {
        "name": "Fulltime Result",
        "ma": [
          { "name": "Liverpool", "pa": [{ "decimal": "1.45" }] },
          { "name": "Draw", "pa": [{ "decimal": "4.50" }] },
          { "name": "Man City", "pa": [{ "decimal": "6.00" }] }
        ]
      }
    ]
  }
]

Step 4: Filter by Sport

Use the sport query parameter to filter results:

bash
# Get only soccer live events
curl "https://api.pulsescore.net/api/v2/bet365/live-events?sport=soccer" \
  -H "X-Secret: YOUR_API_KEY"

# Get only tennis live events
curl "https://api.pulsescore.net/api/v2/bet365/live-events?sport=tennis" \
  -H "X-Secret: YOUR_API_KEY"

Step 5: Get Pre-Match Data

Pre-match data is organized by sport. First fetch leagues, then events:

bash
# Get soccer leagues
curl "https://api.pulsescore.net/api/v2/bet365/leagues" \
  -H "X-Secret: YOUR_API_KEY"

# Get events for a specific league
curl "https://api.pulsescore.net/api/v2/bet365/events?league=Premier%20League" \
  -H "X-Secret: YOUR_API_KEY"

# Get tennis leagues
curl "https://api.pulsescore.net/api/v2/bet365/tennis/leagues" \
  -H "X-Secret: YOUR_API_KEY"

Step 6: Connect via WebSocket (PRO/MAX)

For real-time streaming, connect to the WebSocket endpoint:

javascript
const ws = new WebSocket(
  "wss://api.pulsescore.net/api/v2/bet365/ws/live?key=YOUR_API_KEY&sport=soccer"
);

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.type === "data") {
    console.log("Live events:", data.events.length);
  }
};

What's Next?

← Back to all posts