Free News API: Αναζήτηση πλήρους κειμένου σε 21 εκατομμύρια άρθρα, 25.000 εκδότες και 100 χώρες — χωρίς καθόλου κλειδί

Οι υπηρεσίες ειδήσεων API συνήθως πωλούνται ανά αίτημα, κλειδώνονται πίσω από ένα κλειδί και περιορίζονται σε εκατό κλήσεις την ημέρα στην δωρεάν έκδοση. Η Free News API δεν είναι τίποτα από όλα αυτά: 21,5 εκατομμύρια άρθρα σε ένα κυλιόμενο παράθυρο 90 ημερών, πάνω από 25.000 εκδότες, χωρίς κλειδί, χωρίς εγγραφή, χωρίς όριο χρήσης, επιτρέπεται η εμπορική χρήση. Ακολουθεί ολόκληρη η επιφάνεια — αναζήτηση, στατιστικά, τάσεις, αγορές, ροές και MCP — καθώς και μια ειλικρινής ανάλυση του πού τα δεδομένα λανθάνουν.

Η μορφή του προβλήματος

Ρωτήστε έναν AI agent τι γράφεται αυτή τη στιγμή στον κόσμο και θα έχει τρεις κακές επιλογές. Μπορεί να σκαρφαλώνει απευθείας στους εκδότες, κάτι που είναι ευαίσθητο, αργό και νομικά ασαφές. Μπορεί να καλέσει μια εμπορική υπηρεσία ειδήσεων API, που σημαίνει λογαριασμό, κλειδί, μηνιαίο λογαριασμό και — σε κάθε δωρεάν έκδοση της αγοράς — εκατό αιτήματα την ημέρα και καθυστέρηση άρθρων κατά είκοσι τέσσερις ώρες. Ή μπορεί να μαντέψει από δεδομένα εκπαίδευσης που σταμάτησαν πριν από μήνες.

Το Free News API αφαιρεί το κόστος και τη γραφειοκρατία της μεσαίας επιλογής χωρίς να αφαιρέσει τις δυνατότητές της. Ένα αίτημα GET, χωρίς διαπιστευτήρια, πάνω σε ένα σώμα δεδομένων που τη στιγμή της συγγραφής περιείχε 21.557.044 άρθρα από περισσότερους από είκοσι πέντε χιλιάδες εκδότες, διατηρημένο σε ένα κυλιόμενο παράθυρο ενενήντα ημερών και ανανεωμένο συνεχώς — το νεότερο άρθρο στο ευρετήριο είναι συνήθως κάτω από δύο λεπτά.

Τέσσερα Βασικά Endpoints, και Μερικά Ακόμη

Ο πυρήνας της υπηρεσίας αποτελείται από τέσσερα GET endpoints, όλα υπό https://freenewsapi.ai, όλα επιστρέφοντάς σας UTF-8 JSON με Access-Control-Allow-Origin: * ώστε ο κώδικας του browser να μπορεί να τα καλέσει απευθείας, και όλα αναφέροντας τον χρόνο εξυπηρέτησης στο took_ms.

Γύρω από αυτό τον πυρήνα βρίσκονται άλλες τέσσερις οικογένειες, καθεμία από τις οποίες θα ήταν ένα προϊόν από μόνη της αλλού: trends (συστάδες ζωντανών ειδήσεων ανά χώρα), markets (σειρές τιμών σε σχέση με τον όγκο κάλυψης), crypto sentiment (ένα μπλοκ Bitcoin επτά σημείων) και syndication (η ίδια αναζήτηση ως RSS, Atom ή JSON Feed). Όλα αυτά καλύπτονται παρακάτω.

curl "https://freenewsapi.ai/v1/search?q=climate+summit&size=2"

{
  "took_ms": 41,
  "total": 1284,
  "total_is_lower_bound": false,
  "size": 2,
  "offset": 0,
  "results": [
    {
      "id": "9c1f8a4b2d3e5f6071829304a5b6c7d8",
      "url": "https://example-news.com/world/climate-summit-opens",
      "title": "Climate summit opens with a call for binding targets",
      "description": "Delegates from 190 countries gathered on Monday ...",
      "published_at": "2026-08-17T09:12:00Z",
      "crawled_at": "2026-08-17T10:48:31Z",
      "host": "example-news.com",
      "sitename": "Example News",
      "country": "GB",
      "country_source": "cctld",
      "lang": "en",
      "tld": "com"
    }
  ]
}

