API pour les développeurs

findnix.eu API de recherche

L'API findnix.eu permet aux développeurs d'intégrer notre fonction de recherche dans leurs propres applications. L'API est gratuite et utilisable sans inscription.

URL de base

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

Paramètres

Exemple de requête

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

Exemple de réponse

{ "results": [ { "title": "Berlin — Wikipedia", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Berlin est la capitale...", "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 est la capitale et la plus grande ville d'Allemagne..." }

Valeurs de filtre

• web — Recherche web générale (SearXNG + Brave Search)
• news — Actualités récentes
• images — Images de Pexels + Openverse (fournit miniature, auteur, licence)
• videos — Vidéos de Pexels + SerpAPI
• science — Publications scientifiques (OpenAIRE + BASE, accès libre)
• culture — Patrimoine culturel européen via Europeana

Codes d'état HTTP

• 200 — Succès
• 400 — Terme de recherche invalide (trop court)
• 429 — Trop de requêtes (max. 30/minute)
• 503 — Backend de recherche inaccessible

Limites de taux

Maximum 30 requêtes par minute par session. Les résultats sont mis en cache pendant 1 heure — les requêtes identiques répétées ne comptent qu'une fois et sont plus rapides.

Remarques

• Aucune authentification requise
• Réponse toujours au format JSON (UTF-8)
• Veuillez définir un User-Agent significatif : MonApp/1.0 (contact@exemple.fr)
• Utilisation commerciale : veuillez demander au préalable

Des questions sur l'API ? Écrivez-nous : findnix@findnix.eu