Жаңалық API әдетте сұраныс бойынша сатылады, кілт арқылы шектеледі және тегін тарифте күніне жүз шақырыммен шектеледі. Free News API осылардың ешқайсысы емес: 90 күндік термелетін аралықтағы 21,5 миллион мақала, 25 000-нан астам басылым, кілт жоқ, тіркелу қажет емес, квота жоқ, коммерциялық қолдануға рұқсат етілген. Мұнда толық беткі қабат — іздеу, статистика, трендтер, нарықтар, ағындар және MCP — және деректер қателесетін жайттардың адал шолуы.
Мәселенің пішіні
Жасанды интеллект агентіне әлемде қазір не туралы жазылып жатқанын сұрасаңыз, оның үш нашар нұсқасы бар. Ол басылымдардан тікелей деректерді тартып ала алады, бұл әлсіз, баяу және заңдық тұрғыдан мұқият емес. Ол коммерциялық жаңалық API-на шақыру жасай алады, бұл аккаунт, кілт, айлық шот және — нарықтағы барлық тегін тарифтерде — күніне жүз сұраныс және мақалалардың жиырма сағатқа кешігуін білдіреді. Немесе ол бірнеше ай бұрын тоқтаған оқыту деректерінен болжау жасай алады.
Free News API орта нұсқаның бағасын және қағазбастығын алып тастайды, бірақ оның мүмкіндіктерін жоғалтпайды. Бір GET сұранысы, аккредитация жоқ, жазу кезінде 21 557 044 мақаладан тұратын корпус арқылы, 25 мыңнан астам басылымнан, термелетін тоқсан күндік аралықта сақталған және үздіксіз жаңартылатын — индексдегі ең соңғы мақала әдетте екі минуттан аспайды.
Төрт негізгі соңғы нүкте және одан да көп
Қызметтің өзегі — төрт 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) және ағымдағы құжаттар саны. Дауыс жинауға (poll) жеткілікті арзан. |
Осы негізгі бөліктің айналасында тағы төрт отбасы орналасқан, олардың әрқайсысы басқа жерде жеке өнім болар еді: трендтер (елдер бойынша тірі оқиғаларды кластерлеу), нарықтар (баға серияларының жарияланым көлеміне сәйкестендірілуі), крипто сезімталдық (Bitcoin блоктарының жеті нүктесі) және синдикация (іздеудің 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 елдің қалай анықталғанын көрсетеді — себебі кез келген жаңалықтар деректер жинағында ел мәндерінің үлкен бөлігі фактілер емес, болжамдар болып табылады. Ал crawled_at — сенімді уақыт белгісі: жариялаушылар published_at өрісін жиі кері датамен толтырады, бірақ краулинг уақыты конвейер арқылы тағайындалады және тек алға жылжиды.
Іздеу: Маңызы бар әрбір параметр
Барлық параметрлер міндетті емес. Бос шақыру индексдегі ең жаңа мақалаларды қайтарады.
Сұраныс
- 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 (сканерленген) уақыты бойынша сұрыптау — жариялаушылар жарияланған уақытын артқа қарай ауыстырады; ал сканерлеу уақыты тек алға жылжиды. |
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"Іздеу алдында санау
Қызметтегі ең аз пайдаланылатын endpoint — /v1/stats. Көбінесе пайдалы сұрақ «мақалалар қандай?» емес, «мұнда мүлдем ештеңе бар ма және ол қайда?» деген сұрақ болады. Нәтижелер беті үшін бірнеше мың токенге қарамастан, шамамен екі жүз токенге жуық шығынмен жауаптарды санау — агентке іздеуді жүргізу тиімді ме деген шешім қабылдау үшін дұрыс бастапқы шақыру болып табылады.
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 бойынша күндік қисық толық тоқсан күндік терезені қамтиды. Соңғы күндер шамамен тәулігіне 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 — ауқым. 4 басылымнан 200 мақала бар оқиға — бір редакцияның қызығушылығы. 40 басылымнан 60 мақала бар оқиға — іс-шара. Әдепкі реттеу 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"Төрт актив класы бойынша он төрт құрал бақыланады:
| Класс | Құралдар | Дәлдік | Дереккөз |
|---|---|---|---|
| Крипто | Bitcoin, Ethereum, Solana, XRP, BNB, Dogecoin | сағат | Binance |
| Металдар | Алтын (USD/oz) | сағат | Binance |
| Валюта нарығы (FX) | EUR/USD, USD/JPY, USD/TRY, USD/INR, USD/BRL, USD/PLN | күн | ЕЦБ |
| Энергетика | Германиядағы электр энергиясы бағасы (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 endpoint-і max_shift параметрімен қолдануға тұрарлық.
Іздеуді желіге айналдыру
Үш қосымша endpoint бірдей іздеу параметрлерін қабылдайды және нәтижелерді 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: 28 құрал, екі қабат
MCP сервері бір URL мекенжайында орналасқан, Streamable HTTP (POST арқылы JSON-RPC 2.0, протокол нұсқасы 2025-06-18) протоколын қолдайды, пакеттік өңдеуді қолдайды және — мұндағы басқа нәрселер сияқты — авторизация қадамын да, сессия 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 | Баға қатары мен қамту көлемі. Ненің бар екенін көру үшін құралды параметрсіз шақырыңыз. |
Екінші қабат: әрбір 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_* отбасы, feed renderers және news_get_health. Бұлар тікелей қызметтен генерацияланғандықтан, олар API нақты қабылдайтын нәрседен ауытқымайды.
Екі мета-құрал циклді жабады: news_list_endpoints барлық бар нәрсенің каталогын қайтарады, ал news_get кез келген жол бойынша raw GET орындайды — яғни, құралдар тізімі қамтымаған endpoint-ке тап болған агент оған жете алады.
curl "https://freenewsapi.ai/mcp?format=json"Бір GET, қол алысу жоқ, және сізде бүкіл машина оқитын каталог бар: сервер, тасымалдау, протокол, құралдар саны, әрбір құралдың сипаттамасы және әрбір endpoint-тің параметрлер тізімі.
Машиндерге оқуға арналған
Документация API-ға қосымша ретінде жасалмаған — ол оның бірінші дәрежелі шығысы. Сайт 665 статикалық бетті ұсынады, олардың кейбіреулері модельге HTML оқудың қажеті жоқ болуы үшін арнайы жасалған:
- /openapi.json Толық OpenAPI схемасы.
- /llms.txt Қысқаша бағдарлама — сервис қандай, эндпоинттер, оны қалай тиімді пайдалану керек, қаталар.
- /llms-full.txt Толық құжаттама бір жай мәтіндік файл түрінде, көлемі жүздеген килобайттан асады, бұл агентке бүкіл нұсқаулықты бір сұраныспен жүктеп алуға мүмкіндік береді.
- /agents Агент құрастырушыларға арналған отыз тоғыз бет: дайын OpenAI функция анықтамалары, Anthropic құралдарды пайдалану анықтамалары, жаңалықтарды іздеуге арналған жүйелік промптар, RAG рецепттері, токен құны кестелері және агент рецепттері.
- /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 беті — корпусдың әрбір бөлігі үшін бір шолу беті, әрқайсысы оның ішінде нақты не бар екенін көрсетеді.
Мақалалар қайдан алынады
Екі сіңіру жолы бір индекске деректерді жібереді және олардың арасындағы айырмашылық маңызды.
Архив жолы
Әр он минут сайын Common Crawl CC-NEWS архивіндегі жаңа 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 (Өзгеріссіз) жауабын қайтаратын ағынның құны өте аз, ал әр ағынды тексеру жиілігі оның нақты қаншалықты жаңартылатынына байланысты реттеледі. Күніне бес мақлама жариялайтын басылым әр жарты сағат сайын қатты жүктелмейді.
Ол басылым ағында көрсеткен нәрсені ғана алады: тақырыпты, кіріспе сөзді және ағында болса, толық мәтінді. Ол басылым сайтына барып, басқа ақпарат іздемейді. Бұл — мақсатты шектеу, және осы себепті қызмет басылымдарға арналған құқықтық бетінде уәде ететін уәделерін орындай алады.
Оларды қоршап тұрған механизмдер
Екі деректерді жинау жолының айналасында кесте бойынша жұмыс істейтін тағы ондаған робот орналасқан: дереккөзді ашу және синхрондау, домен бойынша елді анықтау, трендтерді құру және тексеру, кілттік сөздерді толтыру, криптологиялық көңіл-күйді талдау, нарықтық деректерді тарту, таксономия каталогы, сақтау (90 күндік терезе published_at өрісі бойынша түнгі сұраныс арқылы қатаң орындалады, индекс жасына байланысты емес), күнді растау, бос мақламаларды қайта тексеру және тоқтап қалған кез келген процесті қайта іске қосатын денсаулық бақылаушысы. Корпус арнайы Elasticsearch кластерінде сақталады.
Бұл дереттер жиынтығындағы кемшіліктер
Қызмет өз шектеулерін жариялайды, бұл оның сіздің мәселеңізге сәйкес келетінін бағалаудың ең жылдам жолы.
- Ел болжам арқылы анықталады Әр мақалада
country_sourceмәнін оқыңыз, ал ел бойынша санамалап жатқанда (жай ғана шолып отырған кезде емес),strict_country=trueпараметрін қосыңыз. - published_at — басылым ұсынған уақыт Кері дата қою жиі кездеседі. Жаңа ақпаратты тексергенде
crawled(скрапталған уақыт) бойынша реттеңіз. - total (жалпы саны) 10 000-ге дейін шектеледі Жылдамдық үшін.
total_is_lower_boundсізге шекке жеткеніңізді көрсетеді. - Көңіл-күй немесе сущностьтарды анықтау жоқ Биткоин блоктың сыртында мақамаларда көңіл-күй ұпайы да, аталған сущностьтар да жоқ. Бұл қамтылған міндеттемелер шеңберінен тыс.
- Тоғыз күннен артық емес Тереңірек архив жоқ. Егер сізге 2019 жылғы деректер керек болса, бұл құрал сізге сәйкес келмейді.
- SLA кепілдігі жоқ Тегін. Бірақ ол бақылауда және қорғалуда, бірақ ешқандай жазбаша кепілдік берілмейді.
- Мәтіндер баспагерлерге тиесілі Әр жауапта түпнұсқа URL көрсетіледі, ал пайдаланушылар оған сілтеме жасауы тиіс.
Оны тиімді пайдалану: Шығындар, беттеу және қаталар
Токендерге тәртіп
Агент үшін жауап көлемі – нақты шығын. Оның құрылымы:
| Сұраныс | Шамамен токкен шығыны | Уақыты |
|---|---|---|
/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Белгісіз кілттер елемеуі мүмкін, сондықтан қосымша кілттерді жіберу әрқашан қауіпсіз. Ешнәрсе тексерілмейді, елемеу үшін шектеулер қолданылмайды, ал жалғыз нұсқау қатаң: осы өрістерге пайдаланушының жеке деректерін қоймаңыз.
Төлемді жаңалықтар APIдерге қарсы
Сайттағы салыстыру беттері он бір бәсекелеске жеке-жеке арналған. Олардың барлығына төзімді құрылымдық айырмашылықтар:
Күніне 100 сұраныс, 24 сағаттық кідіріс
Тегін жаңалық-API тарифінің стандартты пішіні: демо үшін жеткіліксіз шағын токен шелегі, ал жаңа мақалалар төлемдік клиенттер үшін күтіп тұрады.
- Кілт қажет
- Күнделікті шектеу
- Кідірісті мақалалар
- Коммерциялық емес мақсаттар үшін ғана
Шектеусіз, кідіріссіз, кілті жоқ
IP мекенжайына секундына 20 сұраныс — жалғыз шектеу. Ең соңғы мақала әдетте екі минуттан аспайды, ал коммерциялық қолдануға рұқсат етіледі.
- Кілтсіз, тіркелусіз
- Күнделікті немесе айлық шектеу жоқ
- Үздіксіз жаңарту
- Коммерциялық қолдануға рұқсат етілген
Ағылшын тілі басым, АҚШ орталық
Көптеген корпусар негізінен ағылшын тіліндегі басылымдар тізімінен құрастырылады да, әлемнің қалған бөлігі оған қосылады.
- Ағылшын тілі басым
- Латын емес тілдердегі мазмұнның аздығы
Үндістан > АҚШ, түрік тілі > неміс тілі
Шамамен 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"Сақталған іздеуді ағынға айналдыру
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 — 100 елдегі шамамен 25 000 басылымнан алынған 21,5 миллионнан астам жаңалық мақаласын, шамамен 100 тілде, 90 күндік терезеде, үздіксіз жаңартылып отыратын, кілтсіз, тіркелусіз және IP мекенжайына қойылатын шектеуден басқа квотасыз толық мәтінді іздеу жүйесі. Іздеудің үстінде 115 ел бойынша тікелей жаңалық оқиғаларын топтастыру, әлемдік оқиғаларды ішкі оқиғалардан ажырататын кілтсөздерді талдау, жаңалық көлеміне қарсы 14 нарықтық құралдың графиктері, биткоин сезімін көрсететін 7 нүктелі блок, кез келген сұранысты RSS/Atom/JSON форматтарында тарату және қызметтің өзінде жасалған 28 құралдан тұратын MCP сервері бар.
Ол өз қателіктерінің деңгейін көрсетеді, әр ел мәнінің қалай алынғанын ашады және деректердің қай жерде қате беретіні туралы бетті жариялайды. Әлемнің қазір не айтқанын білуді қажет ететін агент үшін (мысалы, түрік, грек немесе хинди тілдерінде) мұндай комбинацияны кез келген бағамен табу қиын, ал бұл тегін.
Іздеу барлық терминдер бойынша AND (және) логикасымен жүзеге асады. Табиғи тілдегі сұрақ емес, 2–5 кілтсөзді қолданыңыз.
Free News API, оны қалай дұрыс сұрау керектігі туралы
Осы жерден бастаңыз: freenewsapi.ai · freenewsapi.ai/mcp сайтында MCP · барлық нұсқаулықты бір файл ретінде /llms-full.txt мекенжайында.