Julkinen API yritystiedoille, pakotteiden tarkistuksille, henkilöseurannalle ja kiinteistöhakuun Latviassa, Liettuassa, Virossa, Suomessa ja Ruotsissa.
Pikaopas
API on käytettävissä ilman rekisteröintiä tai todennusta. Kaikki päätepisteet tukevat CORS:ia.
- Perus-URL
https://datreal.com/api/public/v1
Esimerkki
Pikaopas · cURL
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&countryCode=EE&limit=5"Käyttötapaukset
Päätepisteet ryhmiteltynä käyttötapauksittain, jotta voit valita oikean lukematta koko viitedokumentaatiota.
Haku ja etsintä
Hae ja nouda täydelliset yritysprofiilit, osoitteen automaattitäydennys ja perustiedot yrityksestä.
Omistus ja henkilöt
Osakkeenomistajat, tosiasialliset edunsaajat (UBO) ja tunnisteisiin perustuvat henkilö-yritys-osumat.
Vaatimustenmukaisuus
Pakotteiden, mustien listojen ja verovelvoitteiden tarkistukset LV-, LT-, EE-, FI- ja SE-alueilla.
Seuranta
Aikaikkunoidut muutossyötteet - uudet rekisteröinnit ja muut lähes reaaliaikaiset signaalit.
Kiinteistöt
Hae katasterikohteita ja saa kohdekohtaiset tiedot kirjatuilla myynneillä ja arvioilla.
API-katsaus
Itsensä kuvaava juuri, joka luettelee kaikki päätepisteet ja niiden parametrit.
Päätepisteet
Haku ja etsintä
Hae ja nouda täydelliset yritysprofiilit, osoitteen automaattitäydennys ja perustiedot yrityksestä.
GET /companies/search
/companies/searchEtsi yrityksiä nimellä, osoitteella tai Y-tunnuksella.
Parametrit
countryCode(valinnainen)- Suodata maakoodin mukaan (LV, LT, EE, FI, SE)
limit(valinnainen)- Tulosten määrä (1-100, oletus: 20)
nace(valinnainen)- NACE-koodin alku (esim. J tai 62). Voi korvata q-parametrin.
page(valinnainen)- Tulossivu (alkaen 1). Myöhempien sivujen hakuikkuna on rajattu.
q(valinnainen)- Hakuteksti (vähintään 2 merkkiä). Pakollinen, ellei nace ole annettu.
GET /companies/search · cURL
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&countryCode=EE&limit=5"GET /companies/{regcode}
/companies/{regcode}Hae yksityiskohtaiset tiedot tietystä yrityksestä, mukaan lukien pakotteiden tila.
Parametrit
countryCode(valinnainen)- Suodata maakoodin mukaan (LV, LT, EE, FI, SE)
regcode(pakollinen)- Y-tunnus
Vastaus sisältää
- Perustiedot (nimi, osoite, yritysmuoto)
- Rekisteröinti- ja sulkemispäivät
- Veronmaksajan luokitus ja ALV-tila
- TOL-koodi ja kuvaus
- Tilinpäätökset
- Pakotteiden tila (IsSanctioned: true/false)
GET /companies/{regcode} · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752?countryCode=LV"GET /companies/autofill
/companies/autofillHae yrityksen osoite- ja ALV-tiedot lomakkeen täydentämiseen.
Parametrit
countryCode(valinnainen)- Suodata maakoodin mukaan (LV, LT, EE, FI, SE)
limit(valinnainen)- Tulosten enimmäismäärä (1-50, oletus: 10)
q(pakollinen)- Yrityksen nimi tai Y-tunnus (vähintään 2 merkkiä)
Vastaus sisältää
- Y-tunnus
- Yrityksen nimi
- Täydellinen osoite
- ALV-numero (jos rekisteröity)
- Maakoodi (FI, LV, jne.)
GET /companies/autofill · cURL
curl "https://datreal.com/api/public/v1/companies/autofill?q=maxima&countryCode=LV&limit=5"GET /companies/{regcode}/financials
/companies/{regcode}/financialsHae yrityksen vuosittaiset tilinpäätökset. Palauttaa 404, jos tilinpäätöksiä ei ole.
Parametrit
countryCode(valinnainen)- Suodata maakoodin mukaan (LV, LT, EE, FI, SE)
regcode(pakollinen)- Y-tunnus
Vastaus sisältää
- reports - yksi rivi tilikautta kohden: liikevaihto, tulos, varat, oma pääoma, henkilöstö, kassavirta
- totalYears - palautettujen tilikausien määrä
GET /companies/{regcode}/financials · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752/financials?countryCode=LV"Omistus ja henkilöt
Osakkeenomistajat, tosiasialliset edunsaajat (UBO) ja tunnisteisiin perustuvat henkilö-yritys-osumat.
GET /people/check
/people/checkTarkista henkilön täsmäytetyt yritysroolit, kun julkiset tunnisteet mahdollistavat varman linkityksen.
Parametrit
birthDate(pakollinen)- Syntymäpäivä ISO-muodossa (VVVV-KK-PP)
limit(valinnainen)- Yritysten enimmäismäärä henkilöä kohti (1-100, oletus: 50)
name(pakollinen)- Henkilön koko nimi (vähintään 2 merkkiä)
Palauttaa täsmäytetyt roolit, kun julkiset henkilötunnisteet mahdollistavat varman linkityksen: tosiasiallinen edunsaaja, toimihenkilö, jäsen, osakkeenomistaja
GET /people/check · cURL
curl "https://datreal.com/api/public/v1/people/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"Vaatimustenmukaisuus
Pakotteiden, mustien listojen ja verovelvoitteiden tarkistukset LV-, LT-, EE-, FI- ja SE-alueilla.
GET /companies/{regcode}/compliance
/companies/{regcode}/complianceHae ALV-rekisteröinti, veroluokitus, verovelka ja vaatimustenmukaisuusindikaattorit yhdessä pienessä vastauksessa.
Parametrit
countryCode(valinnainen)- Suodata maakoodin mukaan (LV, LT, EE, FI, SE)
regcode(pakollinen)- Y-tunnus
Vastaus sisältää
- vatNumber / vatStatus / vatRegisteredAt - ALV-rekisteröinti
- taxRating / taxDebtAmount / hasTaxDebt - verotilanne
- isBlacklisted / isSuspendedActivity / hasMissingFinancialReports ja muut indikaattorit
- Pakotteiden tila (IsSanctioned: true/false)
GET /companies/{regcode}/compliance · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752/compliance?countryCode=LV"GET /companies/{regcode}/taxes
/companies/{regcode}/taxesHae yrityksen viime vuosien veromaksut, mukaan lukien tulovero, sosiaalivero, kokonaisvero ja työntekijämäärä.
Parametrit
countryCode(valinnainen)- Suodata maakoodin mukaan (LV, LT, EE, FI, SE)
regcode(pakollinen)- Y-tunnus
Vastaus sisältää
- taxPayments - enintään 3 uusinta vuotta, joilta verotietoja on saatavilla
- taxPayments[].totalTax / incomeTax / socialTax - vuosittaiset veromaksut
- taxPayments[].employees - ilmoitettu työntekijämäärä kyseisenä vuonna
GET /companies/{regcode}/taxes · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752/taxes?countryCode=LV"GET /companies/{regcode}/sanctions
/companies/{regcode}/sanctionsTarkista, onko yritys pakotelistalla ja hae yksityiskohtaiset tiedot.
Parametrit
countryCode(valinnainen)- Suodata maakoodin mukaan (LV, LT, EE, FI, SE)
regcode(pakollinen)- Y-tunnus
GET /companies/{regcode}/sanctions · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions?countryCode=LV"Seuranta
Aikaikkunoidut muutossyötteet - uudet rekisteröinnit ja muut lähes reaaliaikaiset signaalit.
GET /people/new-registrations
/people/new-registrationsHae täsmäytetyn henkilön uudet linkitetyt yritysroolit viimeisten N tunnin ajalta. Tarkoitettu tunnisteisiin perustuvaan seurantaan cron-ajossa.
Parametrit
birthDate(pakollinen)- Syntymäpäivä ISO-muodossa (VVVV-KK-PP)
hours(valinnainen)- Aikaikkuna tunteina (1-168, oletus: 24)
limit(valinnainen)- Palautettavien yritysten enimmäismäärä (1-1000, oletus: 100)
name(pakollinen)- Henkilön koko nimi (vähintään 2 merkkiä)
GET /people/new-registrations · cURL
curl "https://datreal.com/api/public/v1/people/new-registrations?name=Jānis%20Bērziņš&birthDate=1985-03-15&hours=24"Kiinteistöt
Hae katasterikohteita ja saa kohdekohtaiset tiedot kirjatuilla myynneillä ja arvioilla.
GET /real-estate/search
/real-estate/searchHae katasterikohteita osoitteella tai kiinteistötunnuksella tyyppi-, omistajatyypin, kunta-, pinta-ala-, arvo-, rakennusvuosi- ja kerrossuodattimilla.
Parametrit
bbox(valinnainen)- Rajaus: länsi,etelä,itä,pohjoinen WGS84-asteina
countryCode(valinnainen)- Maa, jonka kiinteistörekisteristä haetaan. Jätä pois hakeaksesi kaikista tuetuista maista.
hasBusiness(valinnainen)- Vain yritykseen liittyvät kohteet; ota käyttöön arvolla 1
hasListings(valinnainen)- Vain kohteet, joilla on aktiivinen ilmoitus; ota käyttöön arvolla 1
hasSales(valinnainen)- Vain kohteet, joilla on kirjattu kauppa; ota käyttöön arvolla 1
maxArea(valinnainen)- Maan/rakennuksen/tilojen enimmäispinta-ala m²
maxBuiltYear(valinnainen)- Rakennuksen/tilojen viimeisin rakennusvuosi
maxValue(valinnainen)- Kiinteistörekisteriarvon enimmäismäärä kohteen paikallisessa valuutassa
maxFloors(valinnainen)- Maanpäällisten kerrosten enimmäismäärä
maxSalePrice(valinnainen)- Kirjatun kauppahinnan enimmäismäärä tapahtuman paikallisessa valuutassa
minArea(valinnainen)- Maan/rakennuksen/tilojen vähimmäispinta-ala m²
minBuiltYear(valinnainen)- Rakennuksen/tilojen aikaisin rakennusvuosi
minValue(valinnainen)- Kiinteistörekisteriarvon vähimmäismäärä kohteen paikallisessa valuutassa
minFloors(valinnainen)- Maanpäällisten kerrosten vähimmäismäärä
minSalePrice(valinnainen)- Kirjatun kauppahinnan vähimmäismäärä tapahtuman paikallisessa valuutassa
municipality(valinnainen)- Kunnan nimi tai useita pilkuilla erotettuja nimiä
objectType(valinnainen)- Kiinteistökohteen tyyppi
ownerType(valinnainen)- Omistajan luokitus, ei omistajan henkilöllisyys
limit(valinnainen)- Tulosten enimmäismäärä (1–100, oletus: 20)
page(valinnainen)- Tulossivu (alkaen 1). Myöhempien sivujen hakuikkuna on rajattu.
q(valinnainen)- Osoiteteksti tai kiinteistön tunniste
GET /real-estate/search · cURL
curl "https://datreal.com/api/public/v1/real-estate/search?q=Br%C4%ABv%C4%ABbas%20iela&countryCode=LV&objectType=building&ownerType=legal_person&minBuiltYear=1900&minFloors=2&limit=5"GET /real-estate/{cadastralNumber}
/real-estate/{cadastralNumber}Katasteritiedot, kirjatut myynnit ja vertailukauppoihin perustuva arvio.
Parametrit
cadastralNumber(pakollinen)- Kiinteistön tai kiinteistörekisterin tunniste
countryCode(pakollinen)- Maa, johon tunniste kuuluu. Tunnisteet eivät ole maailmanlaajuisesti yksilöllisiä.
scheme(pakollinen)- Kiinteistöhaun palauttama tunnistejärjestelmä
GET /real-estate/{cadastralNumber} · cURL
curl "https://datreal.com/api/public/v1/real-estate/01000302015?countryCode=LV&scheme=LV_CADASTRAL_OBJECT"API-katsaus
Itsensä kuvaava juuri, joka luettelee kaikki päätepisteet ja niiden parametrit.
GET /
/API-päätepiste, joka palauttaa täydellisen dokumentaation JSON-muodossa.
GET / · cURL
curl "https://datreal.com/api/public/v1"Tekniset tiedot
- CORS
- Kaikki päätepisteet tukevat CORS:ia
*alkuperällä, mikä mahdollistaa suoran selainpääsyn API:in. - Pyyntörajat
- Pyyntörajoja sovelletaan väärinkäytön estämiseksi. Yrityksen päätepisteet: 20 pyyntöä/10s. Kiinteistöjen päätepisteet: 20 pyyntöä/10s. Henkilötarkistus: 20 pyyntöä/10s. Uudet rekisteröinnit: 10 pyyntöä/60s.
- Virhekoodit
400- Virheellinen pyyntö (puuttuvat tai virheelliset parametrit)404- apiDocs.error404429- Pyyntöraja ylitetty500- apiDocs.error500
LLM-asennusopas
Käytä tätä opasta AI-assistenttien ja kielimallien konfigurointiin API:n kanssa.
Kopioi LLM:lle
Kopioi tämä kehote ja liitä se LLM:ään (ChatGPT, Claude jne.) mahdollistaaksesi Baltian ja Pohjoismaiden yrityshaut Datreal.com API:n kautta.
Koodi
# Datreal.com API Integration Guide
You are integrating with the Datreal.com public API for Baltic and Nordic (LV, LT, EE, FI, SE) company and real-estate data. Here is everything you need to know:
## Base URLhttps://datreal.com/api/public/v1
## AuthenticationNo authentication required. The API is publicly accessible.
## Available Endpoints
### 1. Search CompaniesGET /companies/search?q={query}&countryCode={countryCode}&limit={limit}&page={page}- countryCode (optional): Country code to filter results (LV, LT, EE, FI, SE).- limit (optional): Maximum results (1-100); minimum 1; maximum 100; default 20- nace (optional): Filter by NACE code prefix (section letter or numeric code, e.g. J or 62). Can be used without q to browse companies by activity- page (optional): Result page number. Deep pages are bounded to the search result window.; minimum 1; default 1- q (optional): Search query (minimum 2 characters). Required unless nace is provided- Returns: Paginated matching companies with regcode, name, address, status, page and pageSize
### 2. Address AutofillGET /companies/autofill?q={query}&countryCode={countryCode}&limit={limit}- q (required): Company name or registration number, minimum 2 characters- countryCode (optional): Country code to filter (LV, LT, EE, FI, SE)- limit (optional): Results count, 1-50, default 10- Returns: Slim company rows with address and VAT number for forms
### 3. Get Company DetailsGET /companies/{regcode}?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: Full company details including financials, tax rating, VAT status, sanctions status
### 4. Get Company FinancialsGET /companies/{regcode}/financials?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: Yearly financial reports with revenue, profit, assets, equity and employees, plus totalYears
### 5. Get Shareholders & Beneficial OwnersGET /companies/{regcode}/shareholders?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: available shareholders[], beneficialOwners[], totalShareholders, totalBeneficialOwners where registries publish ownership data
### 6. Get Company ComplianceGET /companies/{regcode}/compliance?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: VAT registration, tax rating, tax debt, sanctions signals and compliance flags
### 7. Get Company TaxesGET /companies/{regcode}/taxes?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: Up to 3 recent yearly tax payment rows with totalTax, incomeTax, socialTax, and employees
### 8. Check SanctionsGET /companies/{regcode}/sanctions?countryCode={countryCode}- countryCode (optional): Country the registration number belongs to (LV, LT, EE, FI, SE). Omit only when the code is unique across supported company registries.- regcode (required): Company registration number- Returns: Sanctions status and list of any active sanctions
### 9. Check PersonGET /people/check?name={name}&birthDate={birthDate}&limit={limit}- birthDate (required): Birth date in ISO format (YYYY-MM-DD)- limit (optional): Maximum number of companies to return per person; minimum 1; maximum 100; default 50- name (required): Full name of the person (minimum 2 characters)- Returns: Matched company roles where public person identifiers allow confident linking (board member, shareholder, beneficial owner, etc.)
### 10. New RegistrationsGET /people/new-registrations?name={name}&birthDate={birthDate}&hours={hours}&limit={limit}- birthDate (required): Birth date in ISO format (YYYY-MM-DD)- hours (optional): Time window in hours to check for new registrations; minimum 1; maximum 168; default 24- limit (optional): Maximum number of companies to return; minimum 1; maximum 100; default 100- name (required): Full name of the person (minimum 2 characters)- Returns: Newly linked company roles for matched people within the time window
### 11. Search Real EstateGET /real-estate/search?q={query}&countryCode={countryCode}&bbox={bbox}&hasBusiness={hasBusiness}&hasListings={hasListings}&hasSales={hasSales}&maxArea={maxArea}&maxBuiltYear={maxBuiltYear}&maxValue={maxValue}&maxFloors={maxFloors}&maxSalePrice={maxSalePrice}&minArea={minArea}&minBuiltYear={minBuiltYear}&minValue={minValue}&minFloors={minFloors}&minSalePrice={minSalePrice}&municipality={municipality}&objectType={objectType}&ownerType={ownerType}&limit={limit}&page={page}- bbox (optional): Viewport bounding box as west,south,east,north in WGS84 degrees- countryCode (optional): Country whose cadastre to search (LV, LT, EE, FI, SE). Omit to search all supported cadastres..- hasBusiness (optional): Only objects linked to a business; use 1 to enable- hasListings (optional): Only objects with an active listing; use 1 to enable- hasSales (optional): Only objects with a recorded sale; use 1 to enable- maxArea (optional): Maximum land/building/premises area in m²- maxBuiltYear (optional): Maximum building/premises construction year- maxValue (optional): Maximum cadastral value in the object's local currency- maxFloors (optional): Maximum floors above ground- maxSalePrice (optional): Maximum recorded sale price in the transaction's local currency- minArea (optional): Minimum land/building/premises area in m²- minBuiltYear (optional): Minimum building/premises construction year- minValue (optional): Minimum cadastral value in the object's local currency- minFloors (optional): Minimum floors above ground- minSalePrice (optional): Minimum recorded sale price in the transaction's local currency- municipality (optional): Municipality name, or several comma-separated- objectType (optional): Property object type- ownerType (optional): Effective owner classification (not owner identity)- limit (optional): Maximum number of results; minimum 1; maximum 100; default 20- page (optional): Result page number. Deep pages are bounded to the search result window.; minimum 1; default 1- q (optional): Address text or cadastral/property identifier- Returns: Matching cadastre objects with address, municipality, area, value, and coordinates
### 12. Get Property DetailsGET /real-estate/{cadastralNumber}?countryCode={countryCode}&scheme={identifierScheme}- cadastralNumber (required): Cadastral/property identifier- countryCode (required): Country the identifier belongs to (LV, LT, EE, FI, SE). Required because identifiers are not globally unique across supported cadastres.- scheme (required): Identifier scheme returned by real-estate search (for example LV_CADASTRAL_OBJECT)- Returns: Cadastre facts, matched transaction history, and value estimate where available
## Rate Limits- Company endpoints: 20 requests per 10 seconds- Real-estate endpoints: 20 requests per 10 seconds- Person check: 20 requests per 10 seconds- New registrations: 10 requests per 60 seconds
## Response FormatAll responses are JSON. Successful responses return 200 OK.
## Error Codes- 400: Invalid request (missing or invalid parameters)- 404: Company or person not found- 429: Rate limit exceeded- 500: Server error
## CORSAll endpoints support CORS with * origin, allowing direct browser access.
## CachingResponses are cached for 30 minutes with stale-while-revalidate of 1 hour.
## Example UsageTo search for a company: GET https://datreal.com/api/public/v1/companies/search?q=example&limit=10To get company details: GET https://datreal.com/api/public/v1/companies/40003245752?countryCode=LVTo check sanctions: GET https://datreal.com/api/public/v1/companies/40003245752/sanctions?countryCode=LVTo search real estate: GET https://datreal.com/api/public/v1/real-estate/search?countryCode=LV&municipality=Rīga&objectType=land&ownerType=legal_person&minBuiltYear=1900MCP server
Yhdistä Claude Desktop, Claude Code tai mikä tahansa MCP-yhteensopiva AI-asiakas suoraan yritystietoihimme Model Context Protocol (MCP) -protokollalla. API-avaimia ei tarvita.
Asennus Claude Codelle
Suorita tämä komento terminaalissa lisätäksesi MCP-palvelimen Claude Codeen:
Koodi
claude mcp add datreal --transport http https://datreal.com/api/mcpAsennus Claude Desktopille
Lisää tämä Claude Desktop -konfiguraatiotiedostoosi:
Koodi
{ "mcpServers": { "datreal": { "type": "url", "url": "https://datreal.com/api/mcp" } }}- macOS
~/Library/Application Support/Claude/claude_desktop_config.json- Windows
%APPDATA%\Claude\claude_desktop_config.json
MCP-palvelimen päätepiste
- Palvelimen URL (Streamable HTTP)
https://datreal.com/api/mcp
Käytettävissä olevat työkalut
search_companies- Etsi yrityksiä nimellä, osoitteella tai Y-tunnuksella (LV, LT, EE, FI, SE).
get_company_details- Hae yrityksen täydelliset tiedot: nimi, osoite, yritysmuoto, ALV, veroluokitus, TOL-koodi, pakotteet, toimihenkilöt, toimialat, maksukyvyttömyys- ja selvitystilamenettelyt, toimipaikat, 3 viimeisimmän vuoden verot ja uusimmat taloustiedot.
get_company_financials- Hae monivuotiset tilinpäätökset: liikevaihto, tulos, varat, oma pääoma, henkilöstö, velat ja kassavirta.
get_shareholders- Julkaistut osakkeenomistajat ja tosiasialliset edunsaajat (UBO:t) omistusosuuksineen, osakemäärineen ja vastapuolen rekisterikoodeineen.
get_company_compliance- Hae ALV-numero, veroluokitus, pakotteiden tila, verovelka, mustan listan tila ja kaikki vaatimustenmukaisuusindikaattorit.
search_real_estate- Hae katasterikohteita osoitteella tai kiinteistötunnuksella tyyppi-, omistajatyypin, kunta-, pinta-ala-, arvo-, rakennusvuosi- ja kerrossuodattimilla.
get_real_estate_details- Katasteritiedot, kirjatut myynnit ja vertailukauppoihin perustuva arvio.
check_company_sanctions- Tarkista, onko yritys pakotelistalla, ja hae vastaavat merkinnät.
get_company_taxes- Hae verot vuosittain: tulovero, sosiaalivero, yhteensä ja henkilöstö.
check_person- Etsi henkilön yritysroolit koko nimen ja syntymäpäivän perusteella.
get_person_new_registrations- Hae henkilön yritysroolit, jotka on linkitetty viimeisten N tunnin aikana, seurantaa varten.
Käyttöesimerkit
Yhdistämisen jälkeen voit kysyä Claudelta esimerkiksi:
- "Mikä on SIA Maxima Latvija liikevaihto?"
- "Näytä yrityksen 40003245752 taloushistoria"
- "Onko tämä yritys pakotelistalla? Tarkista Y-tunnus 40003245752"
- "Etsi virolaisia yrityksiä nimellä Bolt"