API za razvijalce

findnix.eu Iskalna API

findnix.eu API omogoča razvijalcem, da integrirajo našo iskalno funkcijo v lastne aplikacije. API je brezplačen in dostopen brez registracije.

Osnovni URL

https://findnix.eu/api/search.php

Parametri

Primer zahteve

GET https://findnix.eu/api/search.php?q=Berlin&filter=web&lang=de&page=1

Primer odgovora

{ "results": [ { "title": "Berlin — Wikipedia", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Berlin je glavno mesto...", "domain": "de.wikipedia.org", "score": 85, "source": "searxng" } ], "total_count": 1000, "query": "Berlin", "page": 1, "filter": "web", "cache_hit": false, "response_ms": 342, "ai_summary": "Berlin je glavno mesto in največje mesto Nemčije..." }

Vrednosti filtrov

• web — Splošno iskanje po spletu (SearXNG + Brave Search)
• novice — Aktualne novice
• slike — Slike iz Pexels + Openverse (dostavlja sličico, avtorja, licenco)
• videoposnetki — Videoposnetki iz Pexels + SerpAPI
• znanost — Znanstvene publikacije (OpenAIRE + BASE, odprti dostop)
• kultura — Evropska kulturna dediščina preko Europeana

HTTP Status Kode

• 200 — Uspeh
• 400 — Neveljavna iskalna beseda (prekratka)
• 429 — Preveč zahtevkov (maks. 30/minuto)
• 503 — Iskalni strežnik ni dosegljiv

Omejitve hitrosti

Največ 30 zahtevkov na minuto na sejo. Rezultati se shranijo v predpomnilnik za 1 uro — ponovljeni enaki zahtevki se štejejo le enkrat in so hitrejši.

Opombe

• Avtentikacija ni potrebna
• Odgovor vedno v JSON formatu (UTF-8)
• Prosimo, nastavite informativen User-Agent: MojaAplikacija/1.0 (kontakt@primer.si)
• Komercialna uporaba: prosimo, da se predhodno pozanimate

Vprašanja o API? Pišite nam: findnix@findnix.eu