RATI

Rati API for utviklere

Bygg apper, integrasjoner og AI-agenter mot Rati: tolket bedriftssøk opp til 20 strukturerte treff, og profil-data for 1,17 millioner norske virksomheter.

Fritekstsøkene tolkes («tannlege moss», «vvs i oslo») ved hjelp av samme pipeline som Rati AI — uten LLM, lav latens. Kilde: Brønnøysundregistrene (NLOD) via rati.no.

1

Hvorfor Rati API?

  • Naturlig tolket søk — spørringen «tannlege moss» omsettes automatisk til bransje + kommune og returneres strukturert med treff
  • Strukturerte data — navn, orgnr, profil-URL, bransje, sted, telefon og omsetning fra siste regnskap
  • Åpne offentlige data — grunnlaget er Brønnøysundregistrene, publisert under NLOD 2.0, så appen din kan gjenbruke data med kildeangivelse
  • Norsk — servere og data i Norge, ingen tredjeparts AI-sky
2

Hurtigstart (uten nøkkel)

AI-søk er åpent for alle uten registrering: 200 forespørsler per IP per døgn. Eksempel:

curl -X POST https://rati.no/api/v1/ai/search \
  -H "Content-Type: application/json" \
  -d '{"query":"elektriker moss"}'

Svar (JSON): interpreted (tolket tekst, NACE-kode, kommune), results (maks 20: navn, orgnr, url, bransje, sted, tlf, omsetning), search_url, count, has_more.

3

Med API-nøkkel: 5 000 forespørsler per døgn

Send headeren X-Rati-Key: rk_… for høyere kvote. Nøkkel bestilles gratis — send e-post til [email protected] med litt om hva du bygger. Ugyldig nøkkel gir 401; brukt dagskvote gir 429.

4

Andre åpne endepunkter

  • GET /api/v1/search?q=&sted=&bransje= — rått bedriftssøk (maks 10 treff)
  • GET /api/v1/company/{orgnr} — profil-data for enkeltbedrift
  • POST /api/v1/ai/search — AI-tolket søk (se over)
  • AI-agenter: /llms.txt + WebMCP-verktøy (rati_search_companies, rati_get_company)
5

Integrasjonsveiledninger

Kom i gang raskt i verktøyene dine (samme endepunkt, ulike plattformer):

  • HubSpot — Workflow → Custom code action: send firmanavn/orgnr inn, kall AI-søket, skriv tilbake orgnr/bransje/omsetning på kontakten. Eksempelkode:
const rati = await fetch("https://rati.no/api/v1/ai/search", {
method: "POST",
headers: { "Content-Type": "application/json", "X-Rati-Key": process.env.RATI_API_KEY },
body: JSON.stringify({ query: inputs.firmanavn })
}).then(r => r.json());
// bruk rati.results[0].orgnr og rati.interpreted
  • Notion — via Zapier eller Make: HTTP-modul kaller endepunktet, treffene mappes inn som sider i en Notion-database (navn, orgnr, omsetning, profil-lenke)
  • Make / Zapier / n8n — samme mønster: HTTP-modul mot endepunktet, så utløs videre automasjon (HubSpot/Slack/Sheets)
  • Google Sheets — Apps Script per rad: UrlFetchApp.fetch() mot AI-søket, skr navn/orgnr/omsetning i kolonnene

Råd: cach svaret per organisasjonsnummer (søket varierer lite) slik at kvoten holder til år, ikke sekunder.

6

Vilkår (kildeangivelse + rettighet)

  • Data stammer fra offentlige kilder: krediter «Brønnøysundregistrene (NLOD) via rati.no» synlig i appen
  • Anmeldelser er brukerinnhold — aldri gjengi som fakta om bedriften
  • Økonomiske signaler er historisk regnskapsoppsummering — ikke kredittvurdering
  • Ingen registrering kreves, men ikke overbelast tjenesten: hold moderat hastighet og identifiser deg gjerne via User-Agent
  • Misbruk (bot-bombardement, salg av data videre uten lisens) kan få nøkkelen stengt
7

Regnskap og andre kilder

Datakilder og kvalitetsansvar: Datakilder. Ønsker du mer data (bulk/full profil-dump, custom endepunkter eller flat rate)? Kontakt [email protected] — vi setter opp kommercielle planer for virksomheter med større volum.