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 three taxonomies: Geographic Regions, Industries, and Topics. 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:
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.
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.
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.
Returns taxonomy terms for a match within the label field.
https://api.govwizely.com/ita_taxonomies/search?api_key={your key}&q={keyword}
Example
Returns terms that fall under the given high-level taxonomy types. Enter multiple values separated by commas. The possible values are Industries, Topics, Countries, Trade Regions, and World Regions.
https://api.govwizely.com/ita_taxonomies/search?api_key={your key}&types={value1,value2}
Example
Returns terms based on exact matching of the label field. Enter multiple values separated by commas.
https://api.govwizely.com/ita_taxonomies/search?api_key={your key}&labels={value1,value2}
Example
https://api.govwizely.com/ita_taxonomies/search?api_key={your key}&size={1 to 100}&offset={1 to n}
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.
Example
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.
The search_performed_at field displays the date and time of the current search in UTC.
Field | Description |
---|---|
id | The id assigned to the term. |
label | The name of the given taxonomy term. |
type | The high level taxonomy type under which the given term belongs. |
sub_class_of | An array containing hashes with the id and label of each parent term. |
annotations | A hash containing key/value pairs of annotation properties. |
datatype_properties | A hash containing key/array pairs of datatype properties. Each array contains id/label hashes. |
object_properties | A hash containing key/array pairs of object properties. Each array contains id/label hashes. |
USA.gov | FOIA | Privacy Policy | Disclaimer | Information Quality Guidelines | Terms of Service
The International Trade Administration, U.S. Department of Commerce, manages this global trade site to provide access to ITA information on promoting trade and investment, strengthening the competitiveness of U.S. industry, and ensuring fair trade and compliance with trade laws and agreements. External links to other Internet sites should not be construed as an endorsement of the views or privacy policies contained therein.