Жаңалық API әдетте сұраныс бойынша сатылады, кілт арқылы шектеледі және тегін тарифте күніне жүз шақырыммен шектеледі. Free News API осылардың ешқайсысы емес: 90 күндік термелетін аралықтағы 21,5 миллион мақала, 25 000-нан астам басылым, кілт жоқ, тіркелу қажет емес, квота жоқ, коммерциялық қолдануға рұқсат етілген. Мұнда толық беткі қабат — іздеу, статистика, трендтер, нарықтар, ағындар және MCP — және деректер қателесетін жайттардың адал шолуы.

Мәселенің пішіні

Жасанды интеллект агентіне әлемде қазір не туралы жазылып жатқанын сұрасаңыз, оның үш нашар нұсқасы бар. Ол басылымдардан тікелей деректерді тартып ала алады, бұл әлсіз, баяу және заңдық тұрғыдан мұқият емес. Ол коммерциялық жаңалық API-на шақыру жасай алады, бұл аккаунт, кілт, айлық шот және — нарықтағы барлық тегін тарифтерде — күніне жүз сұраныс және мақалалардың жиырма сағатқа кешігуін білдіреді. Немесе ол бірнеше ай бұрын тоқтаған оқыту деректерінен болжау жасай алады.

Free News API орта нұсқаның бағасын және қағазбастығын алып тастайды, бірақ оның мүмкіндіктерін жоғалтпайды. Бір GET сұранысы, аккредитация жоқ, жазу кезінде 21 557 044 мақаладан тұратын корпус арқылы, 25 мыңнан астам басылымнан, термелетін тоқсан күндік аралықта сақталған және үздіксіз жаңартылатын — индексдегі ең соңғы мақала әдетте екі минуттан аспайды.

21,5 млн
индекске енгізілген мақалалар
25,000+
басылымдар
100
елдер
~100
тілдер
90 күн
айнымалы терезе
0
бар болған API кілттері
Ереже: API кілті жоқ және ол болмайды. Оған арналған параметр жоқ, жіберілетін таңба жоқ, жасалатын есеп жоқ және сұраныс квотасы да жоқ — тек IP мекенжайына шамамен 20 сұраныс/секунд шектеуі бар, сондықтан бір пайдаланушы басқалар үшін қызметті істен шығара алмайды.

Төрт негізгі соңғы нүкте және одан да көп

Қызметтің өзегі — төрт 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 өрісін жиі кері датамен толтырады, бірақ краулинг уақыты конвейер арқылы тағайындалады және тек алға жылжиды.

Іздеу: Маңызы бар әрбір параметр

Барлық параметрлер міндетті емес. Бос шақыру индексдегі ең жаңа мақалаларды қайтарады.

Сұраныс

Чат-бот сияқты емес, іздеу жүйесі сияқты сұраныс жасаңыз: Бұл ең жиі кездесетін қате. Іздеу барлық терминдер бойынша AND логикасымен жүреді, сондықтан сөйлем емес, 2–5 кілттік сөз жазыңыз. opec production cut жұмыс істейді. what did OPEC decide about oil ештеңе қайтармайды.

Сүзгілер

Сүзгілер параметрлер бойынша AND және бір параметр ішіндегі OR логикасымен бірігеді. Сондықтан country=DE,AT&lang=de "Германия немесе Австриядан неміс тіліндегі мақалалар" дегенді білдіреді. Әрқайсысы елу мәнге дейінгі үтірмен бөлінген тізімді қабылдайды.

СүзгіФорматЕскертпелер
countryISO 3166-1 alpha-2, баспа әріптерменБаспахананың елі. Шығарылған, жарияланбаған — country_source және strict_country мәліметтерін қараңыз.
langISO 639-1, кіші әріптерменҚұжаттан анықталған. 99,9% қамту.
tldнүктесізБаспахананың домендік аймағы. tld=ua — факт; country=UA — болжам.
hostнақты хост атауларыОлар URL-де көрсетілгендей — егер баспахана www. қолданса, оны қосыңыз.
dateбүгін · кеше · 24 сағ · 48 сағ · 7 күн · 30 күнАлдын ала белгіленген кезең, published_at (жарияланған уақыты) деректеріне сәйкес бағаланған.
from / toISO күндеріАлдын ала белгіленген кезеңдер сәйкес келмейтін нақты терезе.
strict_countrytrue/falseЕл деректері нақты фактіге негізделген ма, әлде болжам ма дегенді ескере отырып, тек сол мақалаларды санға қосу.

Шығарманы бақылау

