DatReal

API dokumentacija

Vieša API prieiga prie įmonių informacijos, sankcijų patikros ir asmenų stebėjimo. Nemokama prieiga prie Latvijos įmonių registro duomenų.

Greitas startas

API pasiekiama be registracijos ir autentifikacijos. Visi galiniai taškai palaiko CORS, todėl gali būti naudojami tiesiai iš naršyklės.

Pagrindinis URL: https://datreal.com/api/public/v1

Galiniai taškai

GET

/companies/{regcode}

Gaukite išsamią informaciją apie konkrečią įmonę, įskaitant sankcijų būseną.

Parametrai:

  • regcode (privaloma) - Įmonės registracijos numeris

Atsakyme pateikiama:

  • Pagrindinė informacija (pavadinimas, adresas, teisinė forma)
  • Registracijos ir uždarymo datos
  • Mokestinis reitingas ir PVM statusas
  • NACE kodas ir aprašymas
  • Finansinės ataskaitos
  • Sankcijų būklė (isSanctioned: true/false)
curl "https://datreal.com/api/public/v1/companies/40003245752"
GET

/companies/{regcode}/sanctions

Patikrina, ar įmonė yra sankcijų sąrašuose, ir pateikia išsamią informaciją.

Parametrai:

  • regcode (privaloma) - Įmonės registracijos numeris
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions"
GET

/persons/check

Patikrina, ar konkretus asmuo turi registruotų įmonių. Naudojama konkrečių asmenų stebėjimui.

Parametrai:

  • name (privaloma) - Asmens pilnas vardas (min. 2 simboliai)
  • birthDate (privaloma) - Gimimo data ISO formatu (MMMM-MM-DD)
  • limit (neprivaloma) - Maks. įmonių skaičius asmeniui (1-100, numatytasis: 50)

Grąžina visas roles: faktinis naudos gavėjas, valdybos narys, narys, akcininkas, mikroįmonė

curl "https://datreal.com/api/public/v1/persons/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"
GET

/persons/new-registrations

Gauna naujas įmonių registracijas konkrečiam asmeniui per paskutines N valandų. Naudojama konkrečių asmenų stebėjimui su cron užduotimis.

Parametrai:

  • name (privaloma) - Asmens pilnas vardas (min. 2 simboliai)
  • birthDate (privaloma) - Gimimo data ISO formatu (MMMM-MM-DD)
  • hours (neprivaloma) - Laiko langas valandomis (1-168, numatytasis: 24)
  • limit (neprivaloma) - Maks. įmonių skaičius (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"
GET

/

API aprašo galinis taškas, kuris JSON formatu grąžina visą dokumentaciją.

curl "https://datreal.com/api/public/v1"

Techninė informacija

CORS

Visi galiniai taškai palaiko CORS su * ištaka, todėl API galima naudoti tiesiai iš naršyklės.

Talpyklavimas

Atsakymai talpinami 30 minučių su 1 valandos stale-while-revalidate. Antraštės: public, s-maxage=1800, stale-while-revalidate=3600

Užklausų limitai

Užklausų limitai taikomi siekiant išvengti piktnaudžiavimo. Įmonių galiniai taškai: 20 užklausų/10s. Asmenų patikra: 20 užklausų/10s. Naujos registracijos: 10 užklausų/60s.

Klaidų kodai

  • 400 - Neteisinga užklausa (trūksta parametrų arba jie neteisingi)
  • 404 - Įmonė nerasta
  • 429 - Užklausų limitas viršytas
  • 500 - Serverio klaida

LLM sąrankos vadovas

Naudokite šį vadovą, kad sukonfigūruotumėte AI asistentus ir kalbos modelius darbui su DatReal API. Žemiau pateiktas tekstas apima visą informaciją, kurios LLM reikia, kad teisingai suprastų ir naudotų API.

Kopijuoti LLM

Nukopijuokite šį tekstą ir įklijuokite jį į savo LLM (ChatGPT, Claude ir kt.), kad jis galėtų naudoti DatReal API Latvijos įmonių paieškai.

# DatReal API Integration Guide

You are integrating with the DatReal 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}
- regcode (required): Company registration number
- 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
To check sanctions: GET https://datreal.com/api/public/v1/companies/40003245752/sanctions