International Trade (monthly 2010-present)

Time Series Data

The International Trade datasets provide detailed up-to-date trade data between the United States and its international trade partners. The most current monthly and annual trade statistics are available in these datasets, which are updated monthly on the day of press release.

 

Monthly International Trade Datasets (January 2010 – 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 2010 to present. Previously released trade data are revised annually with the publication of April statistics.

 

All queries to the Census Data API now require an API key. Please cut and paste the API Calls, Example Calls, Variables, Examples, and Supported Geography below into your web browser and replace YOUR_KEY_GOES_HERE with your personal API Key.

If you do not have an API Key, request one here.

Exports

  • Monthly U.S. Exports by Harmonized System (HS) Code: api.census.gov/data/timeseries/intltrade/exports/hs?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Exports by North American Industry Classification System (NAICS) Codeapi.census.gov/data/timeseries/intltrade/exports/naics?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Exports by End-use Code: api.census.gov/data/timeseries/intltrade/exports/enduse?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Exports by Standard International Trade Classification (SITC) Code: api.census.gov/data/timeseries/intltrade/exports/sitc?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Exports by Department of Agriculture Code: api.census.gov/data/timeseries/intltrade/exports/usda?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Exports by Advanced Technology Code: api.census.gov/data/timeseries/intltrade/exports/hitech?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Exports by State and Harmonized System (HS) Code: api.census.gov/data/timeseries/intltrade/exports/statehs?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Exports by State and North American Industry Classification System (NAICS): api.census.gov/data/timeseries/intltrade/exports/statenaics?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Exports by Port and Harmonized System (HS) Code: api.census.gov/data/timeseries/intltrade/exports/porths?key=YOUR_KEY_GOES_HERE

Imports

 

  • Monthly U.S. Imports by Harmonized System (HS) Codeapi.census.gov/data/timeseries/intltrade/imports/hs?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Imports by North American Industry Classification System (NAICS) Codeapi.census.gov/data/timeseries/intltrade/imports/naics?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Imports by End-use Codeapi.census.gov/data/timeseries/intltrade/imports/enduse?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Imports by Standard International Trade Classification (SITC) Codeapi.census.gov/data/timeseries/intltrade/imports/sitc?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Imports by Department of Agriculture Codeapi.census.gov/data/timeseries/intltrade/imports/usda?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Imports by Advanced Technology Codeapi.census.gov/data/timeseries/intltrade/imports/hitech?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Imports by State and Harmonized System (HS) Codeapi.census.gov/data/timeseries/intltrade/imports/statehs?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Imports by State and North American Industry Classification System (NAICS)api.census.gov/data/timeseries/intltrade/imports/statenaics?key=YOUR_KEY_GOES_HERE
  • Monthly U.S. Imports by Port and Harmonized System (HS) Codeapi.census.gov/data/timeseries/intltrade/imports/porths?key=YOUR_KEY_GOES_HERE

User Manual

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

Data Collection & Methodology

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.

For more information on U.S. international trade data collection and methodology, visit:

Monthly International Trade Time Series - Exports

  • API Call: api.census.gov/data/timeseries/intltrade/exports/hs?key=YOUR_KEY_GOES_HERE
  • Examples: api.census.gov/data/timeseries/intltrade/exports/hs/examples.html?key=YOUR_KEY_GOES_HERE
  • Geographies: api.census.gov/data/timeseries/intltrade/exports/hs/geography.html?key=YOUR_KEY_GOES_HERE
  • Variables: api.census.gov/data/timeseries/intltrade/exports/hs/variables.html?key=YOUR_KEY_GOES_HERE
  • 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&key=YOUR_KEY_GOES_HERE

  • 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&key=YOUR_KEY_GOES_HERE

Monthly International Trade Time Series - Imports

  • API Call: api.census.gov/data/timeseries/intltrade/imports/enduse?key=YOUR_KEY_GOES_HERE
  • Examples: api.census.gov/data/timeseries/intltrade/imports/enduse/examples.html?key=YOUR_KEY_GOES_HERE
  • Geographies: api.census.gov/data/timeseries/intltrade/imports/enduse/geography.htm?key=YOUR_KEY_GOES_HEREl
  • Variables: api.census.gov/data/timeseries/intltrade/imports/enduse/variables.html?key=YOUR_KEY_GOES_HERE
  • 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&key=YOUR_KEY_GOES_HERE

  • 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&key=YOUR_KEY_GOES_HERE

Page Last Revised - May 13, 2026