Subscriptions

Website

Account

API

General / Other

Vessel Size Classification

Endpoint: Total Exports Per Country Per Month

Please note: This API endpoint is only available to subscribers of our Corporate and Corporate Lite plans. If you or your corporation are interested in a Corporate subscription to gain API access to the data that TankerTrackers.com, Inc. collects, please contact us for a quote. For Corporate Lite subscriptions, you can upgrade using the Subscription Management Portal from the account page.

This API endpoint returns the total amount of exports, grouped by destination country, for any given exporting country, year, and month. Use this API to see the answer to questions like “How much did Saudi Arabia export to other countries during the month of May, 2021?”.

Endpoint URL:

https://tankertrackers.com/api/em/v4/[API Key]/[Country Code]/[Year]/[Month]

URL Parameters:

Parameter	Description
`[API Key]`	The Unique API Key as indicated on the Account Management page.
`[Country Code]`	The two-letter country code for the country, for example `EG`
`[Year]`	The four-digit year, for example `2021`.
`[Month]`	The number of the month, for example `4` for April.

The resulting output is a JSON array containing one JSON object per country that has received exports during that particular month. Each of the individual JSON Objects contains the same four keys, described below. Note that there may be two or more entries containing the same destination_name and destination_code, but never two or more entries sharing the same destination_name, destination_code and cargo_type.

Note that this endpoint has an additional key in the response, indicating how many days of data the sample is based on. This can be very convenient when grabbing the current month’s values so that an accurate BPD can be calculated.

Response Keys:

In the response, the data object will contain the following keys:

JSON Key Name	JSON Value Type	Nullable?	Description
`destination_country`	`string`	`false`	The full name of the destination country, for example `Australia`.
`destination_code`	`string`	`false`	The ISO 3166-2 code of the destination country, for example `AU`.
`barrels`	`integer`	`false`	The number of barrels exported to said destination from the requested country during the given period.
`cargo_type`	`string`	`false`	The type of cargo exported to this destination during the given period.