API pre vývojárov

findnix.eu Vyhľadávacia API

findnix.eu API umožňuje vývojárom integrovať našu vyhľadávaciu funkciu do vlastných aplikácií. API je bezplatné a bez registrácie.

Základná URL

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

Parametre

Príklad požiadavky

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

Príklad odpovede

{ "results": [ { "title": "Berlín — Wikipedia", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Berlín je hlavné mesto...", "domain": "de.wikipedia.org", "score": 85, "source": "searxng" } ], "total_count": 1000, "query": "Berlín", "page": 1, "filter": "web", "cache_hit": false, "response_ms": 342, "ai_summary": "Berlín je hlavné mesto a najväčšie mesto Nemecka..." }

Hodnoty filtrov

• web — Všeobecné vyhľadávanie na webe (SearXNG + Brave Search)
• správy — Aktuálne správy
• obrázky — Obrázky z Pexels + Openverse (poskytuje náhľad, autora, licenciu)
• videá — Videá z Pexels + SerpAPI
• veda — Vedecké publikácie (OpenAIRE + BASE, Open Access)
• kultúra — Európske kultúrne dedičstvo cez Europeana

HTTP Status kódy

• 200 — Úspech
• 400 — Neplatný vyhľadávací termín (príliš krátky)
• 429 — Príliš veľa požiadaviek (max. 30/minúta)
• 503 — Vyhľadávací backend nie je dostupný

Obmedzenia rýchlosti

Maximálne 30 požiadaviek za minútu na reláciu. Výsledky sú cachované 1 hodinu — opakované rovnaké požiadavky sa počítajú len raz a sú rýchlejšie.

Poznámky

• Nie je potrebná autentifikácia
• Odpoveď vždy vo formáte JSON (UTF-8)
• Prosím, nastavte výstižný User-Agent: MojaAplikácia/1.0 (kontakt@priklad.sk)
• Komercionalne využitie: prosím, najprv sa opýtajte

Otázky k API? Napíšte nám: findnix@findnix.eu