שירותי חדשות API נמכרים בדרך כלל לפי בקשה, נחסים מאחורי מפתח, ומוגבלים למאה קריאות ביום בתוכנית החינמית. Free News API אינו עושה אף אחד מהדברים האלה: 21.5 מיליון מאמרים על פני חלון גלגלתי של 90 יום, למעלה מ-25,000 מוציאים לאור, ללא מפתח, ללא הרשמה, ללא מכסה, עם אישור לשימוש מסחרי. הנה כל שטח הפנים — חיפוש, סטטיסטיקות, מגמות, שווקים, הזרמות ו-MCP — ותיאור כן של מה שהנתונים טועים לגביו.
צורת הבעיה
תשאל סוכן AI על מה העולם כותב כרגע ויש לו שלוש אפשרויות גרועות. הוא יכול לגרד (scrape) מוציאים לאור ישירות, מה ששביר, איטי ומטושטש מבחינה משפטית. הוא יכול לקרוא לשירות חדשות API מסחרי, מה שאומר חשבון, מפתח, חשבון חודשי ו— בתוכנית חינמית כלשהי בשוק — מאה בקשות ביום ומאמרים עם עיכוב של עשרים וארבע שעות. או שהוא יכול לנחש מתוך נתוני אימון שהסתיימו לפני חודשים.
Free News API מסיר את המחיר והניירת של האפשרות האמצעית מבלי להסיר את היכולת שלה. בקשת GET אחת, ללא אישורים, מעל קורפוס שברגע הכתיבה מכיל 21,557,044 מאמרים מלמעלה מ-25,000 מוציאים לאור, שמאוחסנים בחלון גלגלתי של תשעים יום ומתעדכנים ברציפות — המאמר החדש ביותר במדד הוא בדרך כלל בן פחות משתי דקות.
ארבע נקודות קצה ליבה, ועוד
ליבת השירות היא ארבע נקודות קצה GET, כולן תחת https://freenewsapi.ai, כולן מחזירות נתונים ב-UTF-8 בפורמט JSON עם הכותרת Access-Control-Allow-Origin: * כדי שאפשר יהיה לקרוא להן ישירות מקוד דפדפן, וכולן מדווחות על זמן השרת בשדה took_ms.
| נקודת קצה | מה היא עונה עליו |
|---|---|
GET /v1/search | חיפוש טקסט מלא עם מסננים. נקודת הקצה שבה תשתמשו ב-95% מהזמן. |
GET /v1/stats | ספירות מצטברות לכל חתך נתונים — לפי מדינה, שפה, סיומת TLD, מוציא לאור ויום. |
GET /v1/article | מאמר אחד לפי ה-URL המדויק שלו, כולל גוף הטקסט המלא. |
GET /health | סטטוס חיים (Liveness) יחד עם ספירת המסמכים הנוכחית. זול מספיק לבדיקה תכופה (Polling). |
סביב ליבה זו נמצעות ארבע משפחות נוספות, שלכל אחת מהן פוטנציאל להיות מוצר בפני עצמו במקומות אחרים: מגמות (אשכולות סיפורים בזמן אמת לפי מדינה), שוקים (סדרות מחירים המיושרות מול נפח הכיסוי), רגישות למטבעות קריפטו (בלוק ביטקוין בעל שבע נקודות קצה), ו-סינדיקציה (אותו חיפוש המוצג כ-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) מוקצה על ידי צינור הנתונים (Pipeline) ורק מתקדם קדימה.
חיפוש: כל פרמטר שחשוב
כל הפרמטרים הם אופציונליים. קריאה בסיסית מחזירה את המאמרים החדשים ביותר במדד (Index).
השאילתה
- q מתאימה כנגד כותרת (משקל 3), תיאור (משקל 2) וגוף המאמר. סמנטיקת AND — כל מונח חייב להיות נוכח, כך שהוספת מילה מצמצמת ולא מרחיבה את התוצאות. מקסימום 500 תווים.
opec production cut יחזיר תוצאות. what did OPEC decide about oil יחזיר אפס תוצאות.המסננים
מסננים משתלבים עם AND בין פרמטרים ו-OR בתוך פרמטר אחד. כך country=DE,AT&lang=de נקרא כ"מאמרים בשפה הגרמנית מגרמניה או אוסטריה". כל אחד מקבל רשימה מופרדת בפסיקים של עד חמישים ערכים.
| מסנן | פורמט | הערות |
|---|---|---|
country | ISO 3166-1 alpha-2, באותיות גדולות | מדינת המוציא לאור. נגזר, לא מוצהר — ראו country_source ו-strict_country. |
lang | ISO 639-1, באותיות קטנות | זוהה מתוך המסמך עצמו. כיסוי של 99.9%. |
tld | ללא נקודה | אזור הדומיין של המוציא לאור. tld=ua הוא עובדה; country=UA הוא מסקנה. |
host | שמות מארח מדויקים | כפי שהם מופיעים ב-URL — כלול את www. אם המוציא לאור משתמש בו. |
date | היום · אתמול · 24 שעות · 48 שעות · 7 ימים · 30 ימים | תקופה קבועה מראש, המוערכת מול published_at. |
from / to | תאריכים בפורמט ISO | חלון מוגדר מראש שבו הקבועים אינם מתאימים. |
strict_country | true/false | ספור רק מאמרים שבהם המדינה היא עובדה מוחלטת ולא מסקנה. |
בקרת פלט
| פרמטר | ערכים | אפקט |
|---|---|---|
sort | date · date_asc · crawled · crawled_asc · relevance | מיין לפי crawled בעת איסוף מאמרים חדשים — מפרסמים מחזירים אחורה את תאריכי הפרסום; זמן הגלישה (crawl) מתקדם רק קדימה. |
size | 1–100 | תוצאות לעמוד. |
offset | 0–9900 | הזזת דפדוף. |
full_text | true/false | כלול את גוף המאמר. ברירת המחדל היא כבוי. |
highlight | true/false | החזר קטעים תואמים. |
fields | CSV | צמצם את התגובה לשדות שבהם אתה אכן משתמש. |
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"ספירה לפני החיפוש
נקודת הקצה הכי פחות מנוצלת בשירות היא /v1/stats. לעיתים קרובות השאלה הרלוונטית אינה "מהם המאמרים", אלא "האם יש כאן משהו בכלל, ואיפה הוא נמצא". ספירת תוצאות עולה שבריר מהמחיר — כמאתיים טוקנים לעומת אלפי טוקנים לדף תוצאות — מה שהופך אותה לקריאה הראשונה הנכונה עבור סוכן AI שצריך להחליט אם כדאי להריץ חיפוש.
curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"הוא מחזיר ספירות לפי מדינה, שפה, TLD, מו
מדינות מובילות
| מדינה | מאמרים |
|---|---|
| הודו | 2,286,014 |
| ארצות הברית | 2,180,797 |
| טורקיה | 1,499,897 |
| רוסיה | 1,436,556 |
| איטליה | 1,057,479 |
| ארגנטינה | 826,947 |
| ספרד | 812,347 |
| אוקראינה | 662,041 |
| ברזיל | 551,013 |
| גרמניה | 543,132 |
| צרפת | 502,846 |
| יוון | 460,372 |
| יפן | 437,209 |
| וייטנאם | 408,934 |
| מקסיקו | 402,320 |
| קוריאה הדרומית | 362,945 |
| רומניה | 354,229 |
| הממלכה המאוחדת | 334,379 |
| איראן | 291,782 |
| פולין | 255,599 |
שפות מובילות
אנגלית 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.
התפלגות זו שווה את הזמן להסתכל עליה, שכן היא הפוכה לחלוטין למה שרוב ה-APIים של החדשות מספקים. קורפוס האנגלית-תחילה, ארה"ב-תחילה המוכר לנו אינו המצב כאן: הודו מדורגת מעל ארצות הברית, טורקית מדורגת מעל גרמנית, ויוונית, וייטנאמית, פרסית ובולגרית כולן מייצגות קהל של מאות אלפים. אם השאלה שלך עוסקת בעיתונות שאינה באנגלית, מדובר במאגר נתונים שונה לחלוטין.
נפח
עקומת היומיום ב-by_day מכסה את מלוא חלון ה-90 הימים. הימים האחרונים נעים בטווח של כ-400,000 עד 700,000 מאמרים ביום; בתחילת חלון הזמן, לפני שהשכבה של RSS נוספה יחד עם עיבוד הארכיון, הנפח היומי עמד על 130,000–230,000. שני המספרים גלויים באותו תגובה, וזה בדיוק הרעיון — השירות מציג בפניך את העלייה שלו, ולא מצטט ממוצע שיווקי.
מגמות: על מה העיתונות מדברת באמת עכשיו
חיפוש עונה על השאלה "מה נכתב על X". מגמות עונה על שאלה אחרת ולעיתים קרובה גם טובה יותר: "מה קורה" — ללא צורך ב-X.
רובוט מקבץ מאמרים לסיפורים לפי מדינה ומעדכן אותם. כל חמש דקות מאמרים חדשים מצורפים לסיפורים קיימים באמצעות מילות זיהוי, ללא קריאה למודל כלל; כל כמה שעות מדינה עוברת עיבוד מלא שבו מודל שפה קורא את הכותרות ומגדיר את הסיפורים מההתחלה. בעת כתיבת שורות אלו, שכבת המגמות מכסה 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 מקורות משקף אירוע. המיון המוגדר כברירת מחדל הוא לפי מוציאים לאור, ו-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"ארבעה מכשירים עוקבים, על פני ארבעה מחלקות נכסים:
| מחלקה | מכשירים | גרגר | מקור |
|---|---|---|---|
| קריפטו | ביטקוין, את'ריום, סולאנה, XRP, BNB, Dogecoin | שעה | Binance |
| מתכות | זהב (USD/oz) | שעה | Binance |
| מט | EUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLN | יום | ECB |
| אנרגיה | מחיר חשמל בגרמניה (EUR/MWh) | שעה | Energy-Charts |
curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"הקריאה הבודדת הזו מספקת לך את שער הלירה מול הדולר ואת נפח הכיסוי העיתונאי הטורקי באותה תקופה, מיושרים שעה אחר שעה. העיתונות הטורקית מהווה את השלישית בגודלה בקרב קטעי קורפוס זה, וזו בדיוק הסיבה שהזוגיות הזו מייצרת משהו משמעותי ולא רעש.
ובלוק מלא של רגשות כלפי ביטקוין
ביטקוין מקבל משפחה של חמש נקודות קצה, כי זהו הכלי היחיד שבו טון החדשות ותנועת המחיר נדונים ללא הרף ונדירים למדוד:
| נקודת קצה | תשואות |
|---|---|
/v1/btc/summary | מחיר עדכני, תנועות אחרונות וטון הכיסוי הנוכחי. |
/v1/btc/price | אורות BTC/USDT לפי מרווח זמן. |
/v1/btc/sentiment | טון חדשותי לפי תקופה. |
/v1/btc/series | מחיר וטון מיושרים על ציר זמן אחד. |
/v1/btc/correlation | מתאם בין טון ותנועת מחיר בהזזת זמן — האם הכיסוי מוביל את המחיר, או עוקב אחריו? |
/v1/btc/news | מאמרי קריפטו עם תווית הרגש שלהם, עם אפשרות סינון לפי תווית, מארח, שפה ושאילתה. |
/v1/btc/sources | אילו מקורות מובילים את הכיסוי של קריפטו, וכיצד כל אחד מהם נוטה. |
תוויות הרגש מגיעות ממודל שפה שסורק מאמרי קריפטו עדכניים כל חמש דקות, מול רשימת מטבעות מכוילת. הנקודה /v1/btc/correlation עם פרמטר max_shift היא זו שכדאי לבחור אם אי פעם רציתם לבדוק את הטענה ש"החדשות גורמות לתנועה" במקום לחזור עליה.
אותו חיפוש, כמזין תוכן
שלוש נקודות קצה נוספות לוקחות את פרמטרי החיפוש זהים ומציגות את התוצאות כפורמטים לשידור חוזר במקום כJSON:
GET /v1/rss— RSS 2.0GET /v1/atom— Atom 1.0GET /v1/feed.json— JSON Feed 1.1
https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=dateמשמעות הדבר היא שכל חיפוש שמרוך הופך למזין תוכן שניתן להדביק לתוכנית קריאה, צומת ב-n8n, אינטגרציה ל-Slack, זריקה ב-Zapier או יוצר אתרים סטטיים — ללא קוד וללא מפתח. זוהי תכונה קטנה שמסתירה בשקט שכבה שלמה של אינטגרציות עבור לא-מתכנתים.
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 כלים בשתי שכבות מכוונות במכוון.
שכבה אחת: שישה קיצורי דרך שמשיבים על שאלה שלמה בשיחה אחת
| כלי | למען |
|---|---|
search_news | "מה נכתב על X" — חיפוש טקסט מלא, תוצאות מרוכזות. |
get_trends | "מה שקורה" — סיפורים מקובצים במקום רשימת מאמרים. |
trend_keywords | המילים שעליהן נבנה החדשות כרגע, כולל ספירת סיפורים והתפלגות גיאוגרפית. |
find_publishers | חיפוש מקורות: שם, דומיין, מדינה, שפה ומספר מאמרים ליום. |
list_countries | אילו מדינות מפרסמות סיפורים פעילים, בכמה, וכמה עדכניים הם. |
market_vs_news | רצף מחירים לצד נפח הכיסוי. קראו עם אינסטרומנט ריק כדי לראות מה קיים. |
שכבה שנייה: כל נקודת קצה, הנוצרת על ידי השירות עצמו
מתחת לקיצורי הדרך, כל נקודת קצה גולמית חשופה ככלי עצמאי עם כל פרמטר שה-API מקבל — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, כל משפחת ה-news_get_btc_*, מעבדי הפידים ו-news_get_health. אלו נוצרים מהשירות הפעיל, ולכן לא יכולות לסטות ממה שה-API באמת מקבל.
שני כלי מטא סוגרים את המעגל: news_list_endpoints מחזיר את קטלוג כל מה שקיים, ו-news_get מבצע GET גולמי על כל נתיב — כך שאגנט שייתקל בנקודת קצה שאינה מכוסה ברשימת הכלים שלו עדיין יכול להגיע אליה.
curl "https://freenewsapi.ai/mcp?format=json"פעולת GET אחת, ללא לחיצת יד, ויש לך את הקטלוג המלא לקריאה על ידי מכונה: שרת, תעבורה, פרוטוקול, מספר כלים, כל כלי עם התיאור שלו, וכל נקודת קצה עם רשימת הפרמטרים שלה.
מיועד לקריאה על ידי מכונות
התיעוד אינו תוספת שנצמדה ל-API — אלא פלט ראשי של עצמו. האתר מפרסם 665 עמודים סטטיים, וחלקם קיימים במיוחד כדי שמודל לעולם לא יצטרך לקרוא HTML:
- /openapi.json הסכמה המלאה של OpenAPI.
- /llms.txt קובץ הכוונה קצר — מהו השירות, נקודות הקצה, כיצד לבצע שאילתות בצורה מיטבית, ורשימת השגיאות.
- /llms-full.txt כל המסמכים כקובץ טקסט רגיל אחד, בנפח העולה על מאה קילובייטים, כך שסוכן AI יוכל לטעון את כל המדריך בהורדה אחת.
- /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 חדשים ועובדת על כל מה שלא נראה בעבר, באמצעות ארבעים עובדים מקבילים. המפעיל מוציא כל מאמר מהסריקה הגולמית באמצעות שרשרת מוסמכת לכל שדה — והשרשראות נמדדו מול נתונים אמיתיים ולא הניחו אותן:
| שדה | שרשרת | כיסוי |
|---|---|---|
| תיאור | JSON-LD → meta → OpenGraph → כרטיס Twitter → articleBody → פסקת פתיחה | 98.1% |
| שפה | <html lang> → JSON-LD inLanguage → og:locale | 99.9% |
| מדינה | ccTLD → JSON-LD addressCountry → אזור שפה → og:locale | 79.1% |
| תאריך | JSON-LD datePublished → meta → trafilatura → זמן סריקה | 100% |
הנתון הזה הוא הכנה ביותר, וזו הסיבה ששדה country_source חשוף בכל מאמר: כרבע מהרשומות חסר אות מדינה אמין לחלוטין, וכשליש מהערכים הקיימים הם השערות ולא עובדות. ה-API מציין איזה מהם הוא מה, במקום להסתיר זאת.
הנתיב החי
בוט שני מסתכל על עדכוני RSS של המוציא לאור כל חמש דקות, במחזור עם בקשות תנעתיות — עדכון שמחזיר 304 Not Modified עולה כמעט כלום, וכל מרווח זמן של בדיקת עדכון מותאם לתדירות הפרסום האמיתית של העיתון. עיתון שמפרסם חמישה מאמרים ביום לא נסרק כל חמש עשרה דקות.
הוא גם לוקח רק מה שהמוציא לאור שם בעדכון: כותרת, תקציר וטקסט מלא כאשר העדכון מכיל אותו. הוא לא נכנס לאתר של המוציא לאור כדי להשיג עוד. זהו גבול מכוון, וזו הסיבה שהשירות יכול להבטיח את ההבטחות שהוא נותן בדף המשפטי שלו למשתמשים.
והמנגנונים שמקיפים אותם
סביב שני נתיבי הקליטה עומדים עוד עשרה בוטים על לוחות זמנים: גילוי מקורות וסינכרון, פתרון מדינה לפי דומיין, בניית מגמות וביקורת, מילוי מילות מפתח, רגש קריפטו, משיכות שוק, קטלוג טקסונומיה, אחזקה (חלון תשעים הימים מיושם באמצעות שאילתה לילית על published_at, ולא על גיל אינדקס), אימות יום, בדיקות חוזרות למאמרים ריקים, ושומר בריאות שמפעיל מחדש כל דבר שהתעכב. הקורפוס נמצא על אשכול Elasticsearch ייעודי.
מה הנתונים האלו עושים לא נכון
השירות מפרסם את המגבלות שלו, וזו הדרך המהירה ביותר לשפוט האם זה מתאים לבעיה שלך.
- המדינה היא השערה קרא את
country_sourceבכל מאמר, והוסףstrict_country=trueכשאתה סופר לפי מדינה ולא גולש. - published_at הוא ספק המוציא לאור תאריך אחורה נפוץ. סדר לפי
crawledכשאתה מסתכל על מה חדש. - total מוגבל ל-10,000 למהירות.
total_is_lower_boundאומר לך כשאתה פוגש את הגג. - אין רגש או חילוץ ישויות מחוץ לחסם הביטקוין, מאמרים אינם נושאים ציון רגש או ישויות מוגדרות. זה לא בתחום.
- תשעים יום, ולא יותר אין ארכיון עמוק יותר. אם אתם צריכים נתונים משנת 2019, כלי זה אינו מתאים לכם.
- ללא SLA השירות חינם. הוא גם מפוקח ומגובה, אך לא מובטח שום דבר בכתב.
- הטקסט שייך למפרסמים כל תשובה כוללת את ה-URL המקורי, וצפוי מהמשתמשים לקשר חזרה אליו.
שימוש יעיל: עלות, דפדוף ושגיאות
משמעת טוקנים
לסוכן (Agent), גודל התגובה הוא העלות האמיתית. הצורה התיעודית שלו:
| קריאה | עלות טוקנים משוערת | מתי |
|---|---|---|
/v1/stats | ~200 | ראשית, החליטו האם כדאי להפעיל את החיפוש בכלל. |
רק מטא-דאטה של /v1/search | מספר אלפים בודדים לדף | סרוק ובחר. |
/v1/search?full_text=true | ~900 לכל מאמר | רק עבור אותם מעטים שבחרתם בפועל. |
עשרים מאמרים עם full_text=true הם כ-40,000 טוקנים. התבנית המומלצת תמיד זהה: ספרו, סרקו, ואז הורידו את גוף הטקסט רק עבור אלה שאתם צריכים.
ניווט מעבר לתקרה
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
דפי ההשוואה באתר מכסים אחד-עשר מתחרים באופן בודד. ההבדלים המבניים ששרדו את כולם:
100 בקשות ליום, עיכוב של 24 שעות
הצורה הסטנדרטית של שכבת API חינמית: דלי אסימונים קטן מספיק להדגמה, עם מאמרים עדכניים שמוחזקים ללקוחות בתשלום.
- מפתח נדרש
- מגבלה יומית
- מאמרים מעוכבים
- לשימוש לא-מסחרי בלבד
ללא מגבלות, ללא עיכוב, ללא מפתח
20 בקשות לשנייה לכל כתובת IP היא המגבלה היחידה. המאמר העדכני ביותר הוא בדרך כלל בן פחות משתי דקות, ושימוש מסחרי מותר.
- ללא מפתח, ללא הרשמה
- ללא מגבלה יומית או חודשית
- רענון רציף
- שימוש מסחרי מותר
אנגלית-תחילה, ארה"ב-תחילה
רוב הקורפוסים בנויים מרשימה של מוציאים לאור באנגלית, עם שאר העולם שמוסיפים בסוף.
- דומיננטיות אנגלית
- כיסוי דל של שפות שאינן לטיניות
הודו > ארה"ב, טורקית > גרמנית
כ-100 שפות עם נפחים בעלי משמעות (שישה ספרות) ביוונית, וייטנאמית, פרסית, אוקראינית ובולגרית.
- 100 מדינות
- ~100 שפות
- 11,668 מקורות מסווגים בקטלוג
מה ששירותים בתשלום עדיין מספקים וזה לא: ציוני רגש וחילוץ ישויות כשדות סטנדרטיים, ארכיונים שחוזרים שנים לאחור, וחוזר עם 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 יום, מתעדכן ברציפות, ללא מפתח, ללא הרשמה וללא מגבלת כמות מעבר למגבלת קצב לפי כתובת IP. בנוסף לחיפוש, זמינות אשכולות סיפורים חיים לפי מדינה ב-115 מדינות, ניתוח מילות מפתח המפריד בין אירועים עולמיים לבין מקומיים, ארבעה מדדי שוק המתואמים מול נפח הכיסוי, בלוק רגשות ביטקוין עם שבע נקודות קצה, שידור RSS/Atom/JSON לכל שאילתה, ושרת MCP בן 28 כלים שנוצר מהשירות עצמו.
השירות תיעד את שיעורי השגיאות שלו, חשף כיצד נגזרה כל ערך מדינה, ופרסם דף על מה הנתונים טועים. עבור סוכן AI שצריך לדעת מה העולם אומר — בטורקית, ביוונית, בהינדית, ממש עכשיו — שילוב כזה קשה למצוא בכל מחיר, והשירות הזה חינם.
החיפוש הוא AND (וגם) בין כל המונחים. השתמשו ב-2–5 מילות מפתח, ולא בשאלה בשפה טבעית.
Free News API, כיצד לבצע שאילתה בצורה טובה
התחילו כאן: freenewsapi.ai · MCP בכתובת freenewsapi.ai/mcp · המדריך המלא כקובץ אחד בכתובת /llms-full.txt.