Câu hỏi thường gặp

Nó thực sự miễn phí sao?

Gói Free là miễn phí. Lấy khóa API và chạy lệnh sau:

curl -H "Authorization: Bearer $FNA_KEY" "https://freenewsapi.ai/v1/search?q=test&size=1"

Gói Free có 3,000 yêu cầu mỗi tháng và 120 mỗi phút. Khóa API bắt buộc từ ngày 2026 tháng 1.

Điểm hạn chế là gì?

Ba, nói một cách rõ ràng. Cửa sổ thời gian là 90 ngày, không phải hàng năm. Không có SLA. Và không có phân tích cảm xúc hay trích xuất thực thể — đối thủ tính phí cho những tính năng này và chúng tôi chưa có. Danh sách đầy đủ các điểm hạn chế của chúng tôi.

Tôi có thể sử dụng cho mục đích thương mại không?

Có, không cần nâng cấp và không cần xin phép. Lưu ý rằng NewsAPI.org và GNews cấm sử dụng thương mại ở gói miễn phí của họ bất kể khối lượng dữ liệu — hãy kiểm tra kỹ các điều khoản bạn đang chấp nhận ở các dịch vụ khác.

Liên kết lại với bài viết gốc url khi bạn hiển thị nội dung cho người dùng. Đó là công việc của nhà xuất bản.

Dữ liệu đến từ đâu?

Kho lưu trữ tin tức công cộng quy mô lớn: bộ sưu tập lớn các trang tin đã được thu thập, được phát hành liên tục. Chúng tôi xử lý từng bản phát hành và lập chỉ mục kết quả. Thêm về nguồn.

Dữ liệu mới đến mức nào và làm sao để xác minh điều đó?

Tập dữ liệu được cập nhật liên tục trong ngày. Mỗi lô dữ liệu được đưa vào được công bố trên bản chụp với tên tệp, số lượng bài viết và dấu thời gian, trong khi trạng thái và /health hiển thị trạng thái dịch vụ trực tiếp. Do đó, bạn có thể tự đo lường độ tươi mới thay vì dựa vào huy hiệu tiếp thị nói rằng thời gian thực.

Tại sao chỉ 90 ngày?

Dữ liệu được chọn sao cho phù hợp với không gian chúng tôi có thể cung cấp mà không biến nó thành một trung tâm chi phí. Sự đánh đổi này đã mang lại cho bạn gói miễn phí. Nếu cần kho lưu trữ, hãy mua kho lưu trữ — NewsData.io và Perigon đều có kho lưu trữ kéo dài nhiều năm.

Tôi có nhận được toàn bộ nội dung bài báo không?

Có, với full_text=true, hoàn toàn miễn phí. Mọi đối thủ đều đặt phần thân bài viết sau gói trả phí. Phần thân bài viết thường rất dài — hãy kiểm tra chi phí token trước khi yêu cầu lấy hàng trăm bài.

Những nhà xuất bản nào được bao phủ?

Chỉ mục hiện tại chứa tài liệu từ hơn 25,000 nhà xuất bản, với hàng nghìn nhà hoạt động trong một ngày điển hình. Phạm vi bao phủ phản ánh những gì các kho lưu trữ công cộng và trình đọc nguồn cấp dữ liệu của chúng tôi đã thu thập; nó rộng rãi nhưng không phải là danh sách đảm bảo cho bất kỳ cơ quan báo chí cá nhân nào. Sử dụng thư mục nhà xuất bản và phân tích nguồn để kiểm tra tên máy chủ trước khi xây dựng xung quanh nó.

Tại sao trường quốc gia đôi khi không chính xác?

Vì nó được suy luận, và chúng tôi cho bạn biết cách. country_source cho biết nó đến từ tên miền mã quốc gia (tin cậy), markup của chính nhà xuất bản (tin cậy), thẻ locale (thường chính xác) hay mặc định mẫu en-US (không tin cậy). Để phân tích cấp quốc gia, thêm strict_country=true. Giải thích đầy đủ.

Tôi có thể lấy kết quả theo mức độ liên quan thay vì theo ngày không?

Có: sort=relevance. Mặc định là date vì hầu hết người dùng muốn kết quả mới nhất. Hãy dùng sort=crawled khi thực hiện polling — các nhà xuất bản thường đặt ngày xuất bản trước thời điểm thực tế, còn thời điểm thu thập dữ liệu không bao giờ lùi lại.

Làm sao để lấy dữ liệu của một ngày đầy đủ?

Chia nhỏ theo thời gian. Giới hạn trên của offset là 9,900 và một ngày chứa khoảng 110,000 bài báo. Vòng lặp nằm trong phân trang.

Có máy chủ MCP không?

Có. Máy chủ nằm tại /mcp và sử dụng Streamable HTTP kèm API key của bạn. Nó cung cấp các công cụ được chọn lọc để tìm kiếm tin tức, xu hướng, nhà xuất bản và thị trường, cùng với các công cụ được tạo tự động từ lược đồ OpenAPI. /mcp.json trả về danh mục công cụ có thể đọc được bằng máy, và hướng dẫn MCP cho biết cách thiết lập máy khách.

Bạn có SDK không?

Không, và bạn không cần nó. API gồm bốn điểm cuối GET trả về JSON. Bất kỳ công cụ HTTP nào trong bất kỳ ngôn ngữ nào cũng đều có thể đóng vai trò SDK. Ví dụ trong hướng dẫn bắt đầu.

Nếu tôi cần nhiều hơn gói miễn phí thì sao?

Xem gói dịch vụ, hoặc hỏi. Nếu bạn đang thực hiện xuất dữ liệu hàng loạt, có một cách tốt hơn là thực hiện 100,000 yêu cầu HTTP.

Bạn có theo dõi tôi không?

Chúng tôi chỉ giữ lại những gì cần thiết để vận hành dịch vụ: tài khoản của bạn, mức sử dụng theo từng khóa API và nhật ký máy chủ. Không có mạng quảng cáo, không có nhà môi giới dữ liệu. Quyền riêng tư toàn diện.

Tôi là nhà xuất bản và muốn gỡ trang web của mình.

Gửi tin nhắn cho chúng tôi và mọi việc sẽ được xử lý, không tranh cãi. Chi tiết.