API Endpoints Reference

import requests

response = requests.get(
    "https://vailrerbn.com/api/v1/spots",
    params={
        "call": "W1AW",
        "mode": "CW",
        "band": "20m"
    }
)
data = response.json()
print(f"Found {data['total']} spots")

for spot in data["spots"]:
    grid = spot.get('grid', 'Unknown')
    print(f"{spot['callsign']} ({grid}) on {spot['frequency']} kHz")

const params = new URLSearchParams({
  call: 'W1AW',
  mode: 'CW',
  band: '20m'
});

const response = await fetch(
  `https://vailrerbn.com/api/v1/spots?${params}`
);
const data = await response.json();

console.log(`Found ${data.total} spots`);

data.spots.forEach(spot => {
  const grid = spot.grid || 'Unknown';
  console.log(`${spot.callsign} (${grid}) on ${spot.frequency} kHz`);
});

<?php
$params = http_build_query([
    'call' => 'W1AW',
    'mode' => 'CW',
    'band' => '20m'
]);

$response = file_get_contents(
    "https://vailrerbn.com/api/v1/spots?$params"
);
$data = json_decode($response, true);

echo "Found {$data['total']} spots\n";

foreach ($data['spots'] as $spot) {
    echo "{$spot['callsign']} on {$spot['frequency']} kHz\n";
}

require 'net/http'
require 'json'

uri = URI('https://vailrerbn.com/api/v1/spots')
uri.query = URI.encode_www_form({
  call: 'W1AW',
  mode: 'CW',
  band: '20m'
})

response = Net::HTTP.get(uri)
data = JSON.parse(response)

puts "Found #{data['total']} spots"

data['spots'].each do |spot|
  puts "#{spot['callsign']} on #{spot['frequency']} kHz"
end

import requests

callsign = "W1AW"
hours = 48

response = requests.get(
    f"https://vailrerbn.com/api/v1/spots/{callsign}",
    params={"hours": hours}
)
data = response.json()

print(f"Found {data['total']} spots for {callsign} in last {hours} hours")

for spot in data["spots"]:
    spotter_grid = spot.get('spotter_grid', '????')
    print(f"{spot['timestamp']} - {spot['spotter']} ({spotter_grid}) - {spot['frequency']} kHz - {spot['mode']} - {spot['snr']} dB")

const callsign = 'W1AW';
const hours = 48;

const response = await fetch(
  `https://vailrerbn.com/api/v1/spots/${callsign}?hours=${hours}`
);
const data = await response.json();

console.log(`Found ${data.total} spots for ${callsign} in last ${hours} hours`);

data.spots.forEach(spot => {
  const spotterGrid = spot.spotter_grid || '????';
  console.log(`${spot.timestamp} - ${spot.spotter} (${spotterGrid}) - ${spot.frequency} kHz - ${spot.mode} - ${spot.snr} dB`);
});

<?php
$callsign = "W1AW";
$hours = 48;

$url = "https://vailrerbn.com/api/v1/spots/$callsign?" . http_build_query(['hours' => $hours]);
$response = file_get_contents($url);
$data = json_decode($response, true);

echo "Found {$data['total']} spots for $callsign in last $hours hours\n";

foreach ($data['spots'] as $spot) {
    echo "{$spot['timestamp']} - {$spot['frequency']} kHz - {$spot['mode']} - {$spot['snr']} dB\n";
}

require 'net/http'
require 'json'

callsign = 'W1AW'
hours = 48

uri = URI("https://vailrerbn.com/api/v1/spots/#{callsign}")
uri.query = URI.encode_www_form({ hours: hours })

response = Net::HTTP.get(uri)
data = JSON.parse(response)

puts "Found #{data['total']} spots for #{callsign} in last #{hours} hours"

data['spots'].each do |spot|
  puts "#{spot['timestamp']} - #{spot['frequency']} kHz - #{spot['mode']} - #{spot['snr']} dB"
end

import requests

# List of callsigns to monitor
callsigns = ["W1AW", "K1TTT", "N3LLO", "WB9Z", "VE3EN"]

response = requests.get(
    "https://vailrerbn.com/api/v1/activity",
    params={
        "call": ",".join(callsigns),
        "hours": 1
    }
)
data = response.json()

print(f"{data['summary']['spotted']}/{data['summary']['requested']} callsigns active")

