API pro vývojáře

findnix.eu Vyhledávací API

findnix.eu API umožňuje vývojářům integrovat naši vyhledávací funkci do vlastních aplikací. API je zdarma a bez registrace.

Základní URL

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

Parametry

Příklad požadavku

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

Příklad odpovědi

{ "results": [ { "title": "Praha — Wikipedia", "url": "https://cs.wikipedia.org/wiki/Praha", "description": "Praha je hlavní město...", "domain": "cs.wikipedia.org", "score": 85, "source": "searxng" } ], "total_count": 1000, "query": "Praha", "page": 1, "filter": "web", "cache_hit": false, "response_ms": 342, "ai_summary": "Praha je hlavní město a největší město České republiky..." }

Hodnoty filtrů

• web — Obecné vyhledávání na webu (SearXNG + Brave Search)
• zprávy — Aktuální zprávy
• obrázky — Obrázky z Pexels + Openverse (poskytuje náhled, autora, licenci)
• videa — Videa z Pexels + SerpAPI
• věda — Vědecké publikace (OpenAIRE + BASE, Open Access)
• kultura — Evropské kulturní dědictví prostřednictvím Europeana

HTTP Status kódy

• 200 — Úspěch
• 400 — Neplatný vyhledávací termín (příliš krátký)
• 429 — Příliš mnoho požadavků (max. 30/minutu)
• 503 — Vyhledávací backend není dostupný

Limity požadavků

Maximálně 30 požadavků za minutu na sezení. Výsledky se ukládají do mezipaměti na 1 hodinu — opakované stejné požadavky se počítají pouze jednou a jsou rychlejší.

Poznámky

• Žádná autentizace není vyžadována
• Odpověď vždy jako JSON (UTF-8)
• Prosím nastavte výstižný User-Agent: MojeAplikace/1.0 (kontakt@priklad.cz)
• Komerní využití: prosím předem se informujte

Dotazy k API? Napište nám: findnix@findnix.eu