API Key

Get an API Key

Manage Your API Key

Top APIs

Consolidated Screening List

Trade Events

Trade Leads

Tariff Rates

De Minimis

API Resources

List of all APIs

Search Widgets

ITA Taxonomy

Trade Events API

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.

The output format for this API is JSON. This data set is updated hourly. Test the API using the demo search app. Be sure to sign up for an API key to get access to the API.

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.

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.

Resource URL

This endpoint will search across all four trade event sources. To search a subset, see sources below.

Search Parameters for Trade Events Sources

keyword

Searches for a match within the registration_title, description, event_name, industries, city, venues.city, venues.state, venues.country, contacts.first_name, contacts.last_name, and contacts.person_title fields.

https://api.trade.gov/v1/trade_events/search?api_key={your key}&q={term}

Example

industries

Returns trade events for specific controlled industry names. This method allows you to search for multiple industries (plural) separated by commas.

https://api.trade.gov/v1/trade_events/search?api_key={your key}&industries={terms}

Example

countries

Returns trade events for a specific country based on ISO alpha-2 country codes. This method allows you to search for multiple countries (plural) separated by commas but will only return one country (singular) per event.

https://api.trade.gov/v1/trade_events/search?api_key={your key}&countries={country code}

Example

sources

Searches only the events specified by the Source Abbreviation.

 https://api.trade.gov/trade_events/search?api_key={your key}&sources={event source}

Example

Source Abbreviations are as follows:

  • State Department’s Direct Line = DL
  • International Trade Administration = ITA
  • Small Business Administration = SBA
  • U.S. Trade and Development Agency = USTDA

start_date

Returns events based on their start date. Dates are filtered by comparing them against an inclusive range, which must be entered with the following format: YYYY-mm-dd TO YYYY-mm-dd. Searching on a single date can be done by entering the same value for the start and end of the range.

https://api.trade.gov/v1/trade_events/search?api_key={your key}&start_date={YYYY-mm-dd TO YYYY-mm-dd}

Example

end_date

Returns events based on their end date. Dates are filtered by comparing them against an inclusive range, which must be entered with the following format: YYYY-mm-dd TO YYYY-mm-dd. Searching on a single date can be done by entering the same value for the start and end of the range.

https://api.trade.gov/v1/trade_events/search?api_key={your key}&end_date={YYYY-mm-dd TO YYYY-mm-dd}

Example

size + offset

The size parameter allows you to configure the number of results to be returned up to a maximum of 100. The offset parameter defines the offset from the first result you want to fetch. Unless specified the API returns 10 results at a time.

https://api.trade.gov/v1/trade_events/search?api_key={your key}&size={1 to 100}&offset={1 to n}

Example

Metadata

Last Updated and Last Imported

Recency information about each source queried is given in sources_used in the following fields:

Field Description
source The name of the issuing agency.
source_last_updated The most recent date and time the data changed.
last_imported The most recent date and time the data was imported.

The source_last_updated field reflects the most recent date and time we noticed that the issuing agency had updated the data. We check for updates and import lists hourly.

Search Performed At

The search_performed_at field displays the date and time of the current search in UTC.

Four Sources for Trade Events

State Department (DL)

International Trade Administration (ITA)

Small Business Administration (SBA)

U.S. Trade and Development Agency (USTDA)

Return Values

Each event source returns a unique set of fields. Not every source provides all fields.

Field Description Source
id Unique identifier for event. DL, ITA, SBA, USTDA
event_name Name given for the event. DL, ITA, SBA, USTDA
event_type The type of the event (ITA Values). ITA, SBA, USTDA
start_date Start date of the event. ITA, SBA, USTDA
start_time The start time of the event. SBA, USTDA
end_date The date the event will end. ITA, SBA, USTDA
end_time The end time of the event. SBA, USTDA
time_zone The time zone of the event’s location. SBA
cost Cost of the event. ITA, SBA, USTDA
cost_currency The currency of the cost value. USTDA
registration_link URL for the event’s registration page. ITA, SBA, USTDA
registration_title Title of the registration URL. ITA, USTDA
description Text describing the event. DL, ITA, SBA, USTDA
industries Industry categories assigned to the event. ITA, SBA, USTDA
ita_industries The ITA industries associated with the assigned industries. ITA, SBA, USTDA
url Link to the event’s web page. DL, ITA, USTDA
venues Venues array. Fields in italics. ITA, SBA, USTDA
     address Street address of the venue. ITA, SBA, USTDA
     city City of the venue. ITA, SBA, USTDA
     country Country of the venue. ITA, SBA, USTDA
     state State of the venue. ITA, SBA, USTDA
     venue Name of the venue. ITA, SBA, USTDA
contacts Contacts array. Fields in italics. ITA, SBA
     email Contact’s email address. ITA, SBA
     first_name Contact’s first name. ITA, SBA
     last_name Contact’s last name. ITA, SBA
     person_title Contact’s company title. ITA, SBA
     phone Contact’s phone number. ITA, SBA
     post Contact’s location. ITA, SBA
first_name The event contact’s first name. USTDA
last_name The event contact’s last name. USTDA
post The event contact’s location. USTDA
person_title The event contact’s title. USTDA
phone The event contact’s phone number. USTDA
email The event contact’s email address. USTDA
source Agency providing the event information. DL, ITA, SBA