Τρία πεδία σε αυτή την απόκριση αξίζουν άμεση προσοχή, καθώς κωδικοποιούν την ειλικρίνεια του συνόλου των δεδομένων. Το total_is_lower_bound σας ενημερώνει πότε ο αριθμός των αντιστοιχιών έφτασε στο όριο των 10.000 και σταμάτησε να μετράει. Το country_source σας δείχνει πώς προσδιορίστηκε η χώρα — επειδή σε οποιοδήποτε σύνολο δεδομένων ειδήσεων, ένα μεγάλο μέρος των τιμών χώρας είναι συμπεράσματα (inferences), όχι γεγονότα. Και το crawled_at είναι η αξιόπιστη σφραγίδα χρόνου: οι εκδότες συνηθίζουν να οπισθοδρομούν την ημερομηνία published_at, αλλά ο χρόνος περιήγησης (crawl) ανατίθεται από τη γραμμή παραγωγής και κινείται μόνο προς τα εμπρός.

Αναζήτηση: Κάθε Παράμετρος που Μετράει

Όλες οι παράμετροι είναι προαιρετικές. Μια γυμνή κλήση επιστρέφει τα νεότερα άρθρα στον ευρετήριο.

Η ερώτηση (query)

• q Αντιστοιχίζεται με τον τίτλο (βαθμολογία 3), την περιγραφή (βαθμολογία 2) και το σώμα του άρθρου. Σημασιολογία AND — κάθε όρος πρέπει να είναι παρών, οπότε η προσθήκη μιας λέξης στενεύει αντί να διευρύνει το εύρος. Μέγιστο 500 χαρακτήρες.

Τα φίλτρα

Τα φίλτρα συνδυάζονται με AND μεταξύ παραμέτρων και OR εντός μιας παραμέτρου. Έτσι, το country=DE,AT&lang=de διαβάζεται ως "Άρθρα στα γερμανικά από τη Γερμανία ή την Αυστρία". Κάθε ένα δέχεται μια λίστα τιμών διαχωρισμένη με κόμμα, έως πενήντα.

Έλεγχος εξόδου

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=date&size=10"

curl "https://freenewsapi.ai/v1/search?q=merger&country=DE&date=48h&sort=date&size=20"

Μετρήσεις πριν την αναζήτηση

Το πιο αχρησιμοποίητο endpoint της υπηρεσίας είναι το /v1/stats. Συχνά, το χρήσιμο ερώτημα δεν είναι «ποια είναι τα άρθρα», αλλά «υπάρχει κάτι εδώ καθόλου και πού βρίσκεται». Η μέτρηση απαντά σε αυτό με κλάσμα του κόστους — περίπου διακόσια tokens έναντι αρκετών χιλιάδων για μια σελίδα αποτελεσμάτων — καθιστώντας το την σωστή πρώτη κλήση για έναν πράκτορα που αποφασίζει αν αξίζει να εκτελεστεί μια αναζήτηση.

curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"

Επιστρέφει μετρήσεις ανά χώρα, γλώσσα, TLD, εκδότη και ημέρα, υπολογισμένες σε ολόκληρο το ταιριαστό σύνολο και όχι μόνο στην τρέχουσα σελίδα. Αυτό είναι επίσης πώς μετράτε την κάλυψη πριν την εμπιστευτείτε. Η μη φιλτραρισμένη εικόνα κατά τη στιγμή της συγγραφής:

Κορυφαίες χώρες

Κύριες γλώσσες

Αγγλικά 5.513.650 · Ισπανικά 2.699.457 · Ρωσικά 1.785.796 · Τουρκικά 1.501.004 · Ιταλικά 992.200 · Γερμανικά 733.677 · Γαλλικά 689.136 · Αραβικά 664.016 · Πορτογαλικά 637.607 · Χίντι 560.840 · Ελληνικά 466.504 · Ιαπωνικά 427.085 · Βιετναμέζικα 385.719 · Ρουμανικά 358.766 · Κινεζικά 352.720 · Ουκρανικά 345.809 · Κορεάτικα 335.079 · Περσικά 268.126 · Πολωνικά 238.904 · Βουλγαρικά 183.204.

Αυτή η κατανομή αξίζει να τη μελετήσετε για μια στιγμή, γιατί είναι το αντίθετο από αυτό που σας παρέχουν τα περισσότερα ειδησεογραφικά APIs. Το συνήθες σώμα κειμένων, που δίνει προτεραιότητα στα αγγλικά και στις ΗΠΑ, δεν είναι αυτό: η Ινδία ξεπερνά τις Ηνωμένες Πολιτείες, τα τουρκικά ξεπερνούν τα γερμανικά, και τα ελληνικά, βιετναμέζικα, περσικά και βουλγαρικά έχουν όλα εκπροσώπηση με έξι ψηφία. Αν η ερώτησή σας αφορά μη αγγλόφωνο τύπο, αυτό είναι ένα υλικά διαφορετικό σύνολο δεδομένων.

