Publisks API uzņēmumu informācijai, sankciju pārbaudēm, personu uzraudzībai un nekustamo īpašumu uzziņām Latvijā, Lietuvā, Igaunijā, Somijā un Zviedrijā.
Ātrais starts
API ir pieejams bez reģistrācijas un autentifikācijas. Visi galapunkti atbalsta CORS, tāpēc tos var izmantot tieši no pārlūka.
- Bāzes URL
https://datreal.com/api/public/v1
Piemērs
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&countryCode=EE&limit=5"Lietošanas gadījumi
Endpoint-i sagrupēti pēc lietošanas gadījuma, lai vari izvēlēties pareizo bez visas dokumentācijas lasīšanas.
Meklēšana un izvilkšana
Uzņēmumu meklēšana, pilnais profils, adreses autocompletē un pamatdati.
Īpašnieki un personas
Akcionāri, patiesie labuma guvēji (UBO) un ar identifikatoriem pamatotas personu saiknes ar uzņēmumiem.
Atbilstība
Sankciju, melno sarakstu un nodokļu atbilstības pārbaudes LV, LT, EE, FI, SE.
Monitorings
Laika logu izmaiņu plūsmas - jaunas reģistrācijas un citi gandrīz reāllaika signāli.
Nekustamie īpašumi
Meklējiet kadastra objektus un iegūstiet informāciju par īpašumu ar reģistrētiem pārdošanas darījumiem un novērtējumu.
Galapunkti
Meklēšana un izvilkšana
Uzņēmumu meklēšana, pilnais profils, adreses autocompletē un pamatdati.
GET /companies/search
/companies/searchMeklē uzņēmumus pēc nosaukuma, adreses vai reģistrācijas numura.
Parametri
countryCode(neobligāts)- Filtrēt pēc valsts koda (LV, LT, EE, FI, SE)
limit(neobligāts)- Rezultātu skaits (1–100, noklusējums: 20)
nace(neobligāts)- NACE koda sākums (piemēram, J vai 62). Var aizstāt q.
page(neobligāts)- Rezultātu lapa (sākas ar 1). Dziļām lapām ir ierobežots meklēšanas logs.
q(neobligāts)- Meklēšanas vaicājums (vismaz 2 rakstzīmes). Obligāts, ja nav norādīts nace.
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&countryCode=EE&limit=5"GET /companies/{regcode}
/companies/{regcode}Iegūst detalizētu informāciju par konkrētu uzņēmumu, ieskaitot sankciju statusu.
Parametri
countryCode(neobligāts)- Filtrēt pēc valsts koda (LV, LT, EE, FI, SE)
regcode(obligāts)- Uzņēmuma reģistrācijas numurs
Atbilde ietver
- Pamatinformāciju (nosaukums, adrese, juridiskā forma)
- Reģistrācijas un slēgšanas datumus
- Nodokļu maksātāja reitingu un PVN statusu
- NACE kodu un aprakstu
- Finanšu pārskati
- Sankciju statusu (IsSanctioned: True/false)
curl "https://datreal.com/api/public/v1/companies/40003245752?countryCode=LV"GET /companies/autofill
/companies/autofillIegūstiet uzņēmuma adresi un PVN datus formu aizpildīšanai. Optimizēts adrešu automātiskai aizpildīšanai hobijprojektos.
Parametri
countryCode(neobligāts)- Filtrēt pēc valsts koda (LV, LT, EE, FI, SE)
limit(neobligāts)- Maks. rezultāti (1-50, noklusējums: 10)
q(obligāts)- Uzņēmuma nosaukums vai reģistrācijas numurs (min. 2 rakstzīmes)
Atbilde ietver
- Reģistrācijas numurs (regcode)
- Uzņēmuma nosaukums
- Pilna juridiskā adrese
- PVN numurs (ja reģistrēts)
- Valsts kods (LV, LT, u.c.)
curl "https://datreal.com/api/public/v1/companies/autofill?q=maxima&countryCode=LV&limit=5"GET /companies/{regcode}/financials
/companies/{regcode}/financialsIegūt uzņēmuma gada finanšu pārskatus. Ja pārskatu nav, atgriež 404.
Parametri
countryCode(neobligāts)- Filtrēt pēc valsts koda (LV, LT, EE, FI, SE)
regcode(obligāts)- Uzņēmuma reģistrācijas numurs
Atbilde ietver
- reports - viens ieraksts katram finanšu gadam: ieņēmumi, peļņa, aktīvi, kapitāls, darbinieki, naudas plūsma
- totalYears - atgriezto finanšu gadu skaits
curl "https://datreal.com/api/public/v1/companies/40003245752/financials?countryCode=LV"Īpašnieki un personas
Akcionāri, patiesie labuma guvēji (UBO) un ar identifikatoriem pamatotas personu saiknes ar uzņēmumiem.
GET /people/check
/people/checkPārbauda saskaņotās uzņēmumu lomas personai tur, kur publiskie identifikatori ļauj drošu sasaisti.
Parametri
birthDate(obligāts)- Dzimšanas datums ISO formātā (GGGG-MM-DD)
limit(neobligāts)- Maks. uzņēmumu skaits personai (1-100, noklusējums: 50)
name(obligāts)- Personas pilns vārds (min. 2 rakstzīmes)
Atgriež saskaņotās lomas tur, kur publiskie personu identifikatori ļauj drošu sasaisti: patiesais labuma guvējs, valdes loceklis, biedrs, akcionārs, mikrouzņēmums
curl "https://datreal.com/api/public/v1/people/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"Atbilstība
Sankciju, melno sarakstu un nodokļu atbilstības pārbaudes LV, LT, EE, FI, SE.
GET /companies/{regcode}/compliance
/companies/{regcode}/complianceIegūt PVN reģistrāciju, nodokļu reitingu, nodokļu parādu un atbilstības rādītājus vienā nelielā atbildē.
Parametri
countryCode(neobligāts)- Filtrēt pēc valsts koda (LV, LT, EE, FI, SE)
regcode(obligāts)- Uzņēmuma reģistrācijas numurs
Atbilde ietver
- vatNumber / vatStatus / vatRegisteredAt - PVN reģistrācija
- taxRating / taxDebtAmount / hasTaxDebt - nodokļu stāvoklis
- isBlacklisted / isSuspendedActivity / hasMissingFinancialReports un citi rādītāji
- Sankciju statusu (IsSanctioned: True/false)
curl "https://datreal.com/api/public/v1/companies/40003245752/compliance?countryCode=LV"GET /companies/{regcode}/taxes
/companies/{regcode}/taxesIegūst uzņēmuma pēdējo gadu nodokļu maksājumus, tostarp ienākuma nodokli, sociālo nodokli, kopējo nodokli un darbinieku skaitu.
Parametri
countryCode(neobligāts)- Filtrēt pēc valsts koda (LV, LT, EE, FI, SE)
regcode(obligāts)- Uzņēmuma reģistrācijas numurs
Atbilde ietver
- taxPayments - līdz 3 jaunākajiem gadiem ar pieejamiem nodokļu datiem
- taxPayments[].totalTax / incomeTax / socialTax - gada nodokļu maksājumu summas
- taxPayments[].employees - deklarētais darbinieku skaits attiecīgajā gadā
curl "https://datreal.com/api/public/v1/companies/40003245752/taxes?countryCode=LV"GET /companies/{regcode}/sanctions
/companies/{regcode}/sanctionsPārbauda, vai uzņēmums ir sankciju sarakstos, un atgriež detalizētu informāciju.
Parametri
countryCode(neobligāts)- Filtrēt pēc valsts koda (LV, LT, EE, FI, SE)
regcode(obligāts)- Uzņēmuma reģistrācijas numurs
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions?countryCode=LV"Monitorings
Laika logu izmaiņu plūsmas - jaunas reģistrācijas un citi gandrīz reāllaika signāli.
GET /people/new-registrations
/people/new-registrationsIegūst jaunas sasaistītās uzņēmumu lomas saskaņotai personai pēdējās N stundās. Izmanto ar identifikatoriem pamatotai uzraudzībai ar cron darbiem.
Parametri
birthDate(obligāts)- Dzimšanas datums ISO formātā (GGGG-MM-DD)
hours(neobligāts)- Laika logs stundās (1-168, noklusējums: 24)
limit(neobligāts)- Maks. uzņēmumu skaits (1-1000, noklusējums: 100)
name(obligāts)- Personas pilns vārds (min. 2 rakstzīmes)
curl "https://datreal.com/api/public/v1/people/new-registrations?name=Jānis%20Bērziņš&birthDate=1985-03-15&hours=24"Nekustamie īpašumi
Meklējiet kadastra objektus un iegūstiet informāciju par īpašumu ar reģistrētiem pārdošanas darījumiem un novērtējumu.
GET /real-estate/search
/real-estate/searchMeklējiet kadastra objektus pēc adreses vai kadastra numura ar veida, īpašnieka veida, novada, platības, vērtības, būvniecības gada un stāvu filtriem.
Parametri
bbox(neobligāts)- Aptverošais taisnstūris: rietumi,dienvidi,austrumi,ziemeļi WGS84 grādos
countryCode(neobligāts)- Valsts, kuras kadastrā meklēt. Izlaidiet, lai meklētu visās atbalstītajās valstīs.
hasBusiness(neobligāts)- Tikai objekti, kas saistīti ar uzņēmumu; ieslēgšanai izmantojiet 1
hasListings(neobligāts)- Tikai objekti ar aktīvu sludinājumu; ieslēgšanai izmantojiet 1
hasSales(neobligāts)- Tikai objekti ar reģistrētu pārdošanu; ieslēgšanai izmantojiet 1
maxArea(neobligāts)- Maksimālā zemes/ēkas/telpu platība m²
maxBuiltYear(neobligāts)- Jaunākais ēkas/telpu būvniecības gads
maxValue(neobligāts)- Maksimālā kadastrālā vērtība objekta vietējā valūtā
maxFloors(neobligāts)- Maksimālais virszemes stāvu skaits
maxSalePrice(neobligāts)- Maksimālā reģistrētā pārdošanas cena darījuma vietējā valūtā
minArea(neobligāts)- Minimālā zemes/ēkas/telpu platība m²
minBuiltYear(neobligāts)- Senākais ēkas/telpu būvniecības gads
minValue(neobligāts)- Minimālā kadastrālā vērtība objekta vietējā valūtā
minFloors(neobligāts)- Minimālais virszemes stāvu skaits
minSalePrice(neobligāts)- Minimālā reģistrētā pārdošanas cena darījuma vietējā valūtā
municipality(neobligāts)- Pašvaldības nosaukums vai vairāki nosaukumi, atdalīti ar komatiem
objectType(neobligāts)- Nekustamā īpašuma objekta veids
ownerType(neobligāts)- Īpašnieka klasifikācija, nevis īpašnieka identitāte
limit(neobligāts)- Maksimālais rezultātu skaits (1–100, noklusējums: 20)
page(neobligāts)- Rezultātu lapa (sākas ar 1). Dziļām lapām ir ierobežots meklēšanas logs.
q(neobligāts)- Adreses teksts vai kadastra/īpašuma identifikators
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}Kadastra dati, reģistrēti pārdošanas darījumi un salīdzināmo darījumu novērtējums vienam īpašumam.
Parametri
cadastralNumber(obligāts)- Kadastra vai īpašuma identifikators
countryCode(obligāts)- Valsts, kurai pieder identifikators. Identifikatori nav globāli unikāli.
scheme(obligāts)- Nekustamo īpašumu meklēšanas atgrieztā identifikatoru sistēma
curl "https://datreal.com/api/public/v1/real-estate/01000302015?countryCode=LV&scheme=LV_CADASTRAL_OBJECT"API atklāšana
Pašatkalsmes sakne, kas uzskaita visus endpoint-us un to parametrus.
GET /
/API atklāšanas galapunkts, kas atgriež pilnu dokumentāciju JSON formātā.
curl "https://datreal.com/api/public/v1"Tehniskie detaļi
- CORS
- Visi galapunkti atbalsta CORS ar
*izcelsmi, ļaujot API izmantot tieši no pārlūka. - Vaicājumu limiti
- Pieprasījumu ierobežojumi novērš ļaunprātīgu izmantošanu. Uzņēmumu galapunkti: 20 pieprasījumi/10s. Nekustamo īpašumu galapunkti: 20 pieprasījumi/10s. Personu pārbaude: 20 pieprasījumi/10s. Jaunas reģistrācijas: 10 pieprasījumi/60s.
- Kļūdu kodi
400- Nekorekts pieprasījums (trūkst parametru vai tie ir nederīgi)404- apiDocs.error404429- Pieprasījumu ierobežojums pārsniegts500- apiDocs.error500
LLM iestatīšanas ceļvedis
Izmantojiet šo ceļvedi, lai konfigurētu AI asistentus un valodas modeļus darbam ar Datreal.com API. Zemāk esošais teksts satur visu informāciju, kas LLM nepieciešama, lai pareizi saprastu un izmantotu API.
Kopēt priekš LLM
Nokopējiet šo tekstu un ielīmējiet to savā LLM (ChatGPT, Claude u.c.), lai tas varētu izmantot Datreal.com API Baltijas un Ziemeļvalstu uzņēmumu meklēšanai.
# 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 serveris
Savienojiet Claude Desktop, Claude Code vai jebkuru MCP-saderīgu AI klientu tieši ar mūsu uzņēmumu datiem, izmantojot Model Context Protocol (MCP). Nav nepieciešamas API atslēgas.
Iestatīšana Claude Code
Palaidiet šo komandu terminālī, lai pievienotu MCP serveri Claude Code:
claude mcp add datreal --transport http https://datreal.com/api/mcpIestatīšana Claude Desktop
Pievienojiet šo sava Claude Desktop konfigurācijas failam:
{ "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 servera galapunkts
- Servera URL (Streamable HTTP)
https://datreal.com/api/mcp
Pieejamie rīki
search_companies- Meklēt uzņēmumus pēc nosaukuma, adreses vai reģ. numura LV, LT, EE, FI, SE.
get_company_details- Iegūt pilnu uzņēmuma info: nosaukums, adrese, juridiskā forma, PVN, nodokļu reitings, NACE kods, sankcijas, amatpersonas, darbības veidi, maksātnespējas/likvidācijas procesi, struktūrvienības, pēdējo 3 gadu nodokļu maksājumi un jaunākie finanšu dati.
get_company_financials- Iegūt vairāku gadu finanšu pārskatus: ieņēmumi, peļņa, aktīvi, kapitāls, darbinieki, saistības un naudas plūsma.
get_shareholders- Publicētie akcionāri un patiesie labuma guvēji (UBO) ar daļu procentiem, daļu skaitu un pretpuses reģistrācijas numuriem.
get_company_compliance- Iegūt PVN numuru, nodokļu reitingu, sankciju statusu, nodokļu parādu, melnā saraksta statusu un visus atbilstības rādītājus.
search_real_estate- Meklējiet kadastra objektus pēc adreses vai kadastra numura ar veida, īpašnieka veida, novada, platības, vērtības, būvniecības gada un stāvu filtriem.
get_real_estate_details- Kadastra dati, reģistrēti pārdošanas darījumi un salīdzināmo darījumu novērtējums vienam īpašumam.
check_company_sanctions- Pārbaudīt, vai uzņēmums ir sankciju sarakstā, un iegūt atbilstošos ierakstus.
get_company_taxes- Iegūt nodokļu maksājumus pa gadiem: iedzīvotāju ienākuma nodoklis, sociālās iemaksas, kopā un darbinieki.
check_person- Atrast personas amatus uzņēmumos pēc pilna vārda un dzimšanas datuma.
get_person_new_registrations- Iegūt personas amatus uzņēmumos, kas piesaistīti pēdējo N stundu laikā, uzraudzībai.
Lietošanas piemēri
Pēc savienošanas varat uzdot Claude jautājumus, piemēram:
- "Kādi ir SIA Maxima Latvija ieņēmumi?"
- "Parādi uzņēmuma 40003245752 finanšu vēsturi"
- "Vai šis uzņēmums ir sankcionēts? Pārbaudi regkodu 40003245752"
- "Atrodi Igaunijas uzņēmumus ar nosaukumu Bolt"