# NeoWs - (Near Earth Object Web Service) API

> NeoWs - (Near Earth Object Web Service) API on Apizie: 7 endpoints (Find Near Earth Objects by date, Find Near Earth Objects for today, Browse the Near Earth Objects service, Retrieve Sentry (Impact Risk ) Near Earth Objects, …) returned as clean JSON through one API key. 7 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/open-data:neowsapp/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:neowsapp`
- Category: Open Data
- Status: live
- Source: https://neowsapp.com
- Page: https://zieapi.vercel.app/api/open-data/neowsapp
- OpenAPI: https://zieapi.vercel.app/api/open-data/neowsapp/openapi.json

A web service for near earth objects. All the data is from the NASA JPL Asteroid team . NeoWs is proud to power AsteroidTracker on iOS and Android as well as related apps. Follow us on Twitter

## Endpoints

### Find Near Earth Objects by date
`GET https://zieapi.vercel.app/v1/open-data:neowsapp/retrieve-near-earth-object-feed`

| Parameter | Type | Required | Description |
|---|---|---|---|
| start_date | string | no | Start of date range search, format: yyyy-MM-dd - (ex: 2015-04-28) |
| end_date | string | no | End of date range search, format: yyyy-MM-dd - (ex: 2015-04-28). If left off search will extends 7 days from start_date |
| detailed | boolean | no | detailed |

### Find Near Earth Objects for today
`GET https://zieapi.vercel.app/v1/open-data:neowsapp/retrieve-neofeed-today`

| Parameter | Type | Required | Description |
|---|---|---|---|
| detailed | boolean | no | detailed |

### Browse the Near Earth Objects service
`GET https://zieapi.vercel.app/v1/open-data:neowsapp/browse-near-earth-objects`

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no | page |
| size | integer | no | size |

### Retrieve Sentry (Impact Risk ) Near Earth Objects
`GET https://zieapi.vercel.app/v1/open-data:neowsapp/retrieve-sentry-risk-data`

| Parameter | Type | Required | Description |
|---|---|---|---|
| is_active | boolean | no | show current list of Sentry objects, or show removed Sentry objects |
| page | integer | no | page |
| size | integer | no | size |

### Retrieve Sentry (Impact Risk ) Near Earth Objectby ID
`GET https://zieapi.vercel.app/v1/open-data:neowsapp/retrieve-sentry-risk-data-by-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| asteroid_id | string | yes | ID of NearEarth object. ID can be SPK_ID, Asteroid des (designation) or Sentry ID |

### Find Near Earth Objects by id
`GET https://zieapi.vercel.app/v1/open-data:neowsapp/retrieve-near-earth-object-by-id`

| Parameter | Type | Required | Description |
|---|---|---|---|
| asteroid_id | string | yes | ID of Near Earth Object - (ex: 3729835) |

### Get the Near Earth Object data set totals
`GET https://zieapi.vercel.app/v1/open-data:neowsapp/retrieve-current-neo-statistics`

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:neowsapp/retrieve-near-earth-object-feed" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the NeoWs - (Near Earth Object Web Service) API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/open-data:neowsapp/retrieve-near-earth-object-feed with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the NeoWs - (Near Earth Object Web Service) API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the NeoWs - (Near Earth Object Web Service) API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:neowsapp.

### What is the status of the NeoWs - (Near Earth Object Web Service) API?
Live: works with just an Apizie key