API dokumentācija
Publisks API uzņēmumu informācijai, sankciju pārbaudēm un personu uzraudzībai. Bezmaksas piekļuve Latvijas uzņēmumu reģistra datiem.
Ātrā sākšana
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
Galapunkti
/companies/search
Meklē uzņēmumus pēc nosaukuma, adreses vai reģistrācijas numura.
Parametri:
q(obligāts) - Meklēšanas vaicājums (min. 2 rakstzīmes)limit(neobligāts) - Rezultātu skaits (1–100, noklusējums: 20)country(neobligāts) - Filtrēt pēc valsts koda (LV, LT, EE, FI)
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&country=EE&limit=5"/companies/{regcode}
Iegūst detalizētu informāciju par konkrētu uzņēmumu, ieskaitot sankciju statusu.
Parametri:
regcode(obligāts) - Uzņēmuma reģistrācijas numurscountry(neobligāts) - Filtrēt pēc valsts koda (LV, LT, EE, FI)
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ārskatus
- Sankciju statusu (isSanctioned: true/false)
curl "https://datreal.com/api/public/v1/companies/40003245752?country=LV"/companies/{regcode}/sanctions
Pārbauda, vai uzņēmums ir sankciju sarakstos, un atgriež detalizētu informāciju.
Parametri:
regcode(obligāts) - Uzņēmuma reģistrācijas numurs
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions"/companies/autofill
Iegūstiet uzņēmuma adresi un PVN datus formu aizpildīšanai. Optimizēts adrešu automātiskai aizpildīšanai hobijprojektos.
Parametri:
q(obligāts) - Uzņēmuma nosaukums vai reģistrācijas numurs (min. 2 rakstzīmes)country(neobligāts) - Filtrēt pēc valsts koda (LV, LT, EE, FI)limit(neobligāts) - Maks. rezultāti (1-50, noklusējums: 10)
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&country=LV&limit=5"/persons/check
Pārbauda, vai konkrētai personai ir reģistrēti uzņēmumi. Izmanto konkrētu personu uzraudzībai.
Parametri:
name(obligāts) - Personas pilns vārds (min. 2 rakstzīmes)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)
Atgriež visas lomas: patiesais labuma guvējs, valdes loceklis, biedrs, akcionārs, mikrouzņēmums
curl "https://datreal.com/api/public/v1/persons/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"/persons/new-registrations
Iegūst jaunas uzņēmumu reģistrācijas konkrētai personai pēdējās N stundās. Izmanto konkrētu personu uzraudzībai ar cron darbiem.
Parametri:
name(obligāts) - Personas pilns vārds (min. 2 rakstzīmes)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)
curl "https://datreal.com/api/public/v1/persons/new-registrations?name=Jānis%20Bērziņš&birthDate=1985-03-15&hours=24"/
API atklāšanas galapunkts, kas atgriež pilnu dokumentāciju JSON formātā.
curl "https://datreal.com/api/public/v1"Tehniskā informācija
CORS
Visi galapunkti atbalsta CORS ar * izcelsmi, ļaujot API izmantot tieši no pārlūka.
Kešošana
Atbildes tiek kešotas 30 minūtes ar 1 stundas stale-while-revalidate. Galvenes: public, s-maxage=1800, stale-while-revalidate=3600
Pieprasījumu ierobežojumi
Pieprasījumu ierobežojumi novērš ļaunprātīgu izmantošanu. Uzņēmumu 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- Uzņēmums nav atrasts429- Pieprasījumu ierobežojums pārsniegts500- Servera kļūda
LLM iestatīšanas ceļvedis
Izmantojiet šo ceļvedi, lai konfigurētu AI asistentus un valodas modeļus darbam ar Lur.lv 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 Lur.lv API Latvijas uzņēmumu meklēšanai.
# 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 aģenti)
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.
Kas ir MCP?
Model Context Protocol (MCP) ir atvērts standarts, kas ļauj AI asistentiem, piemēram, Claude, tieši piekļūt ārējiem datu avotiem un rīkiem. AI var patstāvīgi vaicāt uzņēmumu datus bez API atbilžu kopēšanas.
MCP servera galapunkts
Servera URL (Streamable HTTP):
https://datreal.com/api/mcpPieejamie rīki
search_companiesMeklēt uzņēmumus pēc nosaukuma, adreses vai reģ. numura LV, LT, EE, FI.
get_company_detailsIegūt pilnu uzņēmuma info: nosaukums, adrese, juridiskā forma, PVN, nodokļu reitings, NACE kods, sankcijas, amatpersonas un finanšu dati.
get_company_financialsIegūt vairāku gadu finanšu pārskatus: ieņēmumi, peļņa, aktīvi, kapitāls, darbinieki, saistības un naudas plūsma.
get_company_complianceIegūt PVN numuru, nodokļu reitingu, sankciju statusu, nodokļu parādu, melnā saraksta statusu un visus atbilstības rādītājus.
Iestatīšana Claude Desktop
Pievienojiet šo sava Claude Desktop konfigurācijas failam:
Konfigurācijas faila atrašanās 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" } }}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/mcpLietoš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"
Saderīgi AI klienti
Jebkurš MCP-saderīgs klients var pieslēgties šim serverim, tostarp:
- ✓Claude Desktop un Claude Code (Anthropic)
- ✓Cursor IDE
- ✓Pielāgoti MCP klienti, kas veidoti ar MCP SDK