API pentru dezvoltatori

findnix.eu API de căutare

API-ul findnix.eu permite dezvoltatorilor să integreze funcția noastră de căutare în aplicațiile proprii. API-ul este gratuit și poate fi utilizat fără înregistrare.

URL de bază

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

Parametri

Exemplu de cerere

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

Exemplu de răspuns

{ "results": [ { "title": "Berlin — Wikipedia", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Berlin este capitala...", "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 este capitala și cel mai mare oraș din Germania..." }

Valori de filtrare

• web — Căutare generală pe web (SearXNG + Brave Search)
• știri — Știri actuale
• imagini — Imagini de la Pexels + Openverse (oferă thumbnail, autor, licență)
• videoclipuri — Videoclipuri de la Pexels + SerpAPI
• știință — Publicații științifice (OpenAIRE + BASE, Open Access)
• cultură — Patrimoniu cultural european prin Europeana

Coduri de stare HTTP

• 200 — Succes
• 400 — Termen de căutare invalid (prea scurt)
• 429 — Prea multe cereri (max. 30/minut)
• 503 — Backend de căutare inaccesibil

Limite de rată

Maxim 30 de cereri pe minut pe sesiune. Rezultatele sunt stocate în cache timp de 1 oră — cererile repetate sunt contabilizate o singură dată și sunt mai rapide.

Informații suplimentare

• Nu este necesară autentificarea
• Răspunsul este întotdeauna în format JSON (UTF-8)
• Vă rugăm să setați un User-Agent semnificativ: AplicațiaMea/1.0 (contact@exemplu.ro)
• Utilizare comercială: vă rugăm să solicitați înainte

Întrebări despre API? Scrieți-ne: findnix@findnix.eu