API dokumentacija
Viešas API įmonių informacijai, sankcijų patikrai ir asmenų stebėsenai. Nemokama prieiga prie Latvijos ir Lietuvos įmonių registro duomenų.
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
Galutiniai taškai
/companies/search
Ieškoti įmonių pagal pavadinimą, adresą arba registracijos numerį.
Parametrai:
q(privaloma) - Paieškos užklausa (min. 2 simboliai)limit(neprivaloma) - Rezultatų skaičius (1-100, numatytasis: 20)country(neprivaloma) - Filtruoti pagal šalies kodą (LV, LT, EE, FI)
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&country=EE&limit=5"/companies/{regcode}
Gauti išsamią informaciją apie konkrečią įmonę, įskaitant sankcijų statusą.
Parametrai:
regcode(privaloma) - Įmonės registracijos numeriscountry(neprivaloma) - Filtruoti pagal šalies kodą (LV, LT, EE, FI)
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)
curl "https://datreal.com/api/public/v1/companies/40003245752?country=LV"/companies/{regcode}/sanctions
Tikrinti, ar įmonė yra sankcijų sąraše, ir gauti detalią informaciją.
Parametrai:
regcode(privaloma) - Įmonės registracijos numeris
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions"/companies/autofill
Gaukite įmonės adreso ir PVM duomenis formų pildymui. Optimizuota laisvalaikio projektams.
Parametrai:
q(privaloma) - Įmonės pavadinimas arba kodas (min. 2 simboliai)country(neprivaloma) - Filtruoti pagal šalies kodą (LV, LT, EE, FI)limit(neprivaloma) - Maks. rezultatų (1-50, numatytasis: 10)
Atsakymas apima:
- Įmonės kodas
- Įmonės pavadinimas
- Pilnas juridinis adresas
- PVM kodas (jei registruota)
- Šalies kodas (LV, LT ir kt.)
curl "https://datreal.com/api/public/v1/companies/autofill?q=maxima&country=LV&limit=5"/persons/check
Tikrinti, ar asmuo turi susijusių įmonių registracijų. Naudojama specifinių asmenų stebėsenai.
Parametrai:
name(privaloma) - Asmens vardas ir pavardė (min. 2 simboliai)birthDate(privaloma) - Gimimo data ISO formatu (MMMM-MM-DD)limit(neprivaloma) - Maks. įmonių asmeniui (1-100, numatytasis: 50)
Grąžina visus vaidmenis: tikrasis naudos gavėjas, vadovas, narys, akcininkas
curl "https://datreal.com/api/public/v1/persons/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"/persons/new-registrations
Gauti naujas asmens įmonių registracijas per paskutines N valandų. Naudojama specifinių asmenų stebėsenai per cron jobs.
Parametrai:
name(privaloma) - Asmens vardas ir pavardė (min. 2 simboliai)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)
curl "https://datreal.com/api/public/v1/persons/new-registrations?name=Jānis%20Bērziņš&birthDate=1985-03-15&hours=24"/
API atradimo taškas, grąžinantis pilną dokumentaciją JSON formatu.
curl "https://datreal.com/api/public/v1"Techninė informacija
CORS
Visi taškai palaiko CORS su * kilme, leisdami tiesioginę prieigą iš naršyklės.
Kešavimas
Atsakymai saugomi talpykloje 30 minučių su 1 valandos 'stale-while-revalidate'. Antraštės: public, s-maxage=1800, stale-while-revalidate=3600
Užklausų limitai
Taikomi užklausų limitai siekiant išvengti piktnaudžiavimo. Įmonių 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- Įmonė nerasta429- Viršytas užklausų limitas500- Serverio klaida
LLM nustatymo vadovas
Naudokite šį vadovą AI asistentų ir kalbos modelių konfigūravimui darbui su Lur.lv 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 Lur.lv API Latvijos įmonių paieškai.
# Datreal.com API Integration Guide
You are integrating with the Datreal.com public API for Latvian company data. Here is everything you need to know:
## Base URL
https://datreal.com/api/public/v1
## Authentication
No authentication required. The API is publicly accessible.
## Available Endpoints
### 1. Search Companies
GET /companies/search?q={query}&limit={limit}
- q (required): Search query, minimum 2 characters
- limit (optional): Results count, 1-100, default 20
- Returns: Array of matching companies with regcode, name, address, status
### 2. Get Company Details
GET /companies/{regcode}?country={country}
- regcode (required): Company registration number
- country (optional): Country code to disambiguate duplicates (LV, LT, EE, FI)
- Returns: Full company details including financials, tax rating, VAT status, sanctions status
### 3. Check Sanctions
GET /companies/{regcode}/sanctions
- regcode (required): Company registration number
- Returns: Sanctions status and list of any active sanctions
### 4. Check Person
GET /persons/check?name={name}&birthDate={birthDate}&limit={limit}
- name (required): Full name, minimum 2 characters
- birthDate (required): ISO format YYYY-MM-DD
- limit (optional): Max companies, 1-100, default 50
- Returns: All company associations (board member, shareholder, beneficial owner, etc.)
### 5. New Registrations
GET /persons/new-registrations?name={name}&birthDate={birthDate}&hours={hours}&limit={limit}
- name (required): Full name
- birthDate (required): ISO format YYYY-MM-DD
- hours (optional): Time window 1-168, default 24
- limit (optional): Max results 1-1000, default 100
- Returns: New company registrations for the person within the time window
## Rate Limits
- Company endpoints: 20 requests per 10 seconds
- Person check: 20 requests per 10 seconds
- New registrations: 10 requests per 60 seconds
## Response Format
All 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
## CORS
All endpoints support CORS with * origin, allowing direct browser access.
## Caching
Responses are cached for 30 minutes with stale-while-revalidate of 1 hour.
## Example Usage
To search for a company: GET https://datreal.com/api/public/v1/companies/search?q=example&limit=10
To get company details: GET https://datreal.com/api/public/v1/companies/40003245752?country=LV
To check sanctions: GET https://datreal.com/api/public/v1/companies/40003245752/sanctionsMCP serveris (Claude, AI agentai)
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.
Kas yra MCP?
Model Context Protocol (MCP) yra atviras standartas, leidžiantis AI asistentams, tokiems kaip Claude, tiesiogiai pasiekti išorinius duomenų šaltinius ir įrankius. AI gali savarankiškai užklausti įmonių duomenis.
MCP serverio galinis taškas
Serverio URL (Streamable HTTP):
https://datreal.com/api/mcpGalimi įrankiai
search_companiesIeškoti įmonių pagal pavadinimą, adresą arba kodą LV, LT, EE, FI.
get_company_detailsGauti pilną įmonės informaciją: pavadinimas, adresas, teisinė forma, PVM, mokesčių reitingas, NACE kodas, sankcijos, vadovai ir finansiniai duomenys.
get_company_financialsGauti daugiametes finansines ataskaitas: pajamos, pelnas, turtas, kapitalas, darbuotojai, įsipareigojimai ir pinigų srautai.
get_company_complianceGauti PVM numerį, mokesčių reitingą, sankcijų statusą, mokesčių skolą, juodojo sąrašo statusą ir visus atitikties rodiklius.
Nustatymas Claude Desktop
Pridėkite tai prie savo Claude Desktop konfigūracijos failo:
Konfigūracijos failo vieta:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "datreal": { "type": "url", "url": "https://datreal.com/api/mcp" } }}Nustatymas Claude Code
Paleiskite šią komandą terminale, kad pridėtumėte MCP serverį į Claude Code:
claude mcp add datreal --transport http https://datreal.com/api/mcpNaudojimo 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"
Suderinami AI klientai
Bet kuris MCP suderinamas klientas gali prisijungti prie šio serverio, įskaitant:
- ✓Claude Desktop ir Claude Code (Anthropic)
- ✓Cursor IDE
- ✓Individualūs MCP klientai, sukurti su MCP SDK