Atoka API User Reference
Companies package "Foreign Market"
API tokens are configured to access only the packages each user needs; this means you might not have access to the content of this package. Ask your sales contact!
Available fields | Description | Data | Used by filters | Facet | Match | Stats |
---|---|---|---|---|---|---|
areas[] Private field | List of areas where the company might be operating. Areas might be of different levels: countries, intermediate regions, sub-regions or continents. Each single data-point might also be official or not, depending on the source it was gathered from. | - | - | |||
areas[].amount Private field | The volume (in euros) of export towards the area; this field is available only if the area was extracted from balance sheets (has | float | - | |||
areas[].continent Private field | UN M.49 code of the area continent; if area | "string" | foreignMarketContinents | |||
areas[].continentLabel Private field | Name of the area continent (eg: Europa). | "string" | - | |||
areas[].intermediateRegion Private field | UN M.49 code of the area intermediate region; if area | "string" | foreignMarketIntermediateRegions | |||
areas[].intermediateRegionLabel Private field | Name of the area intermediate region (eg: Isole del Canale). | "string" | - | |||
areas[].lastUpdate Private field | When the information was last updated. | date | - | |||
areas[].official Private field | Whether this area comes from an official source (such as the balance sheet) or has been inferred from different sources. | true | false | foreignMarketOfficial | |||
areas[].provenance[] Private field | Provenance of the area information. Currently three sources are available: "infocamere" means the area was made available through ItalianCom, the website InfoCamere offers to italian companies exporting abroad; "balanceSheets" is used for areas stated by the company itself in their financial notes to the accounts, which are automatically read and analysed by our data ingestion pipeline; lastly, "webLang" means the area was inferred by the company websites, in particular presence of multi-language content, analysed by our artificial intelligence systems. | "infocamere", "webLang", "balanceSheets" | - | |||
areas[].state Private field | ISO 3166-2 code of the area state (country); if area | "string" | foreignMarketStates | |||
areas[].stateLabel Private field | Name of the area state (country) (eg: Jersey) | "string" | - | |||
areas[].subRegion Private field | UN M.49 code of the area sub-region; if area | "string" | foreignMarketSubRegions | |||
areas[].subRegionLabel Private field | Name of the area sub-region (eg: Europa settentrionale). | "string" | - | |||
areas[].type Private field | Areas form a taxonomy: they are contained inside one another, they might have "parent" areas (bigger areas that contains them) and "children" areas (smaller areas that split the parent one); for foreign market areas we have four different levels: continents, sub-regions, intermediate regions, and states. Please notice that intermediate regions are available only in some specific cases: for example Europe (as a continent) is split in four sub-regions: Eastern Europe, Northern Europe, Southern Europe and Western Europe; among those, only Northern Europe has intermediate regions: Channel Island (which hosts two states: Jersey and Guernsey). Hence Jersey (with "state" level) will have both | "string" | - | |||
exportPropensity.score Private field | This score represents the tendency of companies to operate with foreign markets. The value is computed using companies for which we have evidence of export as example on which we built a profile that indicates not an export activity, but characteristics that indicate the likelihood that a company is interested in pursuing foreign markets. The value is normalized score from 0 to 100 | float | - | |||
exportPropensity.scoreLabel Private field | text representation of the | "string" | exportScores | |||
exportPropensity.updateTime Private field | last update time for score | date | - |
Example JSON fragment for package
{"exportPropensity": {"score": 0.42, "scoreLabel": "foo", "updateTime": "2015-12-24" },"areas": [{"continent": "150", "continentLabel": "Europa", "subRegion": "154", "subRegionLabel": "Europa settentrionale", "intermediateRegion": "830", "intermediateRegionLabel": "Isole del Canale", "state": "JE", "stateLabel": "Jersey", "type": "state", "official": true, "lastUpdate": "2017-12-25", "provenance": ["infocamere",...],"amount": 5432000 },...]}