API dữ liệu trường học Hoa Kỳ
Thông tin trường học dành cho du học sinh quốc tế, bắt đầu với trường nội trú, dưới dạng JSON và máy chủ MCP cho trợ lý AI. Mỗi thông tin đều kèm nguồn và ngày kiểm tra.
Tài liệu cho nhà phát triển → /api/v1 OpenAPI
Số liệu trực tiếp từ cơ sở dữ liệu của chúng tôi. Cập nhật lần cuối: 2026-10-10 (UTC). Chưa có trường nội trú nào được xác minh: tất cả vẫn ở trạng thái chưa xác minh.
Quý vị nhận được gì
- Tìm kiếm — lọc trường theo vùng, khối lớp, giới tính, tôn giáo, chương trình, thị thực và hiệp hội, giống hệt trang danh sách trường, cùng với tìm theo tên và bang.
/api/v1/schools - Hồ sơ trường — địa chỉ, website, khối lớp, số học sinh, giáo viên, mọi nhãn phân loại kèm nguồn, và các thông tin theo năm như học phí hay hạn nộp hồ sơ kèm năm học và URL nguồn khi chúng tôi ghi nhận.
/api/v1/schools/<slug> - Thị thực F-1 (SEVP) — trường có nằm trong danh sách được SEVP chứng nhận hay không — điều kiện bắt buộc để cấp mẫu I-20 — kèm đường dẫn Study in the States.
/api/v1/sevp/check·/api/v1/sevp/campuses - Phân loại và số lượng — các tiêu chí lọc và giá trị bằng tiếng Anh và tiếng Hàn kèm số lượng trường.
/api/v1/facets·/api/v1/stats - Tệp dữ liệu tổng hợp — mọi trường công khai trong một tệp CSV hoặc JSON. schools.csv · schools.json
- MCP — dành cho trợ lý AI (Claude, ChatGPT, Cursor và các trợ lý khác):
https://usanaru.com/mcp· công cụ:about,search_schools,get_school,list_facets,check_sevp,compare_schools,search_news,get_school_news,get_school_videos,list_documents,get_document,check_regulation,get_test_dates,get_state_policy,find_helpers
Nguồn
| Nguồn | Đơn vị công bố | Ấn bản | Mục đích sử dụng |
|---|---|---|---|
| Private School Universe Survey (PSS) | U.S. Department of Education, National Center for Education Statistics (NCES) | 2023-24 | school directory: name, address, grades, enrollment, teachers, religious affiliation, gender, boarding, association membership |
| SEVP certified school list | U.S. Department of Homeland Security, Student and Exchange Visitor Program (Study in the States) | 2026-10-07 | F-1 / M-1 certification (campus codes); matched to PSS schools by name and location |
| OurAirports airport data | OurAirports (public domain) | — | nearest major / scheduled-service airport and straight-line distance from each school |
| Wikidata | Wikimedia Foundation (CC0) | — | school identifiers (same_as links to Wikidata and Wikipedia) |
| IRS Form 990 via ProPublica Nonprofit Explorer | ProPublica (data from the IRS) | — | school finances — shown on usanaru.com pages only; not redistributed through this API (ProPublica terms) |
| Schools' official YouTube channels | each school (channel from Wikidata P2397 or the school's own website) | — | official school videos (campus tours, admissions, student life): title, watch link and date only — videos stay on YouTube |
Chúng tôi chỉ lưu giữ thông tin cấp tổ chức — không bao giờ lưu dữ liệu cá nhân của học sinh hay gia đình. Chúng tôi không lấp chỗ trống bằng phỏng đoán: một trường vẫn ở trạng thái chưa xác minh cho đến khi chúng tôi kiểm tra.
Truy cập và giới hạn
Không cần khóa và không cần đăng ký. Số yêu cầu được tính theo địa chỉ IP: 60 mỗi giờ và 500 mỗi ngày, tính chung cho /api/v1 và POST /mcp. Giới hạn được đặt lại vào đầu mỗi giờ và lúc 00:00 UTC; các yêu cầu bị trả về 429 không được tính.
Cần nhiều hơn? Hãy tải tệp dữ liệu tổng hợp, hoặc liên hệ với chúng tôi.
Ghi nguồn (bắt buộc)
Bất cứ khi nào bạn hiển thị, trích dẫn hoặc tóm tắt dữ liệu này, hãy hiển thị “USAnaru™” cho người dùng kèm đường dẫn hiển thị rõ ràng đến url của mục bạn đã sử dụng. Mỗi phản hồi đều có khối attribution, và mỗi mục đều có sẵn dòng cite.
Source: [USAnaru™](https://usanaru.com/schools/<slug>)Miễn phí cho mục đích cá nhân, nghiên cứu, giáo dục, tin tức và các mục đích phi thương mại khác, cũng như cho các trợ lý AI trả lời kèm đường dẫn. Sử dụng thương mại — trong sản phẩm, dịch vụ, ứng dụng, website, bộ dữ liệu hoặc mô hình AI của doanh nghiệp, hoặc phân phối lại số lượng lớn — cần có thỏa thuận bằng văn bản với chúng tôi trước. Bản nháp điều khoản API · Liên hệ
Câu hỏi
API của USAnaru™ có miễn phí không?
Có. Không cần khóa hay đăng ký. Mỗi địa chỉ IP có thể gửi 60 yêu cầu mỗi giờ và 500 yêu cầu mỗi ngày. Miễn phí cho mục đích cá nhân, nghiên cứu, giáo dục, tin tức và các mục đích phi thương mại khác, cũng như cho các trợ lý AI trả lời kèm đường dẫn. Mọi hình thức sử dụng đều phải ghi nguồn: hiển thị “USAnaru™” kèm đường dẫn đến trang chứa dữ liệu.
Dữ liệu được lấy từ đâu?
Danh bạ trường học lấy từ khảo sát Private School Universe Survey (PSS) của Trung tâm Thống kê Giáo dục Quốc gia (NCES) thuộc Bộ Giáo dục Hoa Kỳ. Chứng nhận F-1 lấy từ danh sách trường được SEVP chứng nhận do Bộ An ninh Nội địa Hoa Kỳ công bố (Study in the States). Mỗi nhãn và thông tin trong phản hồi đều ghi rõ nguồn, URL nguồn và ngày kiểm tra gần nhất.
“Chưa xác minh” nghĩa là gì?
Trường chưa xác minh là trường được phân loại dựa trên dữ liệu công khai (ví dụ: là trường nội trú) nhưng USAnaru™ chưa kiểm tra với chính nhà trường. Trường đã xác minh là trường đã được kiểm tra. Vui lòng xác nhận thông tin với nhà trường trước khi dựa vào đó.
Tôi có thể dùng dữ liệu trong sản phẩm thương mại không?
Không, nếu chưa có thỏa thuận bằng văn bản. Việc sử dụng dữ liệu trong hoặc cho sản phẩm, dịch vụ, ứng dụng, website, bộ dữ liệu hoặc mô hình AI của doanh nghiệp, hoặc phân phối lại số lượng lớn, cần có sự cho phép của chúng tôi trước. Hãy liên hệ với chúng tôi. Trích dẫn trang của một trường kèm đường dẫn trong bài viết hoặc câu trả lời của AI là miễn phí.
Điều gì xảy ra khi tôi đạt đến giới hạn?
API trả về HTTP 429 kèm thông tin về giới hạn và thời điểm đặt lại. Giới hạn theo giờ được đặt lại vào đầu mỗi giờ và giới hạn theo ngày lúc 00:00 UTC. Để lấy toàn bộ danh sách một lần, hãy dùng tệp CSV hoặc JSON tổng hợp.