API για προγραμματιστές

findnix.eu Αναζήτηση-API

Η API findnix.eu επιτρέπει στους προγραμματιστές να ενσωματώσουν τη λειτουργία αναζήτησης μας σε δικές τους εφαρμογές. Η API είναι δωρεάν και διαθέσιμη χωρίς εγγραφή.

Βασική URL

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

Παράμετροι

Παράδειγμα Αίτησης

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

Παράδειγμα Απόκρισης

{ "results": [ { "title": "Berlin — Wikipedia", "url": "https://de.wikipedia.org/wiki/Berlin", "description": "Το Βερολίνο είναι η πρωτεύουσα...", "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": "Το Βερολίνο είναι η πρωτεύουσα και η μεγαλύτερη πόλη της Γερμανίας..." }

Τιμές Φίλτρου

• web — Γενική αναζήτηση στο διαδίκτυο (SearXNG + Brave Search)
• news — Τρέχουσες ειδήσεις
• images — Εικόνες από Pexels + Openverse (παρέχει thumbnail, author, license)
• videos — Βίντεο από Pexels + SerpAPI
• science — Επιστημονικές δημοσιεύσεις (OpenAIRE + BASE, Open Access)
• culture — Ευρωπαϊκή πολιτιστική κληρονομιά μέσω της Europeana

HTTP Status-Codes

• 200 — Επιτυχία
• 400 — Μη έγκυρος όρος αναζήτησης (πολύ σύντομος)
• 429 — Πάρα πολλές αιτήσεις (μέγιστο 30/λεπτό)
• 503 — Αναζήτηση-Backend μη διαθέσιμο

Όρια Ρυθμού

Μέγιστο 30 αιτήσεις ανά λεπτό ανά συνεδρία. Τα αποτελέσματα αποθηκεύονται για 1 ώρα — οι επαναλαμβανόμενες ίδιες αιτήσεις μετράνε μόνο μία φορά και είναι ταχύτερες.

Σημειώσεις

• Δεν απαιτείται πιστοποίηση
• Η απάντηση είναι πάντα σε JSON (UTF-8)
• Παρακαλώ ορίστε έναν κατατοπιστικό User-Agent: MeineApp/1.0 (kontakt@beispiel.de)
• Εμπορική χρήση: παρακαλώ ρωτήστε πριν

Έχετε ερωτήσεις σχετικά με την API; Γράψτε μας: findnix@findnix.eu