Όγκος

Η ημερήσια καμπύλη στο by_day καλύπτει ολόκληρο το πεντηκονθήμερο παράθυρο. Οι πρόσφατες ημέρες κυμαίνονται περίπου 400.000 έως 700.000 άρθρες την ημέρα· νωρίτερα στο παράθυρο, πριν προστεθεί το RSS layer μαζί με την εισαγωγή του αρχείου, ο ημερήσιος όγκος ήταν 130.000–230.000. Και τα δύο μεγέθη είναι ορατά στην ίδια απόκριση, που είναι και το σημείο — η υπηρεσία σας δείχνει την δική της κλίση αντί να παραθέτει μια μάρκετινγκ μέση τιμή.

Τάσεις: Τι καλύπτει πραγματικά ο Τύπος αυτή τη στιγμή

Η αναζήτηση απαντά στο «τι γράφτηκε για το Χ». Οι τάσεις απαντούν σε μια διαφορετική και συχνά καλύτερη ερώτηση: "τι συμβαίνει" — χωρίς να απαιτείται κάποιο Χ.

Ένας αλγόριθος ομαδοποιεί άρθρα σε ιστορίες ανά χώρα και τις κρατά ενημερωμένες. Κάθε πέντε λεπτά νέα άρθρα προστίθενται σε γνωστές ιστορίες με βάση τα αναγνωριστικά τους λέξεις, χωρίς καμία κλήση μοντέλου· κάθε λίγες ώρες μια χώρα περνάει από μια πλήρη επεξεργασία όπου ένα γλωσσικό μοντέλο διαβάζει τους τίτλους και ονομάζει τις ιστορίες από την αρχή. Την στιγμή της συγγραφής, το layer τάσεων καλύπτει 115 χώρες, κάθε μία υπολογισμένη εκ νέου τις τελευταίες λίγες λεπτά.

curl "https://freenewsapi.ai/v1/trends?country=US&window=24h&size=5"

{
  "window": "24h",
  "filters": { "country": ["US"], "min_publishers": 1 },
  "trends": [
    {
      "title": "Hurricane Marie threatens Labor Day weather",
      "slug": "hurricane-marie-threatens-labor-day-weather",
      "country": "US",
      "category": "weather",
      "articles": 57,
      "publishers": 24,
      "first_seen": "2026-09-05T19:24:36Z",
      "latest": "2026-09-06T19:00:04Z",
      "url": "https://freenewsapi.ai/trends/us/hurricane-marie-…",
      "headlines": [ … ]
    }
  ]
}

Κάθε ιστορία συνοδεύεται από δύο μετρήσεις που έχουν διαφορετική σημασία. articles είναι η ένταση· publishers είναι η ευρεία κάλυψη. Μια ιστορία με 200 άρθρα από 4 εκδότες είναι η εμμονή ενός ειδησεογραφικού οίκου. Μια ιστορία με 60 άρθρα από 40 εκδότες είναι ένα γεγονός. Η προεπιλεγμένη ταξινόμηση είναι κατά publishers, και τα min_publishers / min_articles σας επιτρέπουν να ορίσετε το δικό σας όριο.

Οι ειδήσεις ανήκουν σε μία κατηγορία από ένα σταθερό σύνολο: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.

Το παράθυρο είναι η επιλογή του αναγνώστη, όχι του ρομπότ

Αυτή είναι μια πραγματικά κομψή σχεδιαστική επιλογή. Κάθε άρθρο αποθηκεύεται με τον χρόνο δημοσίευσής του και συνδέεται με την αντίστοιχη ειδήσεις, οπότε οποιοδήποτε παράθυρο — δεκαπέντε λεπτά, μία ώρα, μία μέρα, μια συγκεκριμένη ημερομηνία — είναι απλώς μια ερώτηση εύρεσης σε ένα εύρος πάνω στα ίδια αποθηκευμένα δεδομένα. Μία μόνο επεξεργασία εξυπηρετεί όλα τα παράθυρα ταυτόχρονα. Οι τιμές window=15m, window=1h, window=24h, date=2026-09-01 ή μια ρητή ζεύγη since/until λειτουργούν όλα εναντίον του ίδιου ευρετηρίου χωρίς επαναϋπολογισμό.

