Time Series Data

The International Trade Datasets provide detailed trade data between the United States and its international trade partners. The most current monthly and annual trade statistics are available in the Monthly International Trade Datasets (MITD) and Annual International Trade Datasets (AITD).

Monthly International Trade Datasets (January 2013 – present)

The Monthly International Trade Timeseries Datasets provide the most comprehensive current month and cumulative year-to-date export and import statistics using multiple commodity classification systems. The Monthly International Trade Datasets currently have statistics from January 2013 to present. Previously released trade data are revised annually with the publication of April statistics.

Note: The endpoint splitting will not affect the annual international trade datasets.

The Annual International Trade Datasets were developed for use with the U.S. Census Bureau’s World Population Clock. The Annual International Trade Datasets currently have statistics from 2005 to the most recent available full year of data.  Previously released trade data are revised annually with the publication of April statistics.

For a detailed guide on how to use the International Trade Datasets in the Census API, visit the Guide to International Trade Datasets.

Data on U.S. exports of merchandise from the U.S. to all countries, except Canada, are compiled from the Electronic Export Information (EEI) filed by the U.S. Principle Party of Interest or their agents through the U.S. Customs' Automated Commercial Environment (ACE). Filing the EEI is mandatory under Chapter 9, Title 13, United States Code. Qualified exporters, or their agents, submit EEI data by automated means directly to the U.S. Census Bureau.

Data on U.S. imports of merchandise are compiled primarily from automated data submitted through the U.S. Customs' Automated Commercial Environment (ACE). Other sources of import data include import entry summary forms, warehouse withdrawal forms and Foreign Trade Zone documents. Data on imports of electricity and natural gas from Canada are obtained from Canadian sources.

• API Call: api.census.gov/data/timeseries/intltrade/exports/hs
• Examples: api.census.gov/data/timeseries/intltrade/exports/hs/examples.html
• Geographies: api.census.gov/data/timeseries/intltrade/exports/hs/geography.html
• Variables: api.census.gov/data/timeseries/intltrade/exports/hs/variables.html
• Example Call: Shows the total export value and vessel export value from the district of Baltimore for all harmonized codes for December 2013

  api.census.gov/data/timeseries/intltrade/exports/hs?get=DISTRICT,DIST_NAME,E_COMMODITY,E_COMMODITY_LDESC,ALL_VAL_MO,ALL_VAL_YR,VES_VAL_MO,VES_VAL_YR&YEAR=2013&MONTH=12&DISTRICT=13

• Example Call: Shows the year-to-date total, vessel, and air export value and year-to-date card count for every HS code for April 2013

  api.census.gov/data/timeseries/intltrade/exports/hs?get=E_COMMODITY,E_COMMODITY_LDESC,ALL_VAL_YR,VES_VAL_YR,AIR_VAL_YR,CC_YR&YEAR=2013&MONTH=04

• API Call: api.census.gov/data/timeseries/intltrade/imports/enduse
• Examples: api.census.gov/data/timeseries/intltrade/imports/enduse/examples.html
• Geographies: api.census.gov/data/timeseries/intltrade/imports/enduse/geography.html
• Variables: api.census.gov/data/timeseries/intltrade/imports/enduse/variables.html
• Example Call: Shows the general imports value and imports for consumption value for all End-use codes and all countries for January 2013

  api.census.gov/data/timeseries/intltrade/imports/enduse?get=CTY_CODE,CTY_NAME,I_ENDUSE,I_ENDUSE_LDESC,GEN_VAL_MO,CON_VAL_MO&time=2013-01

• Example Call: Shows the general imports value and imports for consumption value of cocoa beans from Ghana in February 2013

  api.census.gov/data/timeseries/intltrade/imports/enduse?get=CTY_CODE,CTY_NAME,I_ENDUSE,I_ENDUSE_LDESC,GEN_VAL_MO,CON_VAL_MO&I_ENDUSE=00010&CTY_CODE=7490&YEAR=2013&MONTH=02