ПараметрМәндерӘсері
sortdate · date_asc · crawled · crawled_asc · relevanceЖаңа мақалаларды іздегенде crawled (сканерленген) уақыты бойынша сұрыптау — жариялаушылар жарияланған уақытын артқа қарай ауыстырады; ал сканерлеу уақыты тек алға жылжиды.
size1–100Бетіне келетін нәтижелер саны.
offset0–9900Ауысу жылжытқышы.
full_texttrue/falseМақаланың мәтіндік бөлігін қосу. Әдепкі бойынша өшірулі.
highlighttrue/falseСәйкес келетін үзінділерді қайтару.
fieldsCSVЖауапты нақты қолданатын өрістерге дейін қысқарту.
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 форматында емес, синдикация форматтарында ұсынады:

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 оқудың қажеті жоқ болуы үшін арнайы жасалған:

Сондай-ақ 168 ел беті, 121 тіл беті және 275 TLD беті — корпусдың әрбір бөлігі үшін бір шолу беті, әрқайсысы оның ішінде нақты не бар екенін көрсетеді.

Мақалалар қайдан алынады

Екі сіңіру жолы бір индекске деректерді жібереді және олардың арасындағы айырмашылық маңызды.

Архив жолы

Әр он минут сайын Common Crawl CC-NEWS архивіндегі жаңа WARC файлдары үшін тапсырма тексеріледі және ол бұрын көрмеген кез келген деректерді қырық параллель жұмысшыны пайдалана отырып өңдейді. Экстрактор әрбір мақаланы шикі тасымалдаудан алып, әр өріс үшін құжатталған каскадты қолданады — ал каскадтар нақты деректерге сүйене отырып өлшенді, болжамдалмаған:

ӨрісКаскадҚамту
сипаттамаJSON-LD → meta → OpenGraph → Twitter карточкасы → articleBody → жетекші абзац98.1%
тіл<html lang> → JSON-LD inLanguage → og:locale99.9%
елccTLD → JSON-LD addressCountry → тіл-аймақ → og:locale79.1%
датаJSON-LD datePublished → meta → trafilatura → тасымалдау уақыты100%

Бұл ел көрсеткіші — шынайы дерек, сондықтан country_source әр мақалада көрсетіледі: деректердің шамамен бестен бірінің ел туралы сенімді сигналы жоқ, ал бар болған мәндердің үштен бірі факті емес, болжам ғана. API сізге қайсысы шынайы екенін, қайсысы болжам екенін анық көрсетеді.

Тікелей ағын

Екінші робот әр бес минут сайын RSS басылымдарының ағындарын тексереді. Шартты сұраныстармен кезектесіп жұмыс істейді — 304 Not Modified (Өзгеріссіз) жауабын қайтаратын ағынның құны өте аз, ал әр ағынды тексеру жиілігі оның нақты қаншалықты жаңартылатынына байланысты реттеледі. Күніне бес мақлама жариялайтын басылым әр жарты сағат сайын қатты жүктелмейді.

Ол басылым ағында көрсеткен нәрсені ғана алады: тақырыпты, кіріспе сөзді және ағында болса, толық мәтінді. Ол басылым сайтына барып, басқа ақпарат іздемейді. Бұл — мақсатты шектеу, және осы себепті қызмет басылымдарға арналған құқықтық бетінде уәде ететін уәделерін орындай алады.

Оларды қоршап тұрған механизмдер

Екі деректерді жинау жолының айналасында кесте бойынша жұмыс істейтін тағы ондаған робот орналасқан: дереккөзді ашу және синхрондау, домен бойынша елді анықтау, трендтерді құру және тексеру, кілттік сөздерді толтыру, криптологиялық көңіл-күйді талдау, нарықтық деректерді тарту, таксономия каталогы, сақтау (90 күндік терезе published_at өрісі бойынша түнгі сұраныс арқылы қатаң орындалады, индекс жасына байланысты емес), күнді растау, бос мақламаларды қайта тексеру және тоқтап қалған кез келген процесті қайта іске қосатын денсаулық бақылаушысы. Корпус арнайы Elasticsearch кластерінде сақталады.

Бұл дереттер жиынтығындағы кемшіліктер

Қызмет өз шектеулерін жариялайды, бұл оның сіздің мәселеңізге сәйкес келетінін бағалаудың ең жылдам жолы.

Оны тиімді пайдалану: Шығындар, беттеу және қаталар

Токендерге тәртіп

Агент үшін жауап көлемі – нақты шығын. Оның құрылымы:

СұранысШамамен токкен шығыныУақыты
/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 тарифінің стандартты пішіні: демо үшін жеткіліксіз шағын токен шелегі, ал жаңа мақалалар төлемдік клиенттер үшін күтіп тұрады.

  • Кілт қажет
  • Күнделікті шектеу
  • Кідірісті мақалалар
  • Коммерциялық емес мақсаттар үшін ғана
Free News 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 мекенжайында.