Λέξεις-κλειδιά: οι λέξεις πάνω στις οποίες χτίζεται η ειδησεογραφία

curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"

Κάθε λέξη-κλειδί επιστρέφει τον αριθμό των διακριτών ειδήσεων που την περιέχουν, τον αριθμό των άρθρων που περιέχουν αυτές τις ειδήσεις και — το πιο ενδιαφέρον στοιχείο — πόσες εθνικές εφημερίδες την χρησιμοποιούν. Αυτό το τελευταίο νούμερο είναι η διαφορά μεταξύ μιας παγκόσμιας και μιας εγχώριας είδησης. Μια λέξη που εμφανίζεται σε εβδομήντα χώρες είναι παγκόσμια είδηση· μια λέξη που κυριαρχεί στην εφημερίδα μιας χώρας είναι εγχώρια είδηση, όσο δυναμική κι αν είναι εκεί.

Ποιες χώρες είναι ζωντανές

curl "https://freenewsapi.ai/v1/trends/countries"

Επιστρέφει όλες τις παρακολουθούμενες χώρες με τον αριθμό των ζωντανών ειδήσεων τους και πόσα λεπτά πριν υπολογίστηκαν εκ νέου — Τουρκία, Ρωσία, Ιράν, Ελλάδα, Ινδία, Ιταλία, Ουκρανία, Ρουμανία, Αργεντινή, Γερμανία και Βραζιλία έχουν όλες τρέχοντα χιλιάδες ζωντανές ειδήσεις κάθε μία, υπολογισμένες εκ νέου τις τελευταίες δέκα λεπτά. Και η διαδρομή /v1/trends/{cc}/{slug} ανοίγει οποιαδήποτε μεμονωμένη είδηση με την πλήρη λίστα άρθρων της.

Αγορές έναντι Κάλυψης: Τιμή στον έναν άξονα, Προσοχή στον άλλο

Αυτό είναι το πιο ασυνήθιστο στοιχείο της υπηρεσίας, και υπάρχει επειδή το σώμα κειμένων καθιστά σχεδόν δωρεάν την κατασκευή του. Τοποθετήστε μια σειρά τιμών δίπλα στο πόσο έγραψε ο κόσμος γι' αυτό το πράγμα τις ίδιες ώρες, σε έναν κοινό χρονοδιάγραμμα.

curl "https://freenewsapi.ai/v1/markets"

Παρακολουθούνται δεκατέσσερα χρηματιστηριακά μέσα, σε τέσσερις κατηγορίες περιουσιακών στοιχείων:

curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"

Αυτή η μοναδική κλήση σας παρέχει το λιρά έναντι του δολαρίου και τον όγκο της κάλυψης από τον τουρκικό Τύπο για την ίδια περίοδο, συσχετισμένο ώρα με την ώρα. Ο τουρκικός Τύπος αποτελεί το τρίτο μεγαλύτερο τμήμα αυτού του συνόλου δεδομένων, γεγονός που εξηγεί ακριβώς γιατί αυτός ο συνδυασμός αποδίδει κάτι ουσιαστικό αντί για θόρυβο.

Και ένα πλήρες μπλοκ συναισθηματισμού για το Bitcoin

Το Bitcoin αποκτά μια οικογένεια επτά σημείων πρόσβασης, καθώς είναι το μόνο όργανο για το οποίο η συναισθηματική χροιά των ειδήσεων και η κίνηση της τιμής αμφισβητούνται συνεχώς και σπάνια μετρώνται:

Οι ετικέτες συναισθήματος προέρχονται από ένα μοντέλο γλώσσας που επεξεργάζεται τα πρόσφατα άρθρα κρυπτονομισμάτων κάθε πέντε λεπτά, σε συνδυασμό με μια βαθμονομημένη λίστα νομισμάτων. Το /v1/btc/correlation με την παράμετρο max_shift είναι αυτό που πρέπει να χρησιμοποιήσετε αν έχετε θέλει να ελέγξετε την ισχύ της υπόθεσης «τα νέα προκαλούν την κίνηση» αντί απλώς να την επαναλάβετε.

Η ίδια αναζήτηση, ως feed

Τρεις ακόμη ενότητες χρησιμοποιούν τους ίδιους παραμέτρους αναζήτησης και παρουσιάζουν τα αποτελέσματα σε μορφές syndication αντί για JSON:

• GET /v1/rss — RSS 2.0
• GET /v1/atom — Atom 1.0
• GET /v1/feed.json — JSON Feed 1.1

https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=date

