🛰️ N2YO Satellite Pass Scraper

N2YO Satellite Pass Scraper is a fast and lightweight Apify actor that fetches satellite pass predictions from N2YO.com for any location on Earth. Given a list of NORAD IDs and an observer location, it returns upcoming passes with timing, elevation, azimuth, duration, and visibility data — no API key required.

🎯 Features

• 📡 Multi-Satellite Support – Fetch passes for multiple satellites in one run.
• 🌍 Any Location – Specify observer lat/lng/altitude anywhere on Earth.
• 📅 Configurable Forecast – Predict passes 1–10 days ahead.
• 🔭 Elevation Filter – Skip passes below your minimum elevation threshold.
• 👁️ Visibility Flag – Know whether the pass is visible to the naked eye.
• 🧩 Clean JSON Output – Structured results ready for analysis or scheduling.

🚀 How to Use

1. Run the actor on Apify Console or via API.
2. Provide input with the following fields:
   • norad_ids: List of NORAD catalog IDs (e.g. [25544] for ISS)
   • lat: Observer latitude in decimal degrees (e.g. -6.2 for Jakarta)
   • lng: Observer longitude in decimal degrees (e.g. 106.8 for Jakarta)
   • alt: Observer altitude in meters (default: 0)
   • days: Days ahead to predict (1–10, default: 5)
   • min_elevation: Minimum elevation in degrees to include a pass (default: 10)
3. Wait for execution to complete and download results in JSON format.

📌 Example Input

{
  "norad_ids": [25544, 44713],
  "lat": -6.2,
  "lng": 106.8,
  "alt": 0,
  "days": 5,
  "min_elevation": 10
}

NORAD ID references: ISS = 25544, Hubble = 20580, Starlink examples = 44713, 44714

📦 Example Output

{
  "norad_id": 25544,
  "satellite_name": "ISS (ZARYA)",
  "pass_start_utc": "2026-06-10T01:23:00Z",
  "pass_start_az": "SW",
  "max_elevation_deg": 47,
  "max_elevation_az": "S",
  "pass_end_utc": "2026-06-10T01:29:12Z",
  "pass_end_az": "NE",
  "duration_sec": 372,
  "visible": true
}

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

📊 Output Fields

Field	Description
norad_id	NORAD catalog number of the satellite
satellite_name	Name of the satellite
pass_start_utc	Pass start time in UTC (ISO 8601)
pass_start_az	Compass direction at pass start
max_elevation_deg	Maximum elevation angle in degrees
max_elevation_az	Compass direction at maximum elevation
pass_end_utc	Pass end time in UTC (ISO 8601)
pass_end_az	Compass direction at pass end
duration_sec	Duration of the pass in seconds
visible	true if visible to the naked eye

💰 Pricing

This actor uses Pay per result pricing. You are only charged for the passes returned — no data, no charge.

📝 Disclaimer

This actor scrapes publicly accessible data from N2YO.com. You are responsible for ensuring your usage complies with N2YO's terms of service. Pass predictions are estimates and may vary slightly from actual observations.

🛠️ Support

If you encounter any issues or have questions, please open a ticket via the Issues tab in Apify Console.