API per sviluppatori

findnix.eu API di ricerca

L'API di findnix.eu consente agli sviluppatori di integrare la nostra funzione di ricerca nelle proprie applicazioni. L'API è gratuita e utilizzabile senza registrazione.

URL di base

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

Parametri

Richiesta di esempio

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

Risposta di esempio

{ "results": [ { "title": "Berlino — Wikipedia", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Berlino è la capitale...", "domain": "de.wikipedia.org", "score": 85, "source": "searxng" } ], "total_count": 1000, "query": "Berlino", "page": 1, "filter": "web", "cache_hit": false, "response_ms": 342, "ai_summary": "Berlino è la capitale e la città più grande della Germania..." }

Valori di filtro

• web — Ricerca web generale (SearXNG + Brave Search)
• news — Notizie attuali
• images — Immagini da Pexels + Openverse (fornisce thumbnail, autore, licenza)
• videos — Video da Pexels + SerpAPI
• science — Pubblicazioni scientifiche (OpenAIRE + BASE, Open Access)
• cultura — Patrimonio culturale europeo tramite Europeana

Codici di stato HTTP

• 200 — Successo
• 400 — Termine di ricerca non valido (troppo corto)
• 429 — Troppe richieste (max. 30/minuto)
• 503 — Backend di ricerca non raggiungibile

Limiti di richiesta

Massimo 30 richieste al minuto per sessione. I risultati vengono memorizzati nella cache per 1 ora — richieste ripetute identiche contano solo una volta e sono più veloci.

Note

• Nessuna autenticazione richiesta
• Risposta sempre in JSON (UTF-8)
• Si prega di impostare un User-Agent significativo: La miaApp/1.0 (contatto@esempio.it)
• Utilizzo commerciale: si prega di contattare prima

Domande sull'API? Scrivici: findnix@findnix.eu