Αυτό σημαίνει ότι οποιαδήποτε αποθηκευμένη αναζήτηση γίνεται ένα feed που μπορείτε να επικολλήσετε σε έναν αναγνώστη, σε ένα node του n8n, σε μια ενσωμάτωση του Slack, σε ένα trigger του Zapier ή σε έναν generator στατικών ιστοσελίδων — χωρίς κώδικα και χωρίς κλειδί. Είναι μια μικρή λειτουργία που αθόρυβα αφαιρεί ολόκληρο ένα στρώμα ενσωμάτωσης για μη προγραμματιστές.

MCP: Είκοσι οκτώ εργαλεία, δύο στρώματα

Ο διακομιστής MCP βρίσκεται σε ένα URL, υποστηρίζει Streamable HTTP (JSON-RPC 2.0 μέσω POST, έκδοση πρωτοκόλλου 2025-06-18), υποστηρίζει ομαδοποίηση αιτημάτων και — όπως όλα τα υπόλοιπα εδώ — δεν απαιτεί βήμα εξουσιοδότησης ούτε session id.

claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcp

Δημοσιεύει 28 εργαλεία σε δύο σκόπιμα στρώματα.

Στρώμα ένα: έξι συντομεύσεις που απαντούν σε μια ολοκληρωμένη ερώτηση με μία κλήση

Στρώμα δύο: κάθε endpoint, που δημιουργείται από την ίδια την υπηρεσία

Πίσω από τις συντομεύσεις, κάθε raw endpoint εκτίθεται ως ξεχωριστό εργαλείο με κάθε παράμετρο που δέχεται το API — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, ολόκληρη η οικογένεια news_get_btc_*, οι renderers feeds και news_get_health. Αυτά δημιουργούνται από την ζωντανή υπηρεσία, οπότε δεν μπορεί να αποκλίνουν από αυτό που δέχεται πραγματικά το API.

Δύο meta-tools κλείνουν τον κύκλο: το news_list_endpoints επιστρέφει τον κατάλογο όλων όσων υπάρχουν, και το news_get εκτελεί ένα raw GET σε οποιοδήποτε path — έτσι ώστε ένας agent που συναντήσει ένα endpoint που δεν καλύπτεται από τη λίστα των εργαλείων του, να μπορεί να το φτάσει.

curl "https://freenewsapi.ai/mcp?format=json"

Ένα GET, χωρίς χειραψία, και έχετε ολόκληρο τον μηχανικά αναγνώσιμο κατάλογο: server, transport, protocol, πλήθος εργαλείων, κάθε εργαλείο με την περιγραφή του, και κάθε endpoint με τη λίστα των παραμέτρων του.

Κτισμένο για να διαβάζεται από Μηχανές

Η τεκμηρίωση δεν είναι μια σκέψη-προς-το-τέλος που κολλήθηκε πάνω στο API — είναι μια πρώτης τάξεως έξοδος του. Ο ιστότοπος περιέχει 667 στατικές σελίδες, και μερικές από αυτές υπάρχουν ειδικά ώστε ένα μοντέλο να μην χρειάζεται να διαβάσει HTML:

• /openapi.json Το πλήρες σχήμα OpenAPI.
• /llms.txt Ένα σύντομο αρχείο καθοδήγησης — τι είναι η υπηρεσία, τα σημεία τερματισμού, πώς να κάνετε αποτελεσματικές κλήσεις API και πληροφορίες για τα σφάλματα.
• /llms-full.txt Ολόκληρη η τεκμηρίωση ως ένα αρχείο απλού κειμένου, άνω των εκατό χιλιάδων bytes, ώστε ένας πράκτορας να μπορεί να καταναλώσει το σύνολο του εγχειριδίου σε μία μόνο λήψη.
• /agents Τριάντα εννέα σελίδες σχεδιασμένες ειδικά για τους κατασκευαστές πράκτορων: έτοιμες ορισμένες συναρτήσεις OpenAI, ορισμένες χρήσης εργαλείων Anthropic, συστήματα εντολών για ανάκτηση ειδήσεων, συνταγές RAG, πίνακες κόστους tokens και συνταγές για πράκτορες.
• /agents/models Κώδικας κλήσης εργαλείων ανά οικογένεια μοντέλων — Qwen, DeepSeek, MiniMax, Kimi, GLM, Doubao, Hunyuan, ERNIE, Yi, Step, GPT, Claude, Gemini, Grok, Mistral, Llama, Command, Nova, Phi, Jamba, Sonar, OpenRouter, Ollama, vLLM.
• /data Τι περιέχεται στο σώμα δεδομένων, η μεθοδολογία, το σχήμα του ευρετηρίου και μια σελίδα με τίτλο Ποιότητα Δεδομένων που τεκμηριώνει τι κάνει λάθος το σύνολο δεδομένων.
• /sources Ένα διαδραστικό κατάλογο 11.668 εκδοτών, με δυνατότητα φιλτραρίσματος ανά χώρα, γλώσσα και ζώνη ονομασιών τομέα.
• /compare Σελίδες σύγκρισης με τα NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube και FreeNewsAPI.io.

