API dla deweloperów

findnix.eu API wyszukiwania

API findnix.eu umożliwia deweloperom integrację naszej funkcji wyszukiwania w własnych aplikacjach. API jest darmowe i dostępne bez rejestracji.

Podstawowy URL

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

Parametry

Przykład żądania

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

Przykład odpowiedzi

{ "results": [ { "title": "Berlin — Wikipedia", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Berlin jest stolicą...", "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 jest stolicą i największym miastem Niemiec..." }

Wartości filtrów

• web — Ogólne wyszukiwanie w sieci (SearXNG + Brave Search)
• news — Aktualne wiadomości
• images — Obrazy z Pexels + Openverse (dostarcza miniatury, autora, licencję)
• videos — Filmy z Pexels + SerpAPI
• science — Publikacje naukowe (OpenAIRE + BASE, Open Access)
• kultura — Europejskie dziedzictwo kulturowe przez Europeana

Kody statusu HTTP

• 200 — Sukces
• 400 — Nieprawidłowy termin wyszukiwania (za krótki)
• 429 — Zbyt wiele zapytań (maks. 30/minutę)
• 503 — Backend wyszukiwania niedostępny

Limity zapytań

Maksymalnie 30 zapytań na minutę na sesję. Wyniki są buforowane przez 1 godzinę — powtarzające się te same zapytania liczą się tylko raz i są szybsze.

Uwagi

• Nie wymagana autoryzacja
• Odpowiedź zawsze w formacie JSON (UTF-8)
• Proszę ustawić znaczącego User-Agent: MojaAplikacja/1.0 (kontakt@przyklad.pl)
• Użytkowanie komercyjne: proszę o wcześniejsze zapytanie

Pytania dotyczące API? Napisz do nas: findnix@findnix.eu