About the API
Investinkainuu.fi provides a free to use API for all Kainuu municipalities. The API contains investment data found on this site.
To use the API, you must make a GET request to https://investinkainuu.fi/<LOCATION>/wp-json/iik/v1/invest
<LOCATION> is replaced with the name of the municipality ie. https://investinkainuu.fi/sotkamo/wp-json/iik/v1/invest
All available endpoints are:
- https://investinkainuu.fi/hyrynsalmi/wp-json/iik/v1/invest
- https://investinkainuu.fi/kuhmo/wp-json/iik/v1/invest
- https://investinkainuu.fi/paltamo/wp-json/iik/v1/invest
- https://investinkainuu.fi/puolanka/wp-json/iik/v1/invest
- https://investinkainuu.fi/ristijarvi/wp-json/iik/v1/invest
- https://investinkainuu.fi/sotkamo/wp-json/iik/v1/invest
- https://investinkainuu.fi/suomussalmi/wp-json/iik/v1/invest
The API does not require authentication.
API Version: 1.1 (as of 21.7.2024)
The API is a subject to change without a prior notice.
Changelog
- v. 1.0 – Initial release
- v. 1.1 – Changed URL to investinkainuu.fi
Parameters
API accepts the following parameters:
| Parameter | Required | Default | Description |
|---|---|---|---|
| lang | no | en | Language of the data. Accepts values fi or en. Data is currently only available in English. |
Example request
GET /sotkamo/wp-json/iik/v1/invest
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://investinkainuu.fi/sotkamo/wp-json/iik/v1/invest',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
));
$response = curl_exec($curl);
curl_close($curl);
var_dump($response);
?>Example JSON response:
{
"title": "Invest in Sotkamo",
"description": "<h5>Vuokatti’s tourism offering has for decades provided the main business sector in Sotkamo due to a long history of Vuokatti Sport Institute and Vuokatti Ski resort.</h5>\r\nVuokatti provides both winter and summer tourism activities for active holidaymakers but also for professional athelets through Vuokatti Sport olympic training centre.\r\n\r\nBeside tourism, mining is important for the economy of Sotkamo. One of the largest nickel deposits in Europe is located in Talvivaara where the Terrafame mining operates producing nickel, zinc, cobalt and copper. Also Mondo Minerals mines talc in Lahnaslampi.",
"image": {
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2019/11/iik-map-sotkamo-150x150.png",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2019/11/iik-map-sotkamo.png",
"alt": ""
},
"gallery": [
{
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/VD0R1289-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/VD0R1289-scaled.jpg",
"alt": ""
},
{
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/laskua-rinteiltä-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/laskua-rinteiltä-scaled.jpg",
"alt": ""
},
{
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/IMG_7726-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/IMG_7726-scaled.jpg",
"alt": ""
},
{
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/hiukassa-porukkaa-1-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/hiukassa-porukkaa-1-scaled.jpg",
"alt": ""
},
{
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/AHa-13-4-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/AHa-13-4-scaled.jpg",
"alt": ""
},
{
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/M3A0654_1400px-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/M3A0654_1400px.jpg",
"alt": ""
}
],
"opportunities": [
{
"ID": 393,
"url": "https://investinkainuu.com/sotkamo/opportunity/placeholder-opportunity/",
"title": "Vuokatti Eastern Slopes - Hotel",
"description": "<b>The opportunity exists to be at the heart of the next expansion stage in the fourth largest ski resort of Finland. Working closely with the municipality and land owners.</b>\r\n\r\nThe proposed expansion of Vuokatti into the eastern slopes area is currently seeing infrastructure investment by the municipality.\r\n\r\nCurrently at project level, the Municipality would like to meet and discuss the plans with potential partners. The opportunity for early engagement will allow for investors and operators to have an active input into the land use planning and public infrastructure investment.\r\n\r\nA high level hotel concept description is contained in the attached file.",
"description_short": "The opportunity exists to be at the heart of the next expansion stage in the fourth largest ski resort of Finland. Working closely with the municipality and land owners.\r\n",
"total_investment_value": "6-250MEU",
"industries": [
"tourism"
],
"image": {
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/03/Kuva1-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/03/Kuva1.jpg",
"alt": ""
},
"gallery": [
{
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/03/Kuva4-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/03/Kuva4.jpg",
"alt": ""
},
{
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/03/Kuva1-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/03/Kuva1.jpg",
"alt": ""
},
{
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/03/Kuva5-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/03/Kuva5.jpg",
"alt": ""
},
{
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/03/Kuva3-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/03/Kuva3.jpg",
"alt": ""
}
],
"updated": "2020-10-19 10:06:25",
"contacts": [
{
"name": "Carl Wideman",
"organisation": "Kainuun Etu Oy",
"phone": "+358 44 551 4621",
"email": "carl.wideman@kainuunetu.fi"
}
],
"caseowners": [
{
"name": "Mika Kilpeläinen",
"organisation": "Mayor, Municipality of Sotkamo",
"phone": "",
"email": "mika.kilpelainen@sotkamo.fi"
}
],
"files": [
{
"name": "Vuokatti Eastern Slopes hotel concept",
"file": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/Teaser_Vuokatti_eastern-slopes_FCG.pdf"
}
]
},
{
"ID": 383,
"url": "https://investinkainuu.com/sotkamo/opportunity/lorem-ipsum/",
"title": "Private Sector Opportunities",
"description": "<b>From time to time there can be opportunities in the ownership of the private sector. Information can be subject to Non-Disclosure agreement.</b><b> Please contact Invest in Kainuu to register to receive this information.</b>\r\n\r\nPrivate land owners, Operating Finnish companies and construction companies have the opportunity to register their off plan investment opportunities with Invest in Kainuu. There are key criteria that must be satisfied to be included on this page.\r\n\r\nThere is also the possibility to submit an investment opportunity to us, along with an executive summary and some degree of pre-feasibility material for matching with potential investors.\r\n\r\nPotential investors may register their interest to receive off-plan investment opportunities from Invest in Kainuu. (Subject to the criteria determined by the case owner).",
"description_short": "From time to time there can be opportunities in the ownership of the private sector. Information can be subject to Non-Disclosure agreement Please contact Invest in Kainuu to register to receive this information.\r\n",
"total_investment_value": "Various",
"industries": [
"tourism"
],
"image": {
"thumbnail": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/Haapala_talvi-150x150.jpg",
"original": "https://investinkainuu.com/sotkamo/wp-content/uploads/sites/4/2020/02/Haapala_talvi-scaled.jpg",
"alt": ""
},
"gallery": [],
"updated": "2020-06-10 11:31:09",
"contacts": [
{
"name": "In Finnish",
"organisation": "Invest in Kainuu",
"phone": "+358 44 551 4611",
"email": ""
},
{
"name": "In English ",
"organisation": "Invest in Kainuu ",
"phone": "+358 44 551 4621",
"email": ""
}
],
"caseowners": false,
"files": false
}
]
}Support
For technical support, please contact support@koutamedia.fi
Terms and conditions
You can read more about our terms and conditions here: https://investinkainuu.fi/working-with-us/terms-conditions/
