API kehittäjille

findnix.eu Hakupalvelu-API

findnix.eu API mahdollistaa kehittäjille hakutoimintomme integroimisen omiin sovelluksiinsa. API on ilmainen ja käytettävissä ilman rekisteröitymistä.

Perus-URL

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

Parametrit

Esimerkkipyyntö

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

Esimerkkivastaus

{ "results": [ { "title": "Berliini — Wikipedia", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Berliini on pääkaupunki...", "domain": "de.wikipedia.org", "score": 85, "source": "searxng" } ], "total_count": 1000, "query": "Berliini", "page": 1, "filter": "web", "cache_hit": false, "response_ms": 342, "ai_summary": "Berliini on Saksan pääkaupunki ja suurin kaupunki..." }

Suodatinarvot

• web — Yleinen verkkohaku (SearXNG + Brave Search)
• uutiset — Ajankohtaiset uutiset
• kuvat — Kuvat Pexelsilta + Openverselta (toimittaa pikkukuvan, tekijän, lisenssin)
• videot — Videot Pexelsilta + SerpAPI
• tiede — Tieteelliset julkaisut (OpenAIRE + BASE, Avoin pääsy)
• kulttuuri — Eurooppalainen kulttuuriperintö Europeanan kautta

HTTP Status-koodit

• 200 — Onnistuminen
• 400 — Virheellinen hakusana (liian lyhyt)
• 429 — Liikaa pyyntöjä (max. 30/minuutti)
• 503 — Hakuprosessi ei saavutettavissa

Rajoitukset

Enintään 30 pyyntöä minuutissa per istunto. Tulokset välimuistissa 1 tunti — toistuvat samat pyynnöt lasketaan vain kerran ja ovat nopeampia.

Huomautukset

• Ei vaadi todennusta
• Vastaus aina JSON-muodossa (UTF-8)
• Ole hyvä ja aseta informatiivinen User-Agent: MinunSovellus/1.0 (kontakt@esimerkki.fi)
• Kaupallinen käyttö: kysy ensin

Kysymyksiä API:sta? Kirjoita meille: findnix@findnix.eu