Resources / Overview of APIs
The International Trade Administration (ITA) provides Application Programming Interfaces (APIs) as JSON endpoints for authoritative information on U.S. exporting and international trade. ITA continually updates the APIs so check this portal often. Please provide feedback to help improve the APIs and to recommend new data sets.
Consolidated Screening List API
Background: The Consolidated Screening List API consolidates eleven export screening lists of the Departments of Commerce, State and the Treasury into a single data feed as an aid to industry in conducting electronic screens of potential parties to regulated transactions. In the event that a company, entity or person on the list appears to match a party potentially involved in an export transaction, additional due diligence should be conducted before proceeding. There may be a strict export prohibition, requirement for seeking a license application, evaluation of the end-use or user to ensure it does not result in an activity prohibited by any U.S. export regulations, or other restriction. For more information view the informational video from the National Customs Brokers. The API only contains active entities on the list. For historical research, please reference the sources directly. The output format for this API is JSON. This data set is updated hourly. Test the API using the export.gov CSL search app.
Stay Compliant: When using this API, developers must provide the following information to their users to help them stay compliant with exporting law. If a party to a user’s transaction matches the name of a party on the consolidated list, the user must check the official publication of restricted parties in the Federal Register or the official lists of restricted parties maintained on the websites of the Departments of Commerce, State and the Treasury to ensure full compliance with all of the terms and conditions of the restrictions placed on the parties on this list. Links to these websites are found below as well as in the “Source List URL” and “Source Information URL” fields that accompany each party returned in the API. These links connect users to the specific webpage that contain additional information about how to use each specific list. If you are interested in learning which countries the U.S. has sanctions against, visit the U.S. Department of Treasury's Sanctions Programs and Country Information page.
Ideas for Using the Data: There are many screening lists available that developers can integrate with this Consolidated Screening List API. Consider mashing this API with data from the Federal Register to create a more comprehensive search tool.
Note: It has been discovered that erroneous entries have been appearing on the Non-SDN Iranian Sanction Act List (NS-ISA) in the CSL API. A change is being made to alter metadata that were incorrectly associated with these records. The names in question are on OFAC’s EO13599 list and US persons are prohibited from dealing with them. If you have any question regarding this change, please e-mail us at DataServices@trade.gov Thank you.
Trade Events API
Background: The Trade Events API provides data on events for U.S. businesses interested in selling their products and services overseas. These events include industry conferences, webinars, lectures, and trade missions organized by ITA and other trade agencies including:
- The U.S. Trade and Development Agency
- The State Department
- The Small Business Administration
Why This Data Matters: Exporting can be very lucrative but also very complicated – especially for new businesses. Businesses can get tremendous value from meeting with trade specialists and learning about new opportunities for their business.
Ideas for Using the Data: ITA and the trade agencies add new events all the time, so this is a great resource for dynamic content. Use these events to augment information you have about a particular country, industry, or topic. For example, ThinkGlobal.com uses them as a way to attract customers to their mobile app.
Trade Leads API
Background: The Trade Leads API provides contract opportunities for U.S. businesses selling their products and services overseas. These leads come from a variety of sources and we continue to expand the number of leads available. We currently provide trade leads, procurement opportunities, and contract notifications from:
- The State Department’s Business Information Database System (BIDS)
- The United Kingdom
- The Millennium Challenge Corporation
- The United States Trade and Development Agency (USTDA)
Why This Data Matters: U.S. Businesses often request more notifications about trade leads. It can be difficult for them to learn about overseas opportunities especially those within complex industries where partnerships and sub-contracts are the norm. This API aggregates trade leads from several domestic and international sources so users have a broad selection of opportunities to choose from.
Ideas for Using the Data: Use this API to keep businesses aware of the latest leads in particular industries or locations. You can also enhance the value of the leads by incorporating reports from ITA’s Market Intelligence or Trade News & Articles APIs.
FTA Tariff Rates API
Background: The FTA Tariff Rates API provides data about each country with whom the United States has a Free Trade Agreement (FTA). When the U.S. enters into an FTA with a foreign government, it negotiates lower tariff rates with that government for a wide variety of products. A tariff is a tax that a company must pay a foreign country when shipping a product to that country. Typically the FTA tariffs rates decline over several years. The API provides information on tariff rates for the following countries: Australia, Bahrain, Chile, Colombia, Costa Rica, Dominican Republic, El Salvador, Guatemala, Honduras, Morocco, Nicaragua, Oman, Panama, Peru, Singapore, and South Korea. Products are indicated by their HS-6 code. Because the North American Free Trade Agreement (NAFTA) tariff rates have declined to zero, Canada and Mexico data is not included. Similarly, the tariff rates for almost all products shipped to Israel and Jordon have declined to zero and are not included here. The output format for this API is JSON. This data set is updated only when the corresponding Free Trade Agreement is negotiated or updated. Test the API using the demo search app.
Why This Data Matters: Free Trade Agreements help lower the cost for companies to ship their products overseas. Knowing tariffs rates for exporting specific products to each country helps companies understand the true cost of doing business with that country. There are other tariff schedules, such as those negotiated by the World Bank, so it’s important for U.S. companies to know their options. For more information read the U.S. Free Trade Agreements page on export.gov. U.S. businesses should pay close attention to the Rules of Origin pages for each country to determine whether or not their product qualifies for the reduced tariff rates under that FTA.
Ideas for Using the Data: The FTA API only includes tariff data for the 16 countries listed on the Background tab. The World Trade Organization publishes trade agreements among many countries around the world, not just those with the U.S. As such, they have different tariff rates that developers can use to compare with the rates in this API. The United States Department of Agriculture (USDA) also publishes tariff rates from the same FTAs that this API uses as a source. The USDA does not publish rates for as many countries as this API, however they do provide more detailed information, especially about products that have safeguards and quotas. They also list the thresholds where the tariff rate changes when the quantity of the product being shipped changes. The U.S. Census Bureau provides a search tool for finding the HS-6 code assigned to a particular product. Developers could integrate this functionality into their own tool to help U.S. companies find tariff rates for their products more easily. Mashed together, the data from this API as well as the data from the World Bank, the USDA, and Census can enhance Web pages about shipping particular products overseas.
FAQs in Exporting API
Background: The Frequently Asked Questions (FAQs) API includes more than 200 commonly asked questions about exporting. The answers provided are from government experts that specialize in unique aspects of trade. The output format for this API is JSON. This data set is updated daily. Test the API using the demo search app.
Why This Data Matters: Exporting goods and services overseas can be very confusing, especially for those getting started. This FAQ API is particularly relevant to trade organizations that want to help their members and customers learn the basics of exporting.
Ideas for Using the Data: Because the FAQs are tagged by country, industry, and topic area, they can easily be published on pages that are specific to that tag. For example, a page about Brazil can include just the top most frequently asked questions about exporting to Brazil.
ITA Offices and Centers API
Background: The ITA Offices & Centers API provides contact and address information for all of ITA’s domestic and international export assistance centers. There are almost 200 ITA centers worldwide whose locations are managed by ITA’s internal office management system.The output format for this API is JSON. This data set is updated weekly. Test the API using the demo search app. Be sure to sign up for an API key to get access to the API.
Why This Data Matters: ITA centers are often collocated with offices from the State Department or other trade agencies. Therefore, the addresses change with some regularity. You can be confident that when you use this resource to help your customers it will be accurate.
Ideas for Using the Data: The API provides methods for accessing the city, state, and country for each export assistance center. This enables you to use the listing of ITA centers to augment a directory of business counseling services. Business.usa.gov publishes the ITA centers alongside Small Business Development Centers (SBDCs), SBA District Offices, and Women’s Business Centers.
Zip Code to USEAC API
Background: The Zip Code to USEAC API provides direct access to the U.S. Export Assistance Centers (USEACs) that have been assigned to all of the 40,000+ zip codes in the United States. It’s not enough to do a proximity search for a zip code and a USEAC. Each center has specialists on hand for each particular region. The output format for this API is JSON. This data set is updated daily. Test the API using the demo search app.
Why This Data Matters: ITA USEACs are often collocated with offices from the State Department or other trade agencies and have access to experts that specialize in particular regions. Using will help your users find the right specialist for their region.
Ideas for Using the Data: Use this zip code to USEAC API in conjunction with ITA’s Offices and Centers API to let your users search for a USEAC by zip or to let them see a list of all USEACs in the U.S. Other agencies, such as the Small Business Administration, also publish tools for letting users search for assistance centers by zip code. Build a comprehensive search tool that lets users find the help centers they’re looking for.
Business Service Providers API
Background: The Business Service Providers (BSP) API is a directory of U.S. and foreign-based businesses providing services that many small and medium sized exporters require to succeed in foreign markets. Businesses can sign up to be a Service Provider on export.gov. The output format for this API is JSON. This data set is updated hourly. Test the API using the demo search app.
Endorsement Notice: The BSP directory is intended to provide an additional resource to U.S. exporters. The BSP directory is not comprehensive. Inclusion does not constitute an endorsement or recommendation by the International Trade Administration (ITA). ITA has performed limited due diligence research but strongly recommends that you perform your own due diligence investigation and background research on any company. ITA assumes no responsibility for the professional ability or integrity of the providers listed. ITA reserves the right not to list any particular company.
Ideas for Using the Data: Business Service Providers are particularly helpful for U.S. companies that are just getting started exporting or that are looking to expand into a new market. Integrate the BSP directory into an “Export Resources” page that lets users search the BSP by geographic market or industry.
ITA Taxonomies API
Background: The ITA Taxonomies API gives developers direct access to the exporting, trade, and investment terms that ITA uses to tag the content and data in its other APIs. Currently, ITA has four taxonomies: Industries, Trade Topics, Geographic Locations, and U.S. Government. This API includes all terms in their proper hierarchy in the relevant taxonomy. ITA imports data for its other APIs from many sources. If the source data is already tagged, ITA does the following:
- Imports those tags (terms) along with the data
- Maps the terms to ITA’s taxonomies
- Publishes both the original terms and the ITA terms with the data in the API.
Why This Data Matters: Having an established taxonomy enables developers to quickly search for particular content and data. ITA tags content and data at the lowest, reasonable level of detail. ITA reviews and upgrades its taxonomies on a regular basis to ensure it reflects the content and data accurately. As such, developers can be assured that when they perform a query on a particular term they will receive only the results that are relevant to that term.
Ideas for Using the Data: Use this API to populate drop downs, picklists, or a faceted navigation in your software. You can also use this API to populate your own trade terms.
De Minimis API
Background: The De Minimis API provides data about the De Minimis amount and the Value Added Tax (VAT) amount that products may be subject to when exported to foreign countries. “De Minimis” is the threshold for a product’s value below which no duty or tariff is charged. Furthermore, products below the De Minimis undergo minimal clearance procedures, such as customs and paperwork requirements. Similarly, the value of the exported products must exceed the VAT amount before it is subject to VAT. The API includes De Minimis and VAT amounts for almost 80 countries in that country’s currency. The output format for this API is JSON. This data set is updated only when the De Minimis or VAT amounts have been updated, which is usually once a year. Test the API using the demo search app.
Why This Data Matters: U.S. companies interested in exporting their products to new foreign markets need to be aware of the tariff rates and taxes that their products may be subject to, in order to price products for the end customer. A U.S. company is less likely to be subject to tariffs if the value of their product falls below the De Minimis amount. U.S. companies selling low value, small shipments are more likely to export to countries with high De Minimis levels.
Ideas for Using the Data: De Minimis and VAT are two factors in determining the “total landed cost” for exporting a product overseas. Use this data, along with the tariff data from ITA’s Tariff Rates API to improve your algorithm for computing landed cost. Other factors to consider are: packing charges, shipping and freight charges, and local taxes.
Market Intelligence API
Background: The Market Intelligence API provides metadata for Country Commercial Guides and other market insight reports that are produced by ITA’s trade experts. ITA commercial officers that are stationed around the world, publish these authoritative reports in conjunction with Foreign Service officers from the State Department. The API only provides the metadata and links to the reports – not the reports themselves. The output format for this API is JSON. This data set is updated daily.
Why This Data Matters: U.S. businesses can use these reports to plan their market-entry the right way. The reports help them learn their product’s potential in a given market and the best prospects for success. There are two report types available and they are categorized by country and industry:
- Country Commercial Guides
- Market Insight Reports
Ideas for Using the Data: Use these reports to augment other market intelligence that you use internally or provide for your customers. You can use the search tags to pull only the country, region, and industry information that you are interested in. The API also provides the publish dates so you can to use the last_published_date field to order the information display with the most recent updates on top.