API Dokumentatsioon
Avalik API ettevõtte info, sanktsioonide kontrolli ja isiku seire jaoks. Tasuta ligipääs Läti ettevõtteregistri andmetele.
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
Otspunktid
/companies/search
Otsi ettevõtteid nime, aadressi või registrikoodi järgi.
Parameetrid:
q(kohustuslik) - Otsingusõna (min. 2 tähemärki)limit(valikuline) - Tulemuste arv (1-100, vaikimisi: 20)country(valikuline) - Filtreeri riigikoodi järgi (LV, LT, EE, FI)
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&country=EE&limit=5"/companies/{regcode}
Hangi detailne info konkreetse ettevõtte kohta, sealhulgas sanktsioonide staatus.
Parameetrid:
regcode(kohustuslik) - Ettevõtte registrikoodcountry(valikuline) - Filtreeri riigikoodi järgi (LV, LT, EE, FI)
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)
curl "https://datreal.com/api/public/v1/companies/40003245752?country=LV"/companies/{regcode}/sanctions
Kontrolli, kas ettevõte on sanktsioonide nimekirjas ja saa detailset infot.
Parameetrid:
regcode(kohustuslik) - Ettevõtte registrikood
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions"/companies/autofill
Hangi ettevõtte aadress ja KMKR andmed vormide automaattäitmiseks.
Parameetrid:
q(kohustuslik) - Ettevõtte nimi või registrikood (min. 2 tähemärki)country(valikuline) - Filtreeri riigikoodi järgi (LV, LT, EE, FI)limit(valikuline) - Maksimaalselt tulemusi (1-50, vaikimisi: 10)
Vastus sisaldab:
- Registrikood
- Ettevõtte nimi
- Täielik juriidiline aadress
- KMKR number (kui on registreeritud)
- Riigikood (LV, LT, jne.)
curl "https://datreal.com/api/public/v1/companies/autofill?q=maxima&country=LV&limit=5"/persons/check
Kontrolli, kas konkreetsel isikul on ettevõtteid. Kasutatakse isikute jälgimiseks.
Parameetrid:
name(kohustuslik) - Isiku täisnimi (min. 2 tähemärki)birthDate(kohustuslik) - Sünnikuupäev ISO formaadis (AAAA-KK-PP)limit(valikuline) - Maksimaalne ettevõtete arv isiku kohta (1-100, vaikimisi: 50)
Tagastab kõik rollid: tegelik kasusaaja, ametnik, liige, omanik, mikroettevõte
curl "https://datreal.com/api/public/v1/persons/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"/persons/new-registrations
Hangi uued ettevõtte registreerimised konkreetsele isikule viimase N tunni jooksul. Kasutatakse isikute jälgimiseks cron tööde kaudu.
Parameetrid:
name(kohustuslik) - Isiku täisnimi (min. 2 tähemärki)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)
curl "https://datreal.com/api/public/v1/persons/new-registrations?name=Jānis%20Bērziņš&birthDate=1985-03-15&hours=24"/
API avastamise otspunkt, mis tagastab täieliku dokumentatsiooni JSON formaadis.
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.
Vahemälu
Vastused on vahemälus 30 minutit, 1 tund stale-while-revalidate. Päised: public, s-maxage=1800, stale-while-revalidate=3600
Päringute limiidid
Limiidid on rakendatud kuritarvitamise vältimiseks. Ettevõtte 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- Ettevõtet ei leitud429- Päringute limiit ületatud500- Serveri viga
LLM Setup Juhend
Kasuta seda juhendit AI assistentide seadistamiseks Lur.lv API-ga töötamiseks.
Kopeeri LLM jaoks
Kopeeri see viip ja sisesta see oma LLM-i (ChatGPT, Claude, jne), et võimaldada Läti ettevõtete otsingut.
# 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 server (Claude, AI agendid)
Ü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.
Mis on MCP?
Model Context Protocol (MCP) on avatud standard, mis võimaldab AI assistentidel nagu Claude otse juurde pääseda välistele andmeallikatele ja tööriistadele. AI saab iseseisvalt ettevõtete andmeid pärida.
MCP serveri otspunkt
Serveri URL (Streamable HTTP):
https://datreal.com/api/mcpSaadaolevad tööriistad
search_companiesOtsige ettevõtteid nime, aadressi või registrikoodi järgi LV, LT, EE, FI.
get_company_detailsHankige ettevõtte täisinfo: nimi, aadress, õiguslik vorm, KMKR, maksureiting, NACE kood, sanktsioonid, ametnikud ja finantsandmed.
get_company_financialsHankige mitmeaastased finantsaruanded: tulud, kasum, varad, omakapital, töötajad, kohustised ja rahavoog.
get_company_complianceHankige KMKR number, maksureiting, sanktsioonide staatus, maksuvõlg, musta nimekirja staatus ja kõik vastavusnäitajad.
Seadistamine Claude Desktop jaoks
Lisage see oma Claude Desktopi konfiguratsioonifaili:
Konfiguratsioonifaili asukoht:
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" } }}Seadistamine Claude Code jaoks
Käivitage see käsk terminalis, et lisada MCP server Claude Code'i:
claude mcp add datreal --transport http https://datreal.com/api/mcpKasutusnä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"
Ühilduvad AI kliendid
Iga MCP-ühilduv klient saab sellega ühenduse luua, sealhulgas:
- ✓Claude Desktop ja Claude Code (Anthropic)
- ✓Cursor IDE
- ✓Kohandatud MCP kliendid, mis on ehitatud MCP SDK-ga