Avalik API ettevõtte info, sanktsioonide kontrolli, isiku seire ja kinnisvaraotsingu jaoks Lätis, Leedus, Eestis, Soomes ja Rootsis.
Kiirstart
API on kättesaadav ilma registreerimise või autentimiseta. Kõik otspunktid toetavad CORS-i, seega saab neid kasutada otse brauserist.
- Baas-URL
https://datreal.com/api/public/v1
Näide
Kiirstart · cURL
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&countryCode=EE&limit=5"Kasutusjuhud
Lõpp-punktid rühmitatud kasutusjuhtude kaupa, et saaksid valida õige, ilma kogu viidet lugemata.
Otsing ja päring
Otsi ja hangi täielikud ettevõtteprofiilid, aadressi automaatlõpetus ja põhilised ettevõtteandmed.
Omandisuhe ja isikud
Aktsionärid, tegelikud kasusaajad (UBO) ja identifikaatoripõhised isiku-ettevõtte vasted.
Vastavus
Sanktsioonide, mustade nimekirjade ja maksuvastavuse kontrollid LV, LT, EE, FI, SE lõikes.
Jälgimine
Ajavahemikega muudatuste vood - uued registreerimised ja muud peaaegu reaalajas signaalid.
Kinnisvara
Otsi katastriobjekte ja saa objektipõhist teavet registreeritud müükide ja väärtushinnangutega.
API avastamine
Iseennast kirjeldav juurkataloog, mis loetleb iga lõpp-punkti ja selle parameetrid.
Otspunktid
Otsing ja päring
Otsi ja hangi täielikud ettevõtteprofiilid, aadressi automaatlõpetus ja põhilised ettevõtteandmed.
GET /companies/search
/companies/searchOtsi ettevõtteid nime, aadressi või registrikoodi järgi.
Parameetrid
countryCode(valikuline)- Filtreeri riigikoodi järgi (LV, LT, EE, FI, SE)
limit(valikuline)- Tulemuste arv (1-100, vaikimisi: 20)
nace(valikuline)- NACE koodi algus (nt J või 62). Võib asendada q.
page(valikuline)- Tulemuste leht (alates 1). Hilisemate lehtede otsinguaken on piiratud.
q(valikuline)- Otsingupäring (vähemalt 2 märki). Nõutav, kui nace puudub.
GET /companies/search · cURL
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&countryCode=EE&limit=5"GET /companies/{regcode}
/companies/{regcode}Hangi detailne info konkreetse ettevõtte kohta, sealhulgas sanktsioonide staatus.
Parameetrid
countryCode(valikuline)- Filtreeri riigikoodi järgi (LV, LT, EE, FI, SE)
regcode(kohustuslik)- Ettevõtte registrikood
Vastus sisaldab
- Põhiinfo (nimi, aadress, õiguslik vorm)
- Registreerimise ja lõpetamise kuupäevad
- Maksureiting ja käibemaksu staatus
- NACE kood ja kirjeldus
- Finantsaruanded
- Sanktsioonide staatus (IsSanctioned: true/false)
GET /companies/{regcode} · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752?countryCode=LV"GET /companies/autofill
/companies/autofillHangi ettevõtte aadress ja KMKR andmed vormide automaattäitmiseks.
Parameetrid
countryCode(valikuline)- Filtreeri riigikoodi järgi (LV, LT, EE, FI, SE)
limit(valikuline)- Maksimaalselt tulemusi (1-50, vaikimisi: 10)
q(kohustuslik)- Ettevõtte nimi või registrikood (min. 2 tähemärki)
Vastus sisaldab
- Registrikood
- Ettevõtte nimi
- Täielik juriidiline aadress
- KMKR number (kui on registreeritud)
- Riigikood (LV, LT, 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}/financialsHangi ettevõtte majandusaasta finantsaruanded. Kui aruandeid pole, tagastab 404.
Parameetrid
countryCode(valikuline)- Filtreeri riigikoodi järgi (LV, LT, EE, FI, SE)
regcode(kohustuslik)- Ettevõtte registrikood
Vastus sisaldab
- reports - üks kirje majandusaasta kohta: tulud, kasum, varad, omakapital, töötajad, rahavoog
- totalYears - tagastatud majandusaastate arv
GET /companies/{regcode}/financials · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752/financials?countryCode=LV"Omandisuhe ja isikud
Aktsionärid, tegelikud kasusaajad (UBO) ja identifikaatoripõhised isiku-ettevõtte vasted.
GET /people/check
/people/checkKontrolli sobitatud ettevõtterolle isiku kohta seal, kus avalikud identifikaatorid lubavad kindlat sidumist.
Parameetrid
birthDate(kohustuslik)- Sünnikuupäev ISO formaadis (AAAA-KK-PP)
limit(valikuline)- Maksimaalne ettevõtete arv isiku kohta (1-100, vaikimisi: 50)
name(kohustuslik)- Isiku täisnimi (min. 2 tähemärki)
Tagastab sobitatud rollid seal, kus avalikud isikuidentifikaatorid lubavad kindlat sidumist: tegelik kasusaaja, ametnik, liige, omanik, mikroettevõte
GET /people/check · cURL
curl "https://datreal.com/api/public/v1/people/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"Vastavus
Sanktsioonide, mustade nimekirjade ja maksuvastavuse kontrollid LV, LT, EE, FI, SE lõikes.
GET /companies/{regcode}/compliance
/companies/{regcode}/complianceHangi KMKR registreering, maksureiting, maksuvõlg ja vastavusnäitajad ühes väikeses vastuses.
Parameetrid
countryCode(valikuline)- Filtreeri riigikoodi järgi (LV, LT, EE, FI, SE)
regcode(kohustuslik)- Ettevõtte registrikood
Vastus sisaldab
- vatNumber / vatStatus / vatRegisteredAt - KMKR registreering
- taxRating / taxDebtAmount / hasTaxDebt - maksuseis
- isBlacklisted / isSuspendedActivity / hasMissingFinancialReports ja muud näitajad
- Sanktsioonide staatus (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}/taxesHangi ettevõtte viimaste aastate maksumaksed, sealhulgas tulumaks, sotsiaalmaks, kogumaks ja töötajate arv.
Parameetrid
countryCode(valikuline)- Filtreeri riigikoodi järgi (LV, LT, EE, FI, SE)
regcode(kohustuslik)- Ettevõtte registrikood
Vastus sisaldab
- taxPayments - kuni 3 viimast aastat, mille kohta on maksuandmed
- taxPayments[].totalTax / incomeTax / socialTax - aasta maksumaksete summad
- taxPayments[].employees - esitatud töötajate arv aastal
GET /companies/{regcode}/taxes · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752/taxes?countryCode=LV"GET /companies/{regcode}/sanctions
/companies/{regcode}/sanctionsKontrolli, kas ettevõte on sanktsioonide nimekirjas ja saa detailset infot.
Parameetrid
countryCode(valikuline)- Filtreeri riigikoodi järgi (LV, LT, EE, FI, SE)
regcode(kohustuslik)- Ettevõtte registrikood
GET /companies/{regcode}/sanctions · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions?countryCode=LV"Jälgimine
Ajavahemikega muudatuste vood - uued registreerimised ja muud peaaegu reaalajas signaalid.
GET /people/new-registrations
/people/new-registrationsHangi uued seotud ettevõtterollid sobitatud isikule viimase N tunni jooksul. Kasutatakse identifikaatoripõhiseks jälgimiseks cron tööde kaudu.
Parameetrid
birthDate(kohustuslik)- Sünnikuupäev ISO formaadis (AAAA-KK-PP)
hours(valikuline)- Ajavahemik tundides (1-168, vaikimisi: 24)
limit(valikuline)- Maksimaalne ettevõtete arv tagastamiseks (1-1000, vaikimisi: 100)
name(kohustuslik)- Isiku täisnimi (min. 2 tähemärki)
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"Kinnisvara
Otsi katastriobjekte ja saa objektipõhist teavet registreeritud müükide ja väärtushinnangutega.
GET /real-estate/search
/real-estate/searchOtsi katastriobjekte aadressi või katastrinumbri järgi tüübi, omaniku tüübi, omavalitsuse, pindala, väärtuse, ehitusaasta ja korruste filtritega.
Parameetrid
bbox(valikuline)- Piirdekast: lääs,lõuna,ida,põhi WGS84 kraadides
countryCode(valikuline)- Riik, mille katastrist otsida. Jäta välja, et otsida kõigist toetatud riikidest.
hasBusiness(valikuline)- Ainult ettevõttega seotud objektid; lubamiseks kasuta 1
hasListings(valikuline)- Ainult aktiivse kuulutusega objektid; lubamiseks kasuta 1
hasSales(valikuline)- Ainult registreeritud müügiga objektid; lubamiseks kasuta 1
maxArea(valikuline)- Maksimaalne maa/hoone/ruumide pindala m²
maxBuiltYear(valikuline)- Maksimaalne hoone/ruumide ehitusaasta
maxValue(valikuline)- Maksimaalne katastriväärtus objekti kohalikus valuutas
maxFloors(valikuline)- Maksimaalne maapealsete korruste arv
maxSalePrice(valikuline)- Maksimaalne registreeritud müügihind tehingu kohalikus valuutas
minArea(valikuline)- Minimaalne maa/hoone/ruumide pindala m²
minBuiltYear(valikuline)- Minimaalne hoone/ruumide ehitusaasta
minValue(valikuline)- Minimaalne katastriväärtus objekti kohalikus valuutas
minFloors(valikuline)- Minimaalne maapealsete korruste arv
minSalePrice(valikuline)- Minimaalne registreeritud müügihind tehingu kohalikus valuutas
municipality(valikuline)- Omavalitsuse nimi või mitu komadega eraldatud nime
objectType(valikuline)- Kinnisvaraobjekti liik
ownerType(valikuline)- Omaniku liigitus, mitte omaniku identiteet
limit(valikuline)- Maksimaalne tulemuste arv (1–100, vaikimisi: 20)
page(valikuline)- Tulemuste leht (alates 1). Hilisemate lehtede otsinguaken on piiratud.
q(valikuline)- Aadressitekst või katastri-/kinnisvaraidentifikaator
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}Katastriandmed, registreeritud müügid ja võrreldavate tehingute väärtushinnang.
Parameetrid
cadastralNumber(kohustuslik)- Katastri- või kinnisvaraidentifikaator
countryCode(kohustuslik)- Riik, kuhu identifikaator kuulub. Identifikaatorid pole ülemaailmselt kordumatud.
scheme(kohustuslik)- Kinnisvaraotsingu tagastatud identifikaatoriskeem
GET /real-estate/{cadastralNumber} · cURL
curl "https://datreal.com/api/public/v1/real-estate/01000302015?countryCode=LV&scheme=LV_CADASTRAL_OBJECT"API avastamine
Iseennast kirjeldav juurkataloog, mis loetleb iga lõpp-punkti ja selle parameetrid.
GET /
/API avastamise otspunkt, mis tagastab täieliku dokumentatsiooni JSON formaadis.
GET / · cURL
curl "https://datreal.com/api/public/v1"Tehnilised detailid
- CORS
- Kõik otspunktid toetavad CORS-i
*päritoluga, võimaldades otsest brauseri ligipääsu API-le. - Päringute limiidid
- Limiidid on rakendatud kuritarvitamise vältimiseks. Ettevõtte otspunktid: 20 päringut/10s. Kinnisvara otspunktid: 20 päringut/10s. Isiku kontroll: 20 päringut/10s. Uued registreerimised: 10 päringut/60s.
- Veakoodid
400- Vigane päring (puuduvad või vigased parameetrid)404- apiDocs.error404429- Päringute limiit ületatud500- apiDocs.error500
LLM setup juhend
Kasuta seda juhendit AI assistentide seadistamiseks Datreal.com API-ga töötamiseks.
Kopeeri LLM jaoks
Kopeeri see viip ja sisesta see oma LLM-i (ChatGPT, Claude, jne), et võimaldada Balti ja Põhjamaade ettevõtete otsingut.
Kood
# 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
Ühendage Claude Desktop, Claude Code või mis tahes MCP-ühilduv AI klient otse meie ettevõtete andmetega, kasutades Model Context Protocol (MCP). API võtmeid ei ole vaja.
Seadistamine Claude Code jaoks
Käivitage see käsk terminalis, et lisada MCP server Claude Code'i:
Kood
claude mcp add datreal --transport http https://datreal.com/api/mcpSeadistamine Claude Desktop jaoks
Lisage see oma Claude Desktopi konfiguratsioonifaili:
Kood
{ "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 serveri otspunkt
- Serveri URL (Streamable HTTP)
https://datreal.com/api/mcp
Saadaolevad tööriistad
search_companies- Otsige ettevõtteid nime, aadressi või registrikoodi järgi LV, LT, EE, FI, SE.
get_company_details- Hankige ettevõtte täisinfo: nimi, aadress, õiguslik vorm, KMKR, maksureiting, NACE kood, sanktsioonid, ametnikud, tegevusalad, maksejõuetus- ja likvideerimismenetlused, struktuuriüksused, viimase 3 aasta maksumaksed ja viimased finantsandmed.
get_company_financials- Hankige mitmeaastased finantsaruanded: tulud, kasum, varad, omakapital, töötajad, kohustised ja rahavoog.
get_shareholders- Avaldatud aktsionärid ja tegelikud kasusaajad (UBO-d) koos omandiprotsentide, aktsiate arvu ja vastaspoole registrikoodidega.
get_company_compliance- Hankige KMKR number, maksureiting, sanktsioonide staatus, maksuvõlg, musta nimekirja staatus ja kõik vastavusnäitajad.
search_real_estate- Otsi katastriobjekte aadressi või katastrinumbri järgi tüübi, omaniku tüübi, omavalitsuse, pindala, väärtuse, ehitusaasta ja korruste filtritega.
get_real_estate_details- Katastriandmed, registreeritud müügid ja võrreldavate tehingute väärtushinnang.
check_company_sanctions- Kontrolli, kas ettevõte on sanktsioonide nimekirjas, ja hangi vastavad kirjed.
get_company_taxes- Hangi maksumaksed aastate kaupa: tulumaks, sotsiaalmaks, kokku ja töötajad.
check_person- Leia isiku rollid ettevõtetes täisnime ja sünnikuupäeva järgi.
get_person_new_registrations- Hangi isiku rollid ettevõtetes, mis lisandusid viimase N tunni jooksul, jälgimiseks.
Kasutusnäited
Pärast ühendamist saate Claude'ile esitada küsimusi, näiteks:
- "Millised on SIA Maxima Latvija tulud?"
- "Näita ettevõtte 40003245752 finantsajalugu"
- "Kas see ettevõte on sanktsioonide all? Kontrolli registrikoodi 40003245752"
- "Leia Eesti ettevõtteid nimega Bolt"