Πλέον 168 σελίδες χωρών, 121 σελίδες γλωσσών και 275 σελίδες TLD — μία περιηγήσιμη επιφάνεια ανά τμήμα του συνόλου δεδομένων, η οποία δείχνει τι περιέχεται πραγματικά σε αυτό.

Προέλευση των Άρθρων

Δύο μονοπάτια λήψσης τρέφουν τον ίδιο ευρετήριο, και η διαφορά μεταξύ τους έχει σημασία.

Το μονοπάτι αρχείου

Κάθε δέκα λεπτά μια εργασία ελέγχει το αρχείο CC-NEWS του Common Crawl για νέα αρχεία WARC και επεξεργάζεται ό,τι δεν έχει δει προηγουμένως, χρησιμοποιώντας σαράντα παράλληλους εργαζόμενους. Ο εξαγωγέας εξάγει κάθε άρθρο από το ακατέργαστο crawl με ένα τεκμηριωμένο ιεραρχικό σύστημα ανά πεδίο — και τα ιεραρχικά συστήματα μετρήθηκαν με βάση πραγματικά δεδομένα αντί να υποθέτονται:

Αυτή η τιμή χώρας είναι η ειλικρινής, και γι' αυτό το πεδίο country_source εκτίθεται σε κάθε άρθρο: περίπου το ένα πέμπτο των εγγραφών δεν διαθέτει αξιόπιστο σήμα χώρας καθόλου, και περίπου το ένα τρίτο των τιμών που υπάρχουν είναι εξαγωγές (inferences) αντί για πραγματικά δεδομένα. Το API σας δείχνει ποιο είναι ποιο, αντί να υποκρίνεται.

Η ζωντανή ροή

Ένας δεύτερος ρομπότ ελέγχει τα feeds RSS των εκδόσεων κάθε πέντε λεπτά, σε εναλλαγή με συνθήματες αιτήσεις — ένα feed που απαντά 304 Not Modified κοστίζει σχεδόν τίποτα, και το διάστημα ελέγχου κάθε feed ρυθμίζεται ανάλογα με το πόσο συχνά δημοσιεύει πραγματικά. Μια έκδοση που δημοσιεύει πέντε άρθρες την ημέρα δεν ελέγχεται κάθε δεκαπέντε λεπτά.

Επίσης, παίρνει μόνο αυτό που έβαλε ο εκδότης στο feed: τίτλο, περίληψη και πλήρες κείμενο όταν το feed το περιλαμβάνει. Δεν περιηγάγεται στην ιστοσελίδα του εκδότη για να βρει περισσότερα. Αυτό είναι μια σκόπιμη οριοθέτηση, και γι' αυτό η υπηρεσία μπορεί να κάνει τις υποσχέσεις που κάνει στη νομική της σελίδα για τους εκδότες.

Κι ο μηχανισμός γύρω από αυτά

Γύρω από τα δύο μονοπάτια εισαγωγής βρίσκονται μια δεκάδα ακόμη ρομπότ σε προγραμματισμένους κύκλους: ανακάλυπη πηγών και συγχρονισμός, ανάλυση χώρας ανά τομέα, κατασκευή και έλεγχος τάσεων, συμπλήρωση λέξεων-κλειδιών, συναισθηματισμός κρυπτονομισμάτων, έλξεις αγοράς, κατάλογος ταξινομήσεων, διατήρηση (το παράθυρο ενενήντα ημερών επιβάλλεται από μια νυχτερινή ερώτηση στο published_at, όχι από την ηλικία του ευρετηρίου), επαλήθευση ημέρας, επανελέγχους κενών άρθρων, και μια ασπίδα υγείας που επανεκκινεί οτιδήποτε έχει σταματήσει. Το σώμα δεδομένων (corpus) ζει σε ένα εξειδικευμένο cluster Elasticsearch.

Τι Λάθος Κάνει Αυτό το Σύνολο Δεδομένων

