API kūrėjams

findnix.eu Paieškos API

findnix.eu API leidžia kūrėjams integruoti mūsų paieškos funkciją į savo programas. API yra nemokama ir be registracijos.

Pagrindinis URL

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

Parametrai

Pavyzdinė užklausa

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

Pavyzdinė atsakymas

{ "results": [ { "title": "Berlynas — Wikipedia", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Berlynas yra sostinė...", "domain": "de.wikipedia.org", "score": 85, "source": "searxng" } ], "total_count": 1000, "query": "Berlynas", "page": 1, "filter": "web", "cache_hit": false, "response_ms": 342, "ai_summary": "Berlynas yra sostinė ir didžiausias miestas Vokietijoje..." }

Filtrų vertės

• web — Bendroji interneto paieška (SearXNG + Brave Search)
• naujienos — Dabartinės naujienos
• vaizdai — Vaizdai iš Pexels + Openverse (teikia miniatiūrą, autorių, licenciją)
• vaizdo įrašai — Vaizdo įrašai iš Pexels + SerpAPI
• mokslas — Moksliniai leidiniai (OpenAIRE + BASE, Atviras prieinamumas)
• kultūra — Europos kultūros paveldas per Europeana

HTTP Status kodai

• 200 — Sėkmė
• 400 — Neteisingas paieškos terminas (per trumpas)
• 429 — Per daug užklausų (maks. 30/min)
• 503 — Paieškos backend'as nepasiekiamas

Užklausų limitai

Maksimaliai 30 užklausų per minutę per sesiją. Rezultatai saugomi 1 valandą — pakartotinės tos pačios užklausos skaičiuojamos tik vieną kartą ir yra greitesnės.

Pastabos

• Nereikia autentifikacijos
• Atsakymas visada JSON formatu (UTF-8)
• Prašome nustatyti aiškų vartotojo agentą: ManoProgramėlė/1.0 (kontakt@pavyzdys.lt)
• Komercinis naudojimas: prašome prieš tai pasiteirauti

Klausimai dėl API? Rašykite mums: findnix@findnix.eu