Viešas API įmonių informacijai, sankcijų patikrai, asmenų stebėsenai ir nekilnojamojo turto paieškai Latvijoje, Lietuvoje, Estijoje, Suomijoje ir Švedijoje.
Greita pradžia
API prieinamas be registracijos ar autentifikacijos. Visi taškai palaiko CORS, todėl gali būti naudojami tiesiogiai iš naršyklės.
- Bazinis URL
https://datreal.com/api/public/v1
Pavyzdys
Greita pradžia · cURL
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&countryCode=EE&limit=5"Naudojimo atvejai
Galiniai taškai sugrupuoti pagal naudojimo atvejį, kad galėtumėte pasirinkti tinkamą neskaitydami viso žinyno.
Paieška ir užklausos
Ieškokite ir gaukite pilnus įmonių profilius, adresų automatinį užbaigimą ir pagrindinius firmų duomenis.
Nuosavybė ir asmenys
Akcininkai, tikrieji naudos gavėjai (UBO) ir identifikatoriais pagrįsti asmenų ryšiai su įmonėmis.
Atitiktis
Sankcijų, juodųjų sąrašų ir mokesčių atitikties patikros LV, LT, EE, FI, SE šalyse.
Stebėsena
Laiko intervalo pokyčių srautai - naujos registracijos ir kiti beveik realaus laiko signalai.
Nekilnojamasis turtas
Ieškokite kadastro objektų ir gaukite išsamią informaciją su registruotais pardavimais ir vertės įvertinimais.
API atradimas
Save aprašantis šakninis taškas, kuris išvardija kiekvieną galinį tašką ir jo parametrus.
Galutiniai taškai
Paieška ir užklausos
Ieškokite ir gaukite pilnus įmonių profilius, adresų automatinį užbaigimą ir pagrindinius firmų duomenis.
GET /companies/search
/companies/searchIeškoti įmonių pagal pavadinimą, adresą arba registracijos numerį.
Parametrai
countryCode(neprivaloma)- Filtruoti pagal šalies kodą (LV, LT, EE, FI, SE)
limit(neprivaloma)- Rezultatų skaičius (1-100, numatytasis: 20)
nace(neprivaloma)- NACE kodo pradžia (pvz., J arba 62). Gali pakeisti q.
page(neprivaloma)- Rezultatų puslapis (nuo 1). Tolimesniems puslapiams taikomas ribotas paieškos langas.
q(neprivaloma)- Paieškos užklausa (bent 2 simboliai). Privaloma, jei nenurodytas nace.
GET /companies/search · cURL
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&countryCode=EE&limit=5"GET /companies/{regcode}
/companies/{regcode}Gauti išsamią informaciją apie konkrečią įmonę, įskaitant sankcijų statusą.
Parametrai
countryCode(neprivaloma)- Filtruoti pagal šalies kodą (LV, LT, EE, FI, SE)
regcode(privaloma)- Įmonės registracijos numeris
Atsakymas apima
- Pagrindinė informacija (pavadinimas, adresas, teisinė forma)
- Registracijos ir uždarymo datos
- Mokesčių mokėtojo reitingas ir PVM statusas
- NACE kodas ir aprašymas
- Finansinės ataskaitos
- Sankcijų statusas (IsSanctioned: True/false)
GET /companies/{regcode} · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752?countryCode=LV"GET /companies/autofill
/companies/autofillGaukite įmonės adreso ir PVM duomenis formų pildymui. Optimizuota laisvalaikio projektams.
Parametrai
countryCode(neprivaloma)- Filtruoti pagal šalies kodą (LV, LT, EE, FI, SE)
limit(neprivaloma)- Maks. rezultatų (1-50, numatytasis: 10)
q(privaloma)- Įmonės pavadinimas arba kodas (min. 2 simboliai)
Atsakymas apima
- Įmonės kodas
- Įmonės pavadinimas
- Pilnas juridinis adresas
- PVM kodas (jei registruota)
- Šalies kodas (LV, LT ir kt.)
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}/financialsGauti įmonės metines finansines ataskaitas. Jei ataskaitų nėra, grąžina 404.
Parametrai
countryCode(neprivaloma)- Filtruoti pagal šalies kodą (LV, LT, EE, FI, SE)
regcode(privaloma)- Įmonės registracijos numeris
Atsakymas apima
- reports - vienas įrašas kiekvieniems finansiniams metams: pajamos, pelnas, turtas, kapitalas, darbuotojai, pinigų srautai
- totalYears - grąžintų finansinių metų skaičius
GET /companies/{regcode}/financials · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752/financials?countryCode=LV"Nuosavybė ir asmenys
Akcininkai, tikrieji naudos gavėjai (UBO) ir identifikatoriais pagrįsti asmenų ryšiai su įmonėmis.
GET /people/check
/people/checkTikrinti sutapatintus asmens vaidmenis įmonėse, kai vieši identifikatoriai leidžia patikimą susiejimą.
Parametrai
birthDate(privaloma)- Gimimo data ISO formatu (MMMM-MM-DD)
limit(neprivaloma)- Maks. įmonių asmeniui (1-100, numatytasis: 50)
name(privaloma)- Asmens vardas ir pavardė (min. 2 simboliai)
Grąžina sutapatintus vaidmenis, kai vieši asmens identifikatoriai leidžia patikimą susiejimą: tikrasis naudos gavėjas, vadovas, narys, akcininkas
GET /people/check · cURL
curl "https://datreal.com/api/public/v1/people/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"Atitiktis
Sankcijų, juodųjų sąrašų ir mokesčių atitikties patikros LV, LT, EE, FI, SE šalyse.
GET /companies/{regcode}/compliance
/companies/{regcode}/complianceGauti PVM registraciją, mokesčių reitingą, mokesčių skolą ir atitikties rodiklius viename nedideliame atsakyme.
Parametrai
countryCode(neprivaloma)- Filtruoti pagal šalies kodą (LV, LT, EE, FI, SE)
regcode(privaloma)- Įmonės registracijos numeris
Atsakymas apima
- vatNumber / vatStatus / vatRegisteredAt - PVM registracija
- taxRating / taxDebtAmount / hasTaxDebt - mokesčių būklė
- isBlacklisted / isSuspendedActivity / hasMissingFinancialReports ir kiti rodikliai
- Sankcijų statusas (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}/taxesGauti naujausių metų įmonės mokesčių mokėjimus, įskaitant pajamų mokestį, socialinį mokestį, bendrą mokestį ir darbuotojų skaičių.
Parametrai
countryCode(neprivaloma)- Filtruoti pagal šalies kodą (LV, LT, EE, FI, SE)
regcode(privaloma)- Įmonės registracijos numeris
Atsakymas apima
- taxPayments - iki 3 naujausių metų su turimais mokesčių duomenimis
- taxPayments[].totalTax / incomeTax / socialTax - metinės mokesčių mokėjimų sumos
- taxPayments[].employees - deklaruotas darbuotojų skaičius tais metais
GET /companies/{regcode}/taxes · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752/taxes?countryCode=LV"GET /companies/{regcode}/sanctions
/companies/{regcode}/sanctionsTikrinti, ar įmonė yra sankcijų sąraše, ir gauti detalią informaciją.
Parametrai
countryCode(neprivaloma)- Filtruoti pagal šalies kodą (LV, LT, EE, FI, SE)
regcode(privaloma)- Įmonės registracijos numeris
GET /companies/{regcode}/sanctions · cURL
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions?countryCode=LV"Stebėsena
Laiko intervalo pokyčių srautai - naujos registracijos ir kiti beveik realaus laiko signalai.
GET /people/new-registrations
/people/new-registrationsGauti naujai susietus sutapatinto asmens vaidmenis įmonėse per paskutines N valandų. Naudojama identifikatoriais pagrįstai stebėsenai per cron jobs.
Parametrai
birthDate(privaloma)- Gimimo data ISO formatu (MMMM-MM-DD)
hours(neprivaloma)- Laiko langas valandomis (1-168, numatytasis: 24)
limit(neprivaloma)- Maks. grąžinamų įmonių (1-1000, numatytasis: 100)
name(privaloma)- Asmens vardas ir pavardė (min. 2 simboliai)
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"Nekilnojamasis turtas
Ieškokite kadastro objektų ir gaukite išsamią informaciją su registruotais pardavimais ir vertės įvertinimais.
GET /real-estate/search
/real-estate/searchIeškokite kadastro objektų pagal adresą ar kadastro numerį su tipo, savininko tipo, savivaldybės, ploto, vertės, statybos metų ir aukštų filtrais.
Parametrai
bbox(neprivaloma)- Aprėpties stačiakampis: vakarai,pietūs,rytai,šiaurė WGS84 laipsniais
countryCode(neprivaloma)- Šalis, kurios kadastre ieškoti. Praleiskite, kad ieškotumėte visose palaikomose šalyse.
hasBusiness(neprivaloma)- Tik su įmone susieti objektai; įjungti naudokite 1
hasListings(neprivaloma)- Tik objektai su aktyviu skelbimu; įjungti naudokite 1
hasSales(neprivaloma)- Tik objektai su registruotu pardavimu; įjungti naudokite 1
maxArea(neprivaloma)- Didžiausias žemės/pastato/patalpų plotas m²
maxBuiltYear(neprivaloma)- Vėliausi pastato/patalpų statybos metai
maxValue(neprivaloma)- Didžiausia kadastro vertė objekto vietine valiuta
maxFloors(neprivaloma)- Didžiausias antžeminių aukštų skaičius
maxSalePrice(neprivaloma)- Didžiausia registruota pardavimo kaina sandorio vietine valiuta
minArea(neprivaloma)- Mažiausias žemės/pastato/patalpų plotas m²
minBuiltYear(neprivaloma)- Ankstyviausi pastato/patalpų statybos metai
minValue(neprivaloma)- Mažiausia kadastro vertė objekto vietine valiuta
minFloors(neprivaloma)- Mažiausias antžeminių aukštų skaičius
minSalePrice(neprivaloma)- Mažiausia registruota pardavimo kaina sandorio vietine valiuta
municipality(neprivaloma)- Savivaldybės pavadinimas arba keli pavadinimai, atskirti kableliais
objectType(neprivaloma)- Nekilnojamojo turto objekto tipas
ownerType(neprivaloma)- Savininko klasifikacija, o ne savininko tapatybė
limit(neprivaloma)- Didžiausias rezultatų skaičius (1–100, numatyta: 20)
page(neprivaloma)- Rezultatų puslapis (nuo 1). Tolimesniems puslapiams taikomas ribotas paieškos langas.
q(neprivaloma)- Adreso tekstas arba kadastro/turto identifikatorius
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}Kadastro duomenys, registruoti pardavimai ir palyginamųjų sandorių vertės įvertinimas.
Parametrai
cadastralNumber(privaloma)- Kadastro arba nekilnojamojo turto identifikatorius
countryCode(privaloma)- Šalis, kuriai priklauso identifikatorius. Identifikatoriai nėra visuotinai unikalūs.
scheme(privaloma)- Nekilnojamojo turto paieškos grąžinta identifikatorių sistema
GET /real-estate/{cadastralNumber} · cURL
curl "https://datreal.com/api/public/v1/real-estate/01000302015?countryCode=LV&scheme=LV_CADASTRAL_OBJECT"API atradimas
Save aprašantis šakninis taškas, kuris išvardija kiekvieną galinį tašką ir jo parametrus.
GET /
/API atradimo taškas, grąžinantis pilną dokumentaciją JSON formatu.
GET / · cURL
curl "https://datreal.com/api/public/v1"Techninė informacija
- CORS
- Visi taškai palaiko CORS su
*kilme, leisdami tiesioginę prieigą iš naršyklės. - Užklausų limitai
- Taikomi užklausų limitai siekiant išvengti piktnaudžiavimo. Įmonių taškai: 20 req/10s. Nekilnojamojo turto taškai: 20 req/10s. Asmens patikra: 20 req/10s. Naujos registracijos: 10 req/60s.
- Klaidų kodai
400- Neteisinga užklausa (trūksta arba neteisingi parametrai)404- apiDocs.error404429- Viršytas užklausų limitas500- apiDocs.error500
LLM nustatymo vadovas
Naudokite šį vadovą AI asistentų ir kalbos modelių konfigūravimui darbui su Datreal.com API. Žemiau pateiktoje užklausoje yra visa informacija, kurios reikia LLM suprasti ir teisingai naudoti API.
Kopijuoti LLM
Nukopijuokite šią užklausą ir įklijuokite į savo LLM (ChatGPT, Claude ir kt.), kad įgalintumėte naudoti Datreal.com API Baltijos ir Šiaurės šalių įmonių paieškai.
Kodas
# 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
Prijunkite Claude Desktop, Claude Code ar bet kurį MCP suderinamą AI klientą tiesiai prie mūsų įmonių duomenų naudodami Model Context Protocol (MCP). API raktų nereikia.
Nustatymas Claude Code
Paleiskite šią komandą terminale, kad pridėtumėte MCP serverį į Claude Code:
Kodas
claude mcp add datreal --transport http https://datreal.com/api/mcpNustatymas Claude Desktop
Pridėkite tai prie savo Claude Desktop konfigūracijos failo:
Kodas
{ "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 serverio galinis taškas
- Serverio URL (Streamable HTTP)
https://datreal.com/api/mcp
Galimi įrankiai
search_companies- Ieškoti įmonių pagal pavadinimą, adresą arba kodą LV, LT, EE, FI, SE.
get_company_details- Gauti pilną įmonės informaciją: pavadinimas, adresas, teisinė forma, PVM, mokesčių reitingas, NACE kodas, sankcijos, vadovai, veiklos, nemokumo/likvidavimo procesai, struktūriniai padaliniai, paskutinių 3 metų mokesčių mokėjimai ir naujausi finansiniai duomenys.
get_company_financials- Gauti daugiametes finansines ataskaitas: pajamos, pelnas, turtas, kapitalas, darbuotojai, įsipareigojimai ir pinigų srautai.
get_shareholders- Paskelbti akcininkai ir tikrieji naudos gavėjai (UBO) su nuosavybės procentais, akcijų skaičiumi ir sandorio šalių registracijos kodais.
get_company_compliance- Gauti PVM numerį, mokesčių reitingą, sankcijų statusą, mokesčių skolą, juodojo sąrašo statusą ir visus atitikties rodiklius.
search_real_estate- Ieškokite kadastro objektų pagal adresą ar kadastro numerį su tipo, savininko tipo, savivaldybės, ploto, vertės, statybos metų ir aukštų filtrais.
get_real_estate_details- Kadastro duomenys, registruoti pardavimai ir palyginamųjų sandorių vertės įvertinimas.
check_company_sanctions- Patikrinti, ar įmonė yra sankcijų sąraše, ir gauti atitinkamus įrašus.
get_company_taxes- Gauti mokesčių mokėjimus pagal metus: pajamų mokestis, socialinis mokestis, iš viso ir darbuotojai.
check_person- Rasti asmens pareigas įmonėse pagal vardą, pavardę ir gimimo datą.
get_person_new_registrations- Gauti asmens pareigas įmonėse, susietas per paskutines N valandų, stebėsenai.
Naudojimo pavyzdžiai
Prisijungus galite užduoti Claude klausimus, pavyzdžiui:
- "Kokios yra SIA Maxima Latvija pajamos?"
- "Parodyk įmonės 40003245752 finansinę istoriją"
- "Ar ši įmonė yra sankcionuota? Patikrink kodą 40003245752"
- "Rask Estijos įmones pavadinimu Bolt"