Registry / productivity / flightradar24-client

flightradar24-client

library1.0.1jsnpmunverified

A client library for fetching live aircraft data from Flightradar24. Version 1.0.1 supports Node.js >=18. It provides two main functions: fetchFromRadar to query flights within a bounding box and fetchFlight to get detailed flight info. Works only in Node.js, not browsers. Unofficial API wrapper. No authentication required. Lightweight with no dependencies.

productivity

npm install flightradar24-client

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · FLIGHTRADAR24-CLIE

flightradar24-client

productivityjavascriptv1.0.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

fetchFromRadar

✓ import { fetchFromRadar } from 'flightradar24-client'

✗ const fetchFromRadar = require('flightradar24-client')

ESM-only package; does not support CommonJS require.

fetchFlight

✓ import { fetchFlight } from 'flightradar24-client'

Named export for fetching detailed flight information.

default

✓ import * as flightradar24 from 'flightradar24-client'

✗ import flightradar24 from 'flightradar24-client'

Package has no default export; use namespace import for all exports.

Shows how to fetch flights within a bounding box and get detailed flight info.

import { fetchFromRadar } from 'flightradar24-client' // Bounding box for Berlin area const north = 53 const west = 13 const south = 52 const east = 14 const flights = await fetchFromRadar(north, west, south, east) console.log(flights) // Get details for first flight if (flights.length > 0) { const { fetchFlight } = await import('flightradar24-client') const details = await fetchFlight(flights[0].id) console.log(details) }

Debug

Known issues

gotchaPackage is ESM-only and requires Node.js >=18. Using require() will fail.

fix

Use import syntax and ensure your project is configured for ES modules.

affects: >=1.0.0

gotchafetchFromRadar expects arguments in order north, west, south, east. Confusing lat/lon order can cause empty results.

fix

Verify bounding box order: north (top), west (left), south (bottom), east (right).

affects: *

gotchaCoordinates are in decimal degrees, not DMS. Wrong format may return no data.

fix

Use decimal degrees (e.g., 52.5 instead of 52°30').

affects: *

gotchafetchFlight uses id from fetchFromRadar results; ids are not stable across sessions.

fix

Always use the id from a recent fetchFromRadar call.

affects: *

gotchaRate limiting is not documented; may get 429 errors if making too many requests.

fix

Add delays between requests to avoid being blocked.

affects: *

gotchaPackage does not work in browser environments due to fetch limitations.

fix

Use only in Node.js. There is no browser-compatible build.

affects: *

Errors

Common errors & fixes

ERR_REQUIRE_ESM

Using require() on an ESM-only package.

fix

Change to import syntax or use dynamic import().

TypeError: fetchFromRadar is not a function

Incorrect import (e.g., default import instead of named).

fix

Use import { fetchFromRadar } from 'flightradar24-client'.

TypeError: Cannot read properties of undefined (reading 'id')

fetchFromRadar returned empty array or undefined due to invalid bounding box.

fix

Check that north > south and bounding box covers area with live flights.

FetchError: request to https://... failed, reason: getaddrinfo ENOTFOUND

Network issue or Flightradar24 API blocked.

fix

Check internet connection and DNS resolution.

Upgrade

Version history

1.0.1latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

24 hits · last 30 days

node

Bingbot

OpenAI (training)

Resources

githubhttps://github.com/derhuerst/flightradar24-client ↗

packageflightradar24-client ↗

homepagehttps://github.com/derhuerst/flightradar24-client ↗