API għall-Iżviluppaturi

findnix.eu API ta' tfittxija

L-API findnix.eu tippermetti lill-iżviluppaturi li jintegraw it-tfittxija tagħna f'apps tagħhom. L-API hija b'xejn u tista' tintuża mingħajr reġistrazzjoni.

URL Bażiku

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

Parametri

Eżempju ta' Talba

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

Eżempju ta' Risposta

{ "results": [ { "title": "Berlin — Wikipedia", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Berlin hija l-kapitali...", "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 hija l-kapitali u l-akbar belt tal-Ġermanja..." }

Valuri ta' Filtru

• web — Tfittxija Ġenerali tal-Web (SearXNG + Brave Search)
• aħbarijiet — Aħbarijiet Attwali
• immaġini — Immaġini minn Pexels + Openverse (tipprovdi thumbnail, awtur, liċenzja)
• vidjows — Vidjows minn Pexels + SerpAPI
• xjenza — Pubblikazzjonijiet Xjentifiċi (OpenAIRE + BASE, Open Access)
• kultura — Wirt Kulturali Ewropew permezz ta' Europeana

Kodiċijiet ta' Stati HTTP

• 200 — Suċċess
• 400 — Terminu tat-tfittxija mhux validu (ħafif wisq)
• 429 — Għadd ta' talbiet eċċessiv (max. 30/minuta)
• 503 — Backend tat-tfittxija mhux aċċessibbli

Limiti ta' Rata

Max 30 talbiet kull minuta kull sessjoni. Riżultati jiġu kċejnijin għal 1 siegħa — talbiet ripetuti li huma l-istess jikkontaw biss darba u huma aktar malajr.

Nota

• Ebda awtentikazzjoni meħtieġa
• Risposta dejjem bħala JSON (UTF-8)
• Jekk jogħġbok stabbilixxi User-Agent sinjifikanti: MeineApp/1.0 (kontakt@beispiel.de)
• Użu kummerċjali: jekk jogħġbok ikkuntattjana qabel

Domandi dwar l-API? Iktbilna: findnix@findnix.eu