Η υπηρεσία δημοσιεύει τα δικά της περιορισμούς, που είναι ο ταχύτερος τρόπος να κρίνετε αν ταιριάζει στο πρόβλημά σας.

• Η χώρα είναι εξαγωγή (inferred) Διαβάστε το country_source σε κάθε άρθρο, και προσθέστε strict_country=true όταν μετράτε ανά χώρα αντί για περιήγηση.
• Το published_at παρέχεται από τον εκδότη Η οπισθοχρονολόγηση είναι συνηθισμένη. Ταξινομήστε κατά crawled όταν ελέγχετε για νέα περιεχόμενα.
• Το total ορίζεται στα 10.000 Για ταχύτητα. Το total_is_lower_bound σας λέει όταν φτάσατε στο όριο.
• Κανένας συναισθηματισμός ή εξαγωγή οντοτήτων Εκτός από το block του Bitcoin, τα άρθρα δεν φέρουν βαθμό συναισθηματισμού και κανένα ονόμαζο οντότητα. Αυτό δεν εμπίπτει στο πεδίο εφαρμογής.
• Ενενήντα ημέρες, όχι παραπάνω Δεν υπάρχει πιο βαθύ αρχείο. Αν χρειάζεστε το 2019, αυτό είναι το λάθος εργαλείο.
• Χωρίς SLA Είναι δωρεάν. Επίσης παρακολουθείται και φυλάσσεται, αλλά δεν υπόσχεται κάτι γραπτώς.
• Το κείμενο ανήκει στους εκδότες Κάθε απάντηση περιλαμβάνει το αρχικό URL, ενώ οι καλούντες αναμένεται να συνδέονται προς αυτό.

Σωστή χρήση: Κόστος, σελιδοποίηση και σφάλματα

Πειθαρχία tokens

Για έναν πράκτορα, το μέγεθος της απάντησης είναι το πραγματικό κόστος. Η τεκμηριωμένη μορφή του:

Είκοσι άρθρα με full_text=true αντιστοιχούν περίπου σε 40.000 tokens. Το συνιστώμενο μοτίβο είναι πάντα το ίδιο: μετρήστε, σαρώστε και κατόπιν φέρτε τα κείμενα μόνο για όσα χρειάζεστε.

Παράκαμψη του ορίου σελιδοποίησης

Η παράμετρος offset σταματά στα 9.900. Για να περιηγηθείτε σε μεγάλο σύνολο δεδομένων, μην προσπαθείτε να υπερβείτε το όριο — κόψτε τα δεδομένα με βάση τον χρόνο. Επαναλάβετε την διαδικασία ημέρα με την ημέρα, ή ώρα με την ώρα σε έντονα φορτισμένα ερωτήματα, χρησιμοποιώντας τις παραμέτρους from/to και sort=date. Η τεκμηρίωση διαθέτει ειδική σελίδα για την περιήγηση σε ολόκληρη μια ημέρα.

Σφάλματα

Η σύμβαση είναι απλή και εύκολη στην υλοποίηση: 4xx σημαίνει ότι το αίτημα είναι λανθασμένο — διορθώστε το, μην κάνετε επαναπροσπάθεια. 5xx σημαίνει ότι η υπηρεσία είναι εκτός λειτουργίας — μειώστε τον ρυθμό αιτημάτων. 429 σημαίνει να επιβραδύνετε και να κάνετε επαναπροσπάθεια. Οι άγνωστες παραμέτροι ερωτήματος αγνοούνται αντί να απορρίπτονται, οπότε η προσθήκη μιας παραμέτρου δεν μπορεί ποτέ να καταστρέψει έναν υπάρχοντα πελάτη.

Ταυτοποιηθείτε (Προαιρετικό, και πραγματικά προαιρετικό)

Χωρίς κλειδί, δεν υπάρχει τρόπος να εντοπιστεί ο καλούν. Η προτεινόμενη ευγένεια είναι μια κεφαλίδα που ονομάζει τον πράκτορά σας, το πλαίσιο μέσω του οποίου τρέχει και το μοντέλο που τον τροφοδοτεί:

X-Agent: agent_name=<agent>; software=<langchain|llamaindex|n8n|claude-desktop|cursor|openai-assistants|crewai|custom>; model=<model>; version=<v>; purpose=<rag|monitoring|research|digest>; contact=<url or mailto>
User-Agent: <agent>/<version> (+<contact url>)

Οι ίδιες τιμές λειτουργούν και ως απλές παράμετροι ερωτήματος, κάτι που συνήθως είναι πιο εύκολο:

https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4o

