decmurphy / SpaceX-API

:rocket: Open Source REST API for company, vehicle, pad, and launch data

SpaceX Data REST API

Open Source REST API for data regarding company info, vehicles, launch sites, and launch data.

Documentation

See the Wiki for full API Documentation

Usage / Endpoints

Example Response

GET https://api.spacexdata.com/v2/launches/latest

{
    "flight_number": 50,
    "launch_year": "2017",
    "launch_date_unix": 1509392040,
    "launch_date_utc": "2017-10-30T19:34:00Z",
    "launch_date_local": "2017-10-30T15:34:00-04:00",
    "rocket": {
        "rocket_id": "falcon9",
        "rocket_name": "Falcon 9",
        "rocket_type": "FT",
        "first_stage": {
            "cores": [
                {
                    "core_serial": "B1042",
                    "reused": false,
                    "land_success": true,
                    "landing_type": "ASDS",
                    "landing_vehicle": "OCISLY"
                }
            ]
        },
        "second_stage": {
            "payloads": [
                {
                    "payload_id": "KoreaSat 5A",
                    "reused": false,
                    "customers": [
                        "KT Corporation"
                    ],
                    "payload_type": "Satellite",
                    "payload_mass_kg": 3700,
                    "payload_mass_lbs": 8157.104,
                    "orbit": "GTO"
                }
            ]
        }
    },
    "telemetry": {
        "flight_club": null
    },
    "reuse": {
        "core": false,
        "side_core1": false,
        "side_core2": false,
        "fairings": false,
        "capsule": false
    },
    "launch_site": {
        "site_id": "ksc_lc_39a",
        "site_name": "KSC LC 39A",
        "site_name_long": "Kennedy Space Center Historic Launch Complex 39A"
    },
    "launch_success": true,
    "links": {
        "mission_patch": "http://spacexpatchlist.space/patches/spacex_f9_044_koreasat_5a_graphic.png",
        "reddit_campaign": "https://www.reddit.com/r/spacex/comments/73ttkd/koreasat_5a_launch_campaign_thread/",
        "reddit_launch": "https://www.reddit.com/r/spacex/comments/79iuvb/rspacex_koreasat_5a_official_launch_discussion/",
        "reddit_recovery": null,
        "reddit_media": "https://www.reddit.com/r/spacex/comments/79lmdu/rspacex_koreasat5a_media_thread_videos_images/",
        "presskit": "http://www.spacex.com/sites/spacex/files/koreasat5apresskit.pdf",
        "article_link": "https://spaceflightnow.com/2017/10/30/spacex-launches-and-lands-third-rocket-in-three-weeks/",
        "video_link": "https://www.youtube.com/watch?v=RUjH14vhLxA"
    },
    "details": "KoreaSat 5A is a Ku-band satellite capable of providing communication services from East Africa and Central Asia to southern India, Southeast Asia, the Philippines, Guam, Korea, and Japan. The satellite will be placed in GEO at 113° East Longitude, and will provide services ranging from broadband internet to broadcasting services and maritime communications."
}

Contributions

See the Contribution guide for detailed steps

Local Development

Local development info can be found here

Technical Details

• API is using Node.js with the Express.js framework
• Uses Jest and Supertest for unit/integration testing
• Uses Travis CI for continuous integration/delivery
• All data stored in a MongoDB Atlas 3 node replica set cluster
• Latest database dump included under releases
• API deployed on a Heroku pipeline with pull request, staging and production servers

FAQ's

• API has a per user rate limit of 2500 requests per 15 minutes or 10000 requests per hour
• If you have any questions or corrections, please open an issue and we'll get it merged ASAP
• All data and photos are property of Space Exploration Technologies Corporation (SpaceX)
• I am not affiliated with SpaceX in any way, shape, form, or fashion. Just a fun side project for me
• For any other questions or concerns, just shoot me an email