API fejlesztőknek

findnix.eu Keresési API

A findnix.eu API lehetővé teszi a fejlesztők számára, hogy integrálják keresési funkciónkat saját alkalmazásaikba. Az API ingyenes és regisztráció nélkül használható.

Alap URL

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

Paraméterek

Példa kérés

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

Példa válasz

{ "results": [ { "title": "Berlin — Wikipedia", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Berlin a főváros...", "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 a főváros és Németország legnagyobb városa..." }

Szűrő értékek

• web — Általános webes keresés (SearXNG + Brave Search)
• news — Aktuális hírek
• images — Képek a Pexels + Openverse (mini kép, szerző, licenc)
• videos — Videók a Pexels + SerpAPI
• science — Tudományos publikációk (OpenAIRE + BASE, Nyílt hozzáférés)
• kultur — Európai kulturális örökség az Europeana-n keresztül

HTTP állapotkódok

• 200 — Siker
• 400 — Érvénytelen keresési kifejezés (túl rövid)
• 429 — Túl sok kérés (max. 30/perc)
• 503 — Keresési háttér nem elérhető

Rate Limits

Maximálisan 30 kérés percenként egy munkamenetben. Az eredmények 1 órán át cache-elve vannak — az ismételt azonos kérések csak egyszer számítanak és gyorsabbak.

Megjegyzések

• Nincs szükség hitelesítésre
• A válasz mindig JSON formátumban (UTF-8)
• Kérjük, állítson be egy kifejező User-Agent-ot: MeineApp/1.0 (kontakt@beispiel.de)
• Kereskedelmi felhasználás: kérjük, előzetesen érdeklődjön

Kérdése van az API-val kapcsolatban? Írjon nekünk: findnix@findnix.eu