Τα άγνωστα κλειδιά αγνοούνται, οπότε η αποστολή επιπλέον κλειδιών είναι πάντα ασφαλής. Καμία παράμετρος δεν επαληθεύεται, κανένας δεν επιβραδύνεται λόγω της απουσίας της, και η μία και μοναδική οδηγία είναι σαφής: ποτέ μην τοποθετείτε προσωπικά δεδομένα τελικών χρηστών σε αυτά τα πεδία.

Κατά των Πληρωμένων Ειδήσεων APIs

Οι σελίδες σύγκρισης στην ιστοσελίδα καλύπτουν εννέα ανταγωνιστές μεμονωμένα. Οι δομικές διαφορές που επιβιώνουν σε όλες τις περιπτώσεις:

Τι παρέχουν ακόμη οι αμοιβόμενες υπηρεσίες που δεν προσφέρει αυτό το εργαλείο: μετρήσεις συναισθήματος (sentiment scores) και εξαγωγή οντοτήτων ως τυπικά πεδία, αρχεία που καλύπτουν χρόνια πίσω, καθώς και σύμβαση με SLA. Αυτά είναι πραγματικά πλεονεκτήματα και αν τα χρειάζεστε, θα πρέπει να τα αγοράσετε.

Συνταγές

Ζωντανός παρακολούθησης χώρας

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"

Είναι αυτή η ιστορία παγκόσμια ή εσωτερική;

curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world event

Εκπαίδευση μοντέλου με τρέχουσα κάλυψη, με χαμηλό κόστος

# 1. count first
curl "https://freenewsapi.ai/v1/stats?q=semiconductor+export+controls&date=7d"
# 2. scan metadata
curl "https://freenewsapi.ai/v1/search?q=semiconductor+export+controls&date=7d&lang=en&size=20&sort=relevance"
# 3. fetch bodies for the three you picked
curl "https://freenewsapi.ai/v1/article?url=<exact-url>&full_text=true"

Η κάλυψη οδηγεί την τιμή;

curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"

Μετατροπή μιας αποθηκευμένης αναζήτησης σε feed

https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50

Βρείτε τις πηγές που έχουν σημασία σε μια αγορά

curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that slice

Η Σύντομη Έκδοση

Το Free News API είναι πλήρης αναζήτηση κειμένου σε πάνω από 21,5 εκατομμύρια ειδησεογραφικά άρθρα από περισσότερους από 25.000 εκδότες σε 100 χώρες και περίπου 100 γλώσσες, σε ένα συνεχώς ανανεούμενο παράθυρο 90 ημερών, χωρίς κλειδί API, χωρίς εγγραφή και χωρίς όριο χρήσης πέρα από ένα όριο ρυθμού ανά IP. Πάνω από την αναζήτηση, παρέχεται ζωντανή ομαδοποίηση ειδήσεων ανά χώρα σε 115 χώρες, ανάλυση λέξεων-κλειδιών που διαχωρίζει τα παγκόσμια γεγονότα από τα εγχώρια, χαρτογράφηση δεκατεσσάρων χρηματιστηριακών μέσων έναντι του όγκου κάλυψης, ένα μπλοκ συναισθήματος για το Bitcoin επτά άκρων, RSS/Atom/JSON syndication για οποιαδήποτε ερώτηση, και ένας MCP server 28 εργαλείων που δημιουργήθηκε από την ίδια την υπηρεσία.

Τεκμηριώνει τους δικούς του συντελεστές σφάλματος, αποκαλύπτει πώς προέκυψε κάθε τιμή χώρας και δημοσιεύει μια σελίδα για το πού λανθάνουν τα δεδομένα. Για έναν πράκτορα που χρειάζεται να γνωρίζει τι λέγεται στον κόσμο — στα Τουρκικά, στα Ελληνικά, στα Χίντι, αυτή τη στιγμή — αυτή η συνδυασμένη προσφορά είναι δύσκολο να βρεθεί σε οποιαδήποτε τιμή, και η παρούσα είναι δωρεάν.

Η αναζήτηση λειτουργεί με ΛΟΓΙΚΟ ΚΑΙ (AND) για όλους τους όρους. Χρησιμοποιήστε 2–5 λέξεις-κλειδιά, όχι μια ερώτηση σε φυσική γλώσσα.

Το Free News API, για το πώς να το χρησιμοποιείτε σωστά

Ξεκινήστε εδώ: freenewsapi.ai · MCP στο freenewsapi.ai/mcp · ολόκληρο το εγχειρίδιο ως ένα αρχείο στο /llms-full.txt.