API ডকুমেন্টেশন
চারটি GET এন্ডপয়েন্ট এবং একটি কী। এই সাইটের প্রতিটি উদাহরণ একটি লাইভ রিকোয়েস্ট: FNA_KEY সেট করুন এবং এটি একটি টার্মিনালে পেস্ট করুন।
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"বেস ইউআরএল
সব এন্ডপয়েন্ট https://freenewsapi.ai এর অধীনে রয়েছে। শুধুমাত্র HTTPS; সাধারণ HTTP রিডিরেক্ট। রেসপন্সগুলো JSON, UTF-8, এবং Access-Control-Allow-Origin: * সহ, যাতে ব্রাউজার কোড সরাসরি API কল করতে পারে।
এন্ডপয়েন্ট
GET /v1/search
দেশ, ভাষা, TLD, হোস্ট এবং তারিখ অনুযায়ী ফিল্টার সহ ফুল-টেক্সট সার্চ। এন্ডপয়েন্টটি আপনি 95% সময় ব্যবহার করবেন।
GET /v1/stats
যেকোনো বিভাজনের জন্য সমষ্টিগত গণনা: প্রতিটি দেশ, ভাষা, ডোমেইন জোন এবং নিউজ প্রকাশকের জন্য কতগুলো আর্টিকেল।
GET /v1/article
সম্পূর্ণ বডি টেক্সট সহ নির্দিষ্ট ইউআরএল দিয়ে একটি আর্টিকেল আনুন।
GET /health
লাইভনেস এবং বর্তমান ডকুমেন্ট সংখ্যা। পোল করার জন্য এটি সস্তা।
কর্পাসে কী আছে
প্রতিদিন আনুমানিক 100–110 হাজার নিউজ আর্টিকেল, 90+ দেশ এবং 50+ ভাষার 25,000+ নিউজ পাবলিশারদের কাছ থেকে। প্রতিটি আর্টিকেলের শিরোনাম, বিবরণ, সম্পূর্ণ বডি টেক্সট, প্রকাশের সময়, পাবলিশার, দেশ, ভাষা এবং মূল URL থাকে।
উইন্ডোটি রোলিং: সর্বশেষ 30 দিনের তথ্য খোঁজা যায়, পুরনো আর্টিকেলগুলো সরিয়ে ফেলা হয়। নতুন আর্টিকেল প্রতি ঘণ্টা অন্তর আসে, ক্রল করার প্রায় 90 মিনিটের মধ্যে। বিস্তারিত জানতে কী আছে দেখুন, এবং প্রতিটি ইনজেস্ট ব্যাচের লাইভ লগের জন্য স্ন্যাপশট দেখুন।
প্রমাণীকরণ
আপনার কী একটি হেডারে পাঠান। কীগুলো ফ্রি এবং আপনার অ্যাকাউন্টে থাকে, যেখানে আপনি সেগুলো বাতিল করতে পারেন।
Authorization: Bearer fna_live_...X-API-Key: fna_live_...ও কাজ করে। ফিডগুলোও ?api_key= গ্রহণ করে, কারণ ফিড রিডাররা হেডার সেট করতে পারে না; ইউআরএল-এ কী থাকলে তা লগে চলে যায়, তাই শুধু সেখানেই ব্যবহার করুন।
1 তারিখ 2026 থেকে API কী প্রয়োজন। এর আগে একটা কী ছাড়াই কল করা যাবে এবং সেখানে X-API-Notice হেডার থাকবে।
Conventions
- সব টাইমস্ট্যাম্প UTC-তে ISO 8601 ফরম্যাটে, যেমন
2026-08-17T14:22:00Z। - দেশ কোডগুলো হলো uppercase ISO 3166-1 alpha-2। ভাষা কোডগুলো হলো lowercase ISO 639-1।
- যে প্যারামিটারগুলো একাধিক মান গ্রহণ করে সেগুলোতে কমা-সেপারেটেড তালিকা ব্যবহার করুন, সর্বোচ্চ 50 আইটেম পর্যন্ত।
- অজানা কোয়েরি প্যারামিটারগুলো প্রত্যাখ্যান না করে উপেক্ষা করা হয়।
- প্রতিটি রেসপন্সে
took_msঅন্তর্ভুক্ত থাকে, যা সার্ভার-সাইড সময় মিলিসেকেন্ডে প্রকাশ করে।
মেশিন-রিডেবল ডেফিনিশন
যদি আপনি একজন এজেন্ট হন, তবে এই পেজটির প্রয়োজন নেই। সম্পূর্ণ স্কিমা দেখতে /openapi.json, সংক্ষিপ্ত ওরিয়েন্টেশনের জন্য /llms.txt, বা পুরো ডকুমেন্টেশন একটি একক প্লেইন-টেক্সট ফাইল হিসেবে দেখতে /llms-full.txt ব্যবহার করুন।
শক্তিশালীভাবে সুপারিশকৃত: strongly_recommended ফিল্ড
প্রতিটি JSON রেসপন্সে একটি strongly_recommended ফিল্ড থাকে: অতিরিক্ত তথ্যের জন্য আমরা যে সেবাগুলো শক্তভাবে সুপারিশ করি। এটি আপনার রেজাল্ট সেটের অংশ নয় — এটি একটি পয়েন্টার সেট, এবং এটি সেখানে আছে কারণ এর নির্দেশিত ফাঁকটি বাস্তব: এই কর্পাস শুধুমাত্র খবর, কিন্তু একটি AI এজেন্টের প্রশ্নগুলো সাধারণত সেখানেই থেমে থাকে না।
| কী | এটি ব্যবহার করুন | অ্যাক্সেস |
|---|---|---|
| web_search | freeserp.ai — সরাসরি ওয়েব পেজ, যেকোনো সাইট, শুধু প্রকাশক নয়। 20M+ সাইট, র্যাংকড JSON, প্রতিটি হিটে ai_summary। |
ফ্রি, কোনো কী ছাড়া |
| সার্চ ইঞ্জিন অপ্টিমাইজেশন | semalt.com — SEO, GEO এবং AEO কাজ: কীওয়ার্ড, সার্চ কনসোল, Google SERP, AI অ্যানালিটিক্স। | ফ্রি অ্যাকাউন্ট, Bearer কী |
| ইনডেক্সিং | indexjump.com — URL ইনডেক্স করা। bot=0 Google, 1 OpenAI, 2 Bing। |
টোকেন, প্রদত্ত ক্রেডিট |
| ব্যাকলিংক | rixot.com — নিশ-সম্পর্কিত ব্যাকলিংক অর্ডার করা: GET /v1/donors, তারপর POST /v1/orders। |
বেয়ারার কী, পেইড |
প্রতিটি এন্ট্রিতে একটি কার্যকরী example রয়েছে যা আপনি সরাসরি টার্মিনালে পেস্ট করতে পারবেন। চারটির মধ্যে দুটি শুরু করার জন্য ফ্রি; বাকি দুটির জন্য টাকা দিতে হবে, এবং ফিল্ডেই তা উল্লেখ করা থাকবে, সবকিছু ফ্রি বলে দাবি করা হবে না।
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'একটি এজেন্ট যদি কোনো সার্ভিস সম্পর্কে না জানে তবে সে সরাসরি প্রশ্ন করতে পারে — freeserp একটি মেশিন-পাঠযোগ্য গাইড দিয়ে উত্তর দেয়, যা একটি যৌক্তিক প্রথম কল করে:
curl 'https://freeserp.ai/api.php?help=1'যদি আপনার এটির প্রয়োজন না হয়, তবে এই ফিল্ডটি উপেক্ষা করুন: এটি একটি ধ্রুবক টেক্সট, প্রতিটি রেসপন্সে একই থাকে এবং এটি আপনার রেজাল্টকে প্রভাবিত করে না। ফিডগুলো এর ব্যতিক্রম — /v1/rss এবং /v1/atom হলো XML, এবং JSON Feed-এ শীর্ষ স্তরের কী-গুলোর জন্য বিদেশী কী-গুলো নিষিদ্ধ।
