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.

Still need help? Contact us

© 2018-2024 TankerTrackers.com, Inc.