Total Exports Per Country Per Month

Please note: API Access is only available to subscribers of our Corporate and Corporate Lite plan and is not available to subscribers of our consumer-focused subscription alternatives, such as the Premium or Premium Plus subscriptions. If you or your corporation are interested in a Corporate subscription to gain API access to the data that, 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:[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 three keys. Note that there may be two or more entries containing the same destination_name, but never two or more entries sharing both the same destination_name and cargo_type.

Response 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-2022, Inc.