What it returns
Live AIS ship positions anywhere in the world: vessels in a bounding box or a preset chokepoint (Hormuz, Bab el-Mandeb, Suez, Panama, Malacca, Taiwan Strait, Black Sea) with name, MMSI, IMO, type, destination, ETA, speed, course and status.
Request
POST https://api.pushbuild.com/global-vessel-tracking/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
area | string: hormuz, bab-el-mandeb, suez, panama, malacca, taiwan-strait, english-channel, black-sea, red-sea, gibraltar, bosporus, world | Preset area Default: "hormuz". |
bbox | string | minLon,minLat,maxLon,maxLat (overrides area) |
mmsi | string | Comma separated, up to 50 |
seconds | integer | 5 to 120; longer finds more ships |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/global-vessel-tracking/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"seconds": 30, "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.08 per 1,000 rows. No charge for errors or empty searches.
Related APIs
Air Quality API
Official US air quality from EPA AirNow: current AQI and next-day forecasts for every US reporting area (plus US embassy cities abroad), and hourly readings from about 2,000 monitors: AQI, PM2.5, PM10, ozone, NO2, CO and SO2.
Airport Database API
80,000+ airports, heliports and seaplane bases worldwide: IATA and ICAO codes, name, type, city, region, country, latitude, longitude, elevation, scheduled service flag, website and Wikipedia link..
Baltic Ship Tracking API
Live AIS vessel positions in the Baltic Sea and Finnish waters: MMSI, IMO, ship name, call sign, ship type, destination, draught, latitude, longitude, speed, course, heading and navigation status..
Boston MBTA API
Live Boston MBTA data for subway, commuter rail, bus and ferry: real-time arrival and departure predictions by stop or route, service alerts with cause and effect, and stop locations..
Canada Travel Advisories API
Government of Canada travel advisories for every country: advisory level from normal precautions to avoid all travel, regional warnings flag, last published date and link..
EV Charging Station API
EV charging and alternative fuel stations in the US and Canada from the Department of Energy AFDC: network, Level 2 and DC fast ports, connector types, pricing, hours, access and location, by state, ZIP or distance from a point..
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com