for entry in data["callsigns"]:
    if entry["spotted"]:
        print(f"  {entry['callsign']}: {entry['count']} spots, "
              f"last on {entry['last_frequency']} kHz ({entry['last_mode']})")
    else:
        print(f"  {entry['callsign']}: not spotted")

const callsigns = ['W1AW', 'K1TTT', 'N3LLO', 'WB9Z', 'VE3EN'];

const response = await fetch(
  `https://vailrerbn.com/api/v1/activity?call=${callsigns.join(',')}&hours=1`
);
const data = await response.json();

console.log(`${data.summary.spotted}/${data.summary.requested} callsigns active`);

for (const entry of data.callsigns) {
  if (entry.spotted) {
    console.log(`  ${entry.callsign}: ${entry.count} spots, `
      + `last on ${entry.last_frequency} kHz (${entry.last_mode})`);
  } else {
    console.log(`  ${entry.callsign}: not spotted`);
  }
}

<?php
$callsigns = ["W1AW", "K1TTT", "N3LLO", "WB9Z", "VE3EN"];

$params = http_build_query([
    'call' => implode(',', $callsigns),
    'hours' => 1
]);

$response = file_get_contents(
    "https://vailrerbn.com/api/v1/activity?$params"
);
$data = json_decode($response, true);

echo "{$data['summary']['spotted']}/{$data['summary']['requested']} callsigns active\n";

foreach ($data['callsigns'] as $entry) {
    if ($entry['spotted']) {
        echo "  {$entry['callsign']}: {$entry['count']} spots, "
           . "last on {$entry['last_frequency']} kHz ({$entry['last_mode']})\n";
    } else {
        echo "  {$entry['callsign']}: not spotted\n";
    }
}

require 'net/http'
require 'json'

callsigns = %w[W1AW K1TTT N3LLO WB9Z VE3EN]

uri = URI('https://vailrerbn.com/api/v1/activity')
uri.query = URI.encode_www_form({
  call: callsigns.join(','),
  hours: 1
})

response = Net::HTTP.get(uri)
data = JSON.parse(response)

puts "#{data['summary']['spotted']}/#{data['summary']['requested']} callsigns active"

data['callsigns'].each do |entry|
  if entry['spotted']
    puts "  #{entry['callsign']}: #{entry['count']} spots, " \
         "last on #{entry['last_frequency']} kHz (#{entry['last_mode']})"
  else
    puts "  #{entry['callsign']}: not spotted"
  end
end

import requests

response = requests.get(
    "https://vailrerbn.com/api/v1/stats",
    params={"hours": 1}
)
data = response.json()

print(f"Total spots: {data['totalSpots']}")
print(f"Spots/min: {data['spotsPerMinute']:.1f}")
print(f"Unique callsigns: {data['uniqueCallsigns']}")
print(f"\nMode breakdown:")
for mode, count in data['modeBreakdown'].items():
    print(f"  {mode}: {count}")

const response = await fetch(
  'https://vailrerbn.com/api/v1/stats?hours=1'
);
const data = await response.json();

console.log(`Total spots: ${data.totalSpots}`);
console.log(`Spots/min: ${data.spotsPerMinute.toFixed(1)}`);
console.log(`Unique callsigns: ${data.uniqueCallsigns}`);
console.log(`\nMode breakdown:`);

for (const [mode, count] of Object.entries(data.modeBreakdown)) {
  console.log(`  ${mode}: ${count}`);
}

<?php
$response = file_get_contents(
    "https://vailrerbn.com/api/v1/stats?hours=1"
);
$data = json_decode($response, true);

echo "Total spots: {$data['totalSpots']}\n";
echo "Spots/min: " . number_format($data['spotsPerMinute'], 1) . "\n";
echo "Unique callsigns: {$data['uniqueCallsigns']}\n";
echo "\nMode breakdown:\n";

foreach ($data['modeBreakdown'] as $mode => $count) {
    echo "  $mode: $count\n";
}

require 'net/http'
require 'json'

uri = URI('https://vailrerbn.com/api/v1/stats')
uri.query = URI.encode_www_form({ hours: 1 })

response = Net::HTTP.get(uri)
data = JSON.parse(response)

puts "Total spots: #{data['totalSpots']}"
puts "Spots/min: #{'%.1f' % data['spotsPerMinute']}"
puts "Unique callsigns: #{data['uniqueCallsigns']}"
puts "\nMode breakdown:"

data['modeBreakdown'].each do |mode, count|
  puts "  #{mode}: #{count}"
