API izstrādātājiem

findnix.eu Meklēšanas API

findnix.eu API ļauj izstrādātājiem integrēt mūsu meklēšanas funkciju savās lietotnēs. API ir bezmaksas un pieejama bez reģistrācijas.

Bāzes URL

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

Parametri

Parauga pieprasījums

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

Parauga atbilde

{ "results": [ { "title": "Berlīne — Vikipēdija", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Berlīne ir galvaspilsēta...", "domain": "de.wikipedia.org", "score": 85, "source": "searxng" } ], "total_count": 1000, "query": "Berlīne", "page": 1, "filter": "web", "cache_hit": false, "response_ms": 342, "ai_summary": "Berlīne ir galvaspilsēta un lielākā pilsēta Vācijā..." }

Filtra vērtības

• web — Vispārēja tīmekļa meklēšana (SearXNG + Brave Search)
• ziņas — Aktuālās ziņas
• attēli — Attēli no Pexels + Openverse (nodrošina sīktēlu, autoru, licenci)
• video — Video no Pexels + SerpAPI
• zinātne — Zinātniskās publikācijas (OpenAIRE + BASE, Open Access)
• kultūra — Eiropas kultūras mantojums caur Europeana

HTTP Statusa kodi

• 200 — Veiksmīgi
• 400 — Nepareizs meklēšanas vārds (pārāk īss)
• 429 — Pārāk daudz pieprasījumu (max. 30/minūtē)
• 503 — Meklēšanas aizmugure nav pieejama

Ātruma ierobežojumi

Maksimāli 30 pieprasījumi minūtē uz sesiju. Rezultāti tiek kešoti 1 stundu — atkārtoti vienādi pieprasījumi tiek skaitīti tikai vienu reizi un ir ātrāki.

Piezīmes

• Nav nepieciešama autentifikācija
• Atbilde vienmēr kā JSON (UTF-8)
• Lūdzu, iestatiet izsmeļošu lietotāja aģentu: ManaLietotne/1.0 (kontakt@piemērs.lv)
• Komercdarbība: lūdzu, iepriekš jautājiet

Jautājumi par API? Rakstiet mums: findnix@findnix.eu