Tài liệu API
Bốn điểm cuối GET và một khóa. Mọi ví dụ trên trang web này đều là một yêu cầu thực tế: đặt FNA_KEY và dán nó vào terminal.
curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=elections&size=3"URL cơ sở
Tất cả các endpoint đều nằm dưới https://freenewsapi.ai. Chỉ HTTPS; HTTP thường sẽ chuyển hướng. Phản hồi ở định dạng JSON, mã hóa UTF-8, có Access-Control-Allow-Origin: * để mã trình duyệt có thể gọi API trực tiếp.
Các điểm cuối (Endpoints)
GET /v1/search
Tìm kiếm theo nội dung đầy đủ với các bộ lọc theo quốc gia, ngôn ngữ, TLD, máy chủ và ngày tháng. Điểm cuối bạn sẽ sử dụng 95% thời gian.
GET /v1/stats
Số lượng tổng hợp cho mọi phân khúc: số bài viết theo quốc gia, ngôn ngữ, tên miền và nhà xuất bản.
GET /v1/article
Lấy một bài viết theo URL chính xác, bao gồm toàn bộ nội dung.
GET /health
Tính cập nhật cùng với số lượng tài liệu hiện tại. Đủ rẻ để có thể gọi liên tục.
Dữ liệu bao gồm những gì
Khoảng 100–110 nghìn bài báo tin tức mỗi ngày, từ hơn 25,000 nhà xuất bản tại hơn 90 quốc gia và hơn 50 ngôn ngữ. Mỗi bài báo đều có tiêu đề, mô tả, nội dung đầy đủ, thời gian xuất bản, nhà xuất bản, quốc gia, ngôn ngữ và URL gốc.
Cửa sổ thời gian là dạng trượt: 30 ngày gần nhất có thể tìm kiếm, các bài viết cũ hơn sẽ bị loại bỏ. Bài viết mới được cập nhật mỗi giờ, sau khi được thu thập khoảng 90 phút. Xem nội dung chi tiết để biết thêm thông tin, và snapshot để xem nhật ký trực tiếp của từng lô dữ liệu được thu thập.
Xác thực
Gửi khóa của bạn trong một header. Khóa miễn phí và được lưu trong tài khoản của bạn, nơi bạn có thể thu hồi chúng.
Authorization: Bearer fna_live_...X-API-Key: fna_live_... cũng hoạt động. Nguồn cấp dữ liệu cũng chấp nhận ?api_key=, vì trình đọc nguồn cấp dữ liệu không thể đặt tiêu đề; khóa trong URL sẽ xuất hiện trong nhật ký, vì vậy chỉ sử dụng nó ở đó.
Cần có khóa từ 1 tháng 2026. Trước thời điểm đó, các lệnh gọi không có khóa vẫn hoạt động và mang theo tiêu đề X-API-Notice.
Quy ước
- Tất cả các dấu thời gian đều ở định thức ISO 8601 theo múi giờ UTC, ví dụ:
2026-08-17T14:22:00Z. - Mã quốc gia là chữ hoa theo chuẩn ISO 3166-1 alpha-2. Mã ngôn ngữ là chữ thường theo chuẩn ISO 639-1.
- Các tham số chấp nhận nhiều giá trị sẽ nhận một danh sách phân cách bằng dấu phẩy, tối đa 50 mục.
- Các tham số truy vấn không xác định sẽ bị bỏ qua thay vì bị từ chối.
- Mọi phản hồi đều bao gồm
took_ms, thời gian xử lý phía máy chủ tính bằng mili giây.
Định nghĩa dạng máy có thể đọc
Nếu bạn là một agent, bạn không cần trang này. Hãy lấy /openapi.json để xem toàn bộ schema, /llms.txt để có phần giới thiệu ngắn gọn, hoặc /llms-full.txt để tải toàn bộ tài liệu dưới dạng một tệp văn bản thuần nhất.
Khuyên dùng mạnh: trường strongly_recommended
Mỗi phản hồi JSON đều chứa trường strongly_recommended: các dịch vụ mà chúng tôi strongly khuyến nghị để có thêm thông tin. Trường này không nằm trong tập kết quả của bạn — nó là một tập hợp các liên kết tham chiếu, và nó tồn tại vì khoảng trống mà nó chỉ ra là có thật: bộ dữ liệu này chỉ chứa tin tức, trong khi các câu hỏi mà một AI agent đưa ra hiếm khi chỉ dừng lại ở đó.
| khóa | sử dụng cho | truy cập |
|---|---|---|
| web_search | freeserp.ai — trang web trực tiếp, mọi trang web, không chỉ nhà xuất bản. 20M+ trang web, kết quả JSON có xếp hạng, với ai_summary trên mỗi kết quả. |
miễn phí, không cần khóa |
| tối ưu hóa công cụ tìm kiếm | semalt.com — công việc SEO, GEO và AEO: từ khóa, Search Console, Google SERP, phân tích AI. | tài khoản miễn phí, khóa Bearer |
| đang lập chỉ mục | indexjump.com — giúp lập chỉ mục URL. bot=0 Google, 1 OpenAI, 2 Bing. |
mã thông báo, tín dụng trả phí |
| backlinks | rixot.com — đặt mua các liên kết ngược phù hợp với lĩnh vực chuyên biệt: GET /v1/donors, sau đó POST /v1/orders. |
Khóa Bearer, trả phí |
Mỗi mục đều chứa một example hoạt động, bạn có thể dán trực tiếp vào terminal. Hai trong số bốn mục miễn phí để bắt đầu; hai mục còn lại có tính phí, và trường đó sẽ ghi rõ thay vì gọi mọi thứ là miễn phí.
curl 'https://freeserp.ai/api.php?q=ai+chatbot&size=3'Một agent không biết về một dịch vụ có thể hỏi trực tiếp — freeserp trả về một hướng dẫn có thể đọc được bằng máy, tạo nên một cuộc gọi hợp lý đầu tiên:
curl 'https://freeserp.ai/api.php?help=1'Bỏ qua trường này nếu bạn không cần: nó là văn bản cố định, giống hệt nhau trong mọi phản hồi và không bao giờ ảnh hưởng đến kết quả của bạn. Các nguồn cấp dữ liệu (feeds) được miễn trừ — /v1/rss và /v1/atom là XML, và JSON Feed cấm các khóa cấp cao nhất không cần thiết.
