Setting-up an On Demand (credit-based) API Service (example used: API ServiceVI01 - Voyage Forecasts) From the Details page of the selected Service, select the On Demand (Credits) tab and click on the Get an API Key for this service button. AIS Data API services. If MMSI, IMO and SHIP ID are passed, the MMSI takes precedence and the IMO and SHIP ID will be ignored. Number of individual calls that were used in the median calculations (e.g. Status: A uniquely assigned ID by MarineTraffic for the subject vessel. Get positional information for a single vessel. The MarineTraffic ID of the port (found on the URL of the respective Port page) or port DOCUMENTATION; Extensive Traffic Details. The vessel name. How often is the position data updated? As already mentioned, price tags will vary depending on the type of responses (simple/extended/full) and the AIS data source (Terrestrial/Satellite). # extended msg_type returns a lot more data but cost, # raw data from api call (json, csv or xml), # data formatted in python's native data types, # list of model objects representing the data, # meta data that in some way describes API response, """Handle All Marine Traffic Exceptions""", # after every API call the client library will automatically print all the data to standard output, # and you can always have all debug data in your code, https://www.marinetraffic.com/en/ais-api-services/documentation/api-service:ps03, https://www.marinetraffic.com/en/ais-api-services/documentation/api-service:ps04, https://www.marinetraffic.com/en/ais-api-services/documentation/api-service:ps05, https://www.marinetraffic.com/en/ais-api-services/, Marine_Traffic_API-0.20.1-py3-none-any.whl. The timespan parameter defines the period of time, during which we want to receive the https://services.marinetraffic.com/api/predictive-arrivals/YOUR-API-KEY/portid:value, Example API call: Donate today! Define an area for which you wish to either get all the historical vessels' MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA, MMSI, IMO, SHIP_ID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, DRAUGHT, YEAR_BUILT, ROT, TYPE_NAME, AIS_TYPE_SUMMARY, DESTINATION, ETA, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, CURRENT_PORT_ID, CURRENT_PORT_UNLOCODE, CURRENT_PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO, DISTANCE_TRAVELLED, AVG_SPEED, MAX_SPEED, MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY, MMSI, IMO, SHIPID, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, UTC_SECONDS, SHIPNAME, SHIPTYPE, CALLSIGN, FLAG, LENGTH, WIDTH, GRT, ROT, DWT, YEAR_BUILT, TYPE_NAME, AIS_TYPE_SUMMARY, CURRENT_PORT, LAST_PORT, LAST_PORT_TIME, DESTINATION, ETA, DRAUGHT, PORT_ID, PORT_UNLOCODE, PORT_COUNTRY, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA_CALC, ETA_UPDATED, DISTANCE_TO_GO, ( Including all Simple and Extended response fields ), MMSI, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, DSRC, MMSI, LAT, LON, SPEED, HEADING, COURSE, STATUS, TIMESTAMP, SHIPNAME, SHIPTYPE, TYPE_NAME, AIS_TYPE_SUMMARY, IMO, CALLSIGN, FLAG, PORT_ID, PORT_UNLOCODE, CURRENT_PORT, LAST_PORT_ID, LAST_PORT_UNLOCODE, LAST_PORT, LAST_PORT_TIME, DESTINATION, ETA, ETA_CALC, LENGTH, WIDTH, DRAUGHT, GRT, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, DWT, YEAR_BUILT, DSRC, MMSI, SHIPNAME, SHIP_ID, TIMESTAMP_LT, TIMESTAMP_UTC, MOVE_TYPE, TYPE_NAME, PORT_ID, PORT_NAME,UNLOCODE, MMSI, SHIPNAME, SHIP_ID, TIMESTAMP_LT, TIMESTAMP_UTC, MOVE_TYPE, TYPE_NAME, PORT_ID, PORT_NAME, UNLOCODE, DRAUGHT, LOAD_STATUS, PORT_OPERATION, INTRANSIT, DISTANCE_TRAVELLED, VOYAGE_SPEED_AVG, VOYAGE_SPEED_MAX, VOYAGE_IDLE_TIME_MINS, ELAPSED_NOANCH, DISTANCE_LEG, COMFLEET_GROUPEDTYPE, SHIPCLASS, MMSI, STATUS, SPEED, LON, LAT, COURSE, HEADING, TIMESTAMP, SHIP_ID, MMSI, STATUS, SPEED, LON, LAT, COURSE, HEADING, TIMESTAMP, SHIP_ID, WIND_ANGLE, WIND_SPEED, WIND_TEMP, MMSI, IMO, NAME, PLACE_OF_BUILD, BUILD, BREADTH_EXTREME, SUMMER_DWT, DISPLACEMENT_SUMMER, CALLSIGN, FLAG, DRAUGHT, LENGTH_OVERALL, FUEL_CONSUMPTION, SPEED_MAX, SPEED_SERVICE, LIQUID_OIL, OWNER, MANAGER, MANAGER_OWNER, VESSEL_TYPE, SHIPNAME, MMSI, IMO, SHIP_ID, CALLSIGN, TYPE_NAME, DWT, FLAG, COUNTRY, YEAR_BUILT, MT_URL, MMSI, LAT, LON, SPEED, COURSE, STATUS, PORT_ID, PORT_UNLOCODE, CURRENT_PORT, CURRENT_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, ETA, ETA_CALC, ETA_UPDATED, TIMESTAMP, IMO, MMSI, SHIPNAME, TYPE_NAME, SHIPTYPE,CALLSIGN, FLAG, LENGTH, WIDTH, DRAUGHT, GRT, DWT, YEAR_BUILT, LAT, LON, SPEED, COURSE, STATUS, ETA, ETA_CALC, ETA_UPDATED, LAST_PORT_ID, LAST_PORT, LAST_PORT_UNLOCODE, LAST_PORT_COUNTRY, LAST_PORT_TIME, PORT_ID,PORT_UNLOCODE, CURRENT_PORT, CURRENT_PORT_COUNTRY, NEXT_PORT_ID, NEXT_PORT_UNLOCODE, NEXT_PORT_NAME, NEXT_PORT_COUNTRY, TIMESTAMP, IMO, SHIP_ID, MMSI, SHIPNAME, SHIPCLASS, MANAGER, OWNER, FROM_PORT_ID, FROM_PORT, NEXT_PORT_1_ID, NEXT_PORT_1, NEXT_PORT_1_PROB, NEXT_AREA_1, NEXT_AREA_1_PROB, NEXT_PORT_2_ID, NEXT_PORT_2, NEXT_PORT_2_PROB, NEXT_AREA_2, NEXT_AREA_2_PROB, NEXT_PORT_3_ID, NEXT_PORT_3, NEXT_PORT_3_PROB, NEXT_AREA_3, NEXT_AREA_3_PROB, NEXT_PORT_4_ID, NEXT_PORT_4, NEXT_PORT_4_PROB, NEXT_AREA_4, NEXT_AREA_4_PROB, NEXT_PORT_5_ID, NEXT_PORT_5, NEXT_PORT_5_PROB, NEXT_AREA_5, NEXT_AREA_5_PROB, IMO, SHIP_ID, MMSI, SHIPNAME, SHIPCLASS, MARKET, FROM_PORT_ID, FROM_PORT, NEXT_PORT_ID, NEXT_PORT, NEXT_AREA, NEXT_PORT_PROB, NEXT_AREA_PROB, PORT_ID, YEAR, WEEK, MARKET, SHIPCLASS, TIME_ANCH, TIME_PORT, VESSELS, CALLS, TIME_ANCH_STDEV, TIME_ANCH_DIFF, TIME_ANCH_DIFF_PERC, TIME_PORT_STDEV, TIME_PORT_DIFF, TIME_PORT_DIFF_PERC, SHIP_ID, MMSI, IMO, LAST_PORT_ID, LAST_PORT, LAST_PORT_UNLOCODE, LAST_PORT_TIME, NEXT_PORT_NAME, NEXT_PORT_UNLOCODE, ETA_CALC, SHIP_ID, MMSI, IMO, LAST_PORT_ID, LAST_PORT, LAST_PORT_UNLOCODE, LAST_PORT_TIME, NEXT_PORT_NAME, NEXT_PORT_UNLOCODE, ETA_CALC, DISTANCE_TRAVELLED, DISTANCE_TO_GO, SPEED_CALC, DRAUGHT, DRAUGHT_MAX, LOAD_STATUS_NAME, ROUTE, ETD_CALC, TIME_ANCH, TIME_PORT, SHIPNAME, MMSI, EVENT_ID, EVENT_NAME, EVENT_CONTENT, TIMESTAMP, MMSI, DESTINATION, LAST_PORT_ID, LAST_PORT, LAST_PORT_UNLOCODE, LAST_PORT_TIME, NEXT_PORT_ID, NEXT_PORT_NAME, NEXT_PORT_UNLOCODE, ETA, ETA_CALC, MMSI, DESTINATION, LAST_PORT_ID, LAST_PORT, LAST_PORT_UNLOCODE, LAST_PORT_TIME, NEXT_PORT_ID, NEXT_PORT_NAME, NEXT_PORT_UNLOCODE, ETA, ETA_CALC, DISTANCE_TRAVELLED, DISTANCE_TO_GO, SPEED_CALC, DRAUGHT, DRAUGHT_MAX, LOAD_STATUS_NAME, ROUTE, SHIP_ID, MMSI, IMO, DOCK_TIMESTAMP_LT, DOCK_TIMESTAMP_UTC, DOCK_TIMESTAMP_OFFSET, UNDOCK_TIMESTAMP_LT, UNDOCK_TIMESTAMP_UTC, UNDOCK_TIMESTAMP_OFFSET, SHIPNAME, TYPE_NAME, DWT, GRT, FLAG, YEAR_BUILT, BERTH_ID, BERTH_NAME, TERMINAL_ID, TERMINAL_NAME, PORT_ID, PORT_NAME, UNLOCODE, COUNTRY_CODE, DESTINATION_ID, DESTINATION, MMSI, SHIPNAME, MOVE_TYPE, TYPE_NAME, DRAUGHT, LOAD_STATUS, PORT_OPERATION, INTRANSIT, DISTANCE_TRAVELLED, VOYAGE_SPEED_AVG, VOYAGE_SPEED_MAX, VOYAGE_IDLE_TIME_MINS, ELAPSED_NOANCH, PORT_ID, PORT_NAME, UNLOCODE, TIMESTAMP_LT, TIMESTAMP_UTC, AIS-transmitted The International Maritime Organization (IMO) number of the vessel you wish to track. https://services.marinetraffic.com/api/expectedarrivals/v:3/8205c862d0572op1655989d939f1496c092ksvs4/timespan:2/country:US/dwt_min:100000/dwt_max:160000/shiptype:7/protocol:xml, Description: Receive a list of available routes and distances from a specific point to a port or from port to port, Endpoint URL: https://services.marinetraffic.com/api/exportroutes, Example API call: The Traffic Service provides real time traffic information related to markets, incidents, and flow. For your convenience, API Services are organised in categories so that you can swiftly select those that better suit your needs. Search MarineTraffic database for a vessel. Traffic API. https://services.marinetraffic.com/api/vesselevents/8205c862d0572op1655989d939f1496c092ksvs4/mmsi:355906000/event_type:19/limit_events:2/timespan:160, Example #2 API call: The default value is /page:1/, Typical API call: Documentation for this API service is still pending. When you are ready, click on the, Now is the time to specify the vessels that you wish to track using the API Service PS02, as well as the type of responses and the data fusion (Terrestrial/Satellite) of your choice. URL to the Details page of the subject vessel at MarineTraffic, Timestamp in the future to start looking for expected arrivals.