API-dokumentaatio
Julkinen API yritystiedoille, pakotteiden tarkistuksille ja henkilöseurannalle. Vapaa pääsy yritysrekisteritietoihin.
Pikaopas
API on käytettävissä ilman rekisteröintiä tai todennusta. Kaikki päätepisteet tukevat CORS:ia.
Perus-URL: https://datreal.com/api/public/v1
Päätepisteet
/companies/search
Etsi yrityksiä nimellä, osoitteella tai Y-tunnuksella.
Parametrit:
q(pakollinen) - Hakukysely (vähintään 2 merkkiä)limit(valinnainen) - Tulosten määrä (1-100, oletus: 20)country(valinnainen) - Suodata maakoodin mukaan
curl "https://datreal.com/api/public/v1/companies/search?q=tallink&country=EE&limit=5"/companies/{regcode}
Hae yksityiskohtaiset tiedot tietystä yrityksestä, mukaan lukien pakotteiden tila.
Parametrit:
regcode(pakollinen) - Y-tunnus
Vastaus sisältää:
- Perustiedot (nimi, osoite, yritysmuoto)
- Rekisteröinti- ja sulkemispäivät
- Veronmaksajan luokitus ja ALV-tila
- TOL-koodi ja kuvaus
- Tilinpäätökset
- Pakotteiden tila (isSanctioned: true/false)
curl "https://datreal.com/api/public/v1/companies/40003245752"/companies/{regcode}/sanctions
Tarkista, onko yritys pakotelistalla ja hae yksityiskohtaiset tiedot.
Parametrit:
regcode(pakollinen) - Y-tunnus
curl "https://datreal.com/api/public/v1/companies/40003245752/sanctions"/companies/autofill
Hae yrityksen osoite- ja ALV-tiedot lomakkeen täydentämiseen.
Parametrit:
q(pakollinen) - Yrityksen nimi tai Y-tunnus (vähintään 2 merkkiä)country(valinnainen) - Suodata maakoodin mukaanlimit(valinnainen) - Tulosten enimmäismäärä (1-50, oletus: 10)
Vastaus sisältää:
- Y-tunnus
- Yrityksen nimi
- Täydellinen osoite
- ALV-numero (jos rekisteröity)
- Maakoodi (FI, LV, jne.)
curl "https://datreal.com/api/public/v1/companies/autofill?q=maxima&country=LV&limit=5"/persons/check
Tarkista, onko tietyllä henkilöllä yritysrekisteröintejä.
Parametrit:
name(pakollinen) - Henkilön koko nimi (vähintään 2 merkkiä)birthDate(pakollinen) - Syntymäpäivä ISO-muodossa (VVVV-KK-PP)limit(valinnainen) - Yritysten enimmäismäärä henkilöä kohti (1-100, oletus: 50)
Palauttaa kaikki roolit: tosiasiallinen edunsaaja, toimihenkilö, jäsen, osakkeenomistaja
curl "https://datreal.com/api/public/v1/persons/check?name=Jānis%20Bērziņš&birthDate=1985-03-15"/persons/new-registrations
Hae tietyn henkilön uudet yritysrekisteröinnit viimeisten N tunnin aikana.
Parametrit:
name(pakollinen) - Henkilön koko nimi (vähintään 2 merkkiä)birthDate(pakollinen) - Syntymäpäivä ISO-muodossa (VVVV-KK-PP)hours(valinnainen) - Aikaikkuna tunteina (1-168, oletus: 24)limit(valinnainen) - Palautettavien yritysten enimmäismäärä (1-1000, oletus: 100)
curl "https://datreal.com/api/public/v1/persons/new-registrations?name=Jānis%20Bērziņš&birthDate=1985-03-15&hours=24"/
API-päätepiste, joka palauttaa täydellisen dokumentaation JSON-muodossa.
curl "https://datreal.com/api/public/v1"Tekniset tiedot
CORS
Kaikki päätepisteet tukevat CORS:ia * alkuperällä, mikä mahdollistaa suoran selainpääsyn API:in.
Välimuisti
Vastaukset tallennetaan välimuistiin 30 minuutiksi. public, s-maxage=1800, stale-while-revalidate=3600
Pyyntörajat
Pyyntörajoja sovelletaan väärinkäytön estämiseksi. Yrityksen päätepisteet: 20 pyyntöä/10s.
Virhekoodit
400- Virheellinen pyyntö (puuttuvat tai virheelliset parametrit)404- Yritystä ei löytynyt429- Pyyntöraja ylitetty500- Palvelinvirhe
LLM-asennusopas
Käytä tätä opasta AI-assistenttien ja kielimallien konfigurointiin API:n kanssa.
Kopioi LLM:lle
Kopioi tämä kehote ja liitä se LLM:ään (ChatGPT, Claude jne.) mahdollistaaksesi yrityshakujen käytön.
# 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}
- 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