end

import requests

# Get stats from 4 hours ago to 3 hours ago
response = requests.get(
    "https://vailrerbn.com/api/v1/stats",
    params={
        "start_hours": 4,
        "end_hours": 3
    }
)
data = response.json()

print(f"Time range: {data['timeRange']['start']} to {data['timeRange']['end']}")
print(f"Total spots: {data['totalSpots']}")
print(f"Spots/min: {data['spotsPerMinute']:.1f}")

// Get stats from 4 hours ago to 3 hours ago
const response = await fetch(
  'https://vailrerbn.com/api/v1/stats?start_hours=4&end_hours=3'
);
const data = await response.json();

console.log(`Time range: ${data.timeRange.start} to ${data.timeRange.end}`);
console.log(`Total spots: ${data.totalSpots}`);
console.log(`Spots/min: ${data.spotsPerMinute.toFixed(1)}`);

<?php
// Get stats from 4 hours ago to 3 hours ago
$response = file_get_contents(
    "https://vailrerbn.com/api/v1/stats?start_hours=4&end_hours=3"
);
$data = json_decode($response, true);

echo "Time range: {$data['timeRange']['start']} to {$data['timeRange']['end']}\n";
echo "Total spots: {$data['totalSpots']}\n";
echo "Spots/min: " . number_format($data['spotsPerMinute'], 1) . "\n";

require 'net/http'
require 'json'

# Get stats from 4 hours ago to 3 hours ago
uri = URI('https://vailrerbn.com/api/v1/stats')
uri.query = URI.encode_www_form({
  start_hours: 4,
  end_hours: 3
})

response = Net::HTTP.get(uri)
data = JSON.parse(response)

puts "Time range: #{data['timeRange']['start']} to #{data['timeRange']['end']}"
puts "Total spots: #{data['totalSpots']}"
puts "Spots/min: #{'%.1f' % data['spotsPerMinute']}"

import requests

# Get chart data from 48 hours ago to 24 hours ago (yesterday)
response = requests.get(
    "https://vailrerbn.com/api/v1/charts",
    params={
        "start_hours": 48,
        "end_hours": 24
    }
)
data = response.json()

print(f"Hourly activity ({len(data['hourlyActivity'])} hours):")
for hour in data['hourlyActivity']:
    print(f"  {hour['hour']}: {hour['count']} spots")

print(f"\nTop modes:")
for mode in data['byMode'][:3]:
    print(f"  {mode['mode']}: {mode['count']}")

// Get chart data from 48 hours ago to 24 hours ago (yesterday)
const response = await fetch(
  'https://vailrerbn.com/api/v1/charts?start_hours=48&end_hours=24'
);
const data = await response.json();

console.log(`Hourly activity (${data.hourlyActivity.length} hours):`);
data.hourlyActivity.forEach(hour => {
  console.log(`  ${hour.hour}: ${hour.count} spots`);
});

console.log(`\nTop modes:`);
data.byMode.slice(0, 3).forEach(mode => {
  console.log(`  ${mode.mode}: ${mode.count}`);
});

<?php
// Get chart data from 48 hours ago to 24 hours ago (yesterday)
$response = file_get_contents(
    "https://vailrerbn.com/api/v1/charts?start_hours=48&end_hours=24"
);
$data = json_decode($response, true);

echo "Hourly activity (" . count($data['hourlyActivity']) . " hours):\n";
foreach ($data['hourlyActivity'] as $hour) {
    echo "  {$hour['hour']}: {$hour['count']} spots\n";
}

echo "\nTop modes:\n";
foreach (array_slice($data['byMode'], 0, 3) as $mode) {
    echo "  {$mode['mode']}: {$mode['count']}\n";
}

require 'net/http'
require 'json'

# Get chart data from 48 hours ago to 24 hours ago (yesterday)
uri = URI('https://vailrerbn.com/api/v1/charts')
uri.query = URI.encode_www_form({
  start_hours: 48,
  end_hours: 24
})

response = Net::HTTP.get(uri)
data = JSON.parse(response)

puts "Hourly activity (#{data['hourlyActivity'].length} hours):"
data['hourlyActivity'].each do |hour|
  puts "  #{hour['hour']}: #{hour['count']} spots"
end

puts "\nTop modes:"
data['byMode'].first(3).each do |mode|
  puts "  #{mode['mode']}: #{mode['count']}"
end