MTMarineTraffic

Endpoints#

• POST/v1/maritime/vesselsMarineTraffic vessels2 credits

Example#

MarineTraffic vessels, with POST /v1/maritime/vessels. Set SCRAPERCOMPANY_API_KEY to your key and run it; the full parameter list is in the API reference.

curl -X POST "https://api.scrapercompany.com/v1/maritime/vessels" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lat": 10.1375,
    "lon": 107.7525,
    "zoom": 12
  }'

{
  "search_parameters": {
    "engine": "maritime_vessels",
    "lat": 10.1375,
    "lon": 107.7525,
    "zoom": 12
  },
  "lat": 10.1375,
  "lon": 107.7525,
  "zoom": 12,
  "tile": {
    "x": 1636,
    "y": 966
  },
  "vessels": [
    {
      "ship_id": "7605737",
      "name": "SAWASDEE RIGEL",
      "lat": 10.063494,
      "lon": 107.74606,
      "speed_knots": 16.7,
      "course": 228,
      "heading": 228,
      "elapsed_s": 19,
      "destination": "TH LCH",
      "flag": "MH",
      "length_m": 172,
      "width_m": 27,
      "l_fore": 131,
      "w_left": 21,
      "dwt": 22253,
      "ship_type": 7,
      "gt_ship_type": 11
    }
  ],
  "total": 1,
  "skipped_rows": 0
}

Try it on your key

Good to know#

• Latitude is -90 to 90 and longitude is -180 to 180. Zoom is an integer from 1 to 20 and defaults to 12. A lower zoom covers more sea.
• There is no page token. One call returns the vessels in that single tile, and total is how many this response includes.
• speed_knots is speed in knots. elapsed_s is returned with each position. The coordinates are the latest reported position in the tile. The API does not publish a maximum age, and a vessel missing from the tile is not evidence that it is absent.
• ship_type and gt_ship_type are numeric codes in the response. This reference does not define those codes.
• A tile with vessels costs the listed price. An empty tile is HTTP 200 and is free. A block, an upstream failure, or a tile whose rows cannot be read is HTTP 503 with Retry-After and is free.

Guides#