{"slug":"huggingface-hub-api","kind":"tool","name":"Hugging Face Hub API","category":"Public APIs","description":"Search and read metadata for public models, datasets and Spaces on the Hugging Face Hub.","url":"https://huggingface.co/","docs_url":"https://huggingface.co/docs/hub/api","tags":"models,datasets,ML,JSON","verified_at":"2026-10-16","status":"documented","entry_url":"https://huggingface.co/docs/hub/api","entry_type":"html_only","auth_type":"none","auth_note":"None for public reads. Gated and private repositories need a token in an Authorization: Bearer header.","quickstart":"1. Search models: GET https://huggingface.co/api/models?search=QUERY&limit=10.\n2. Read one: GET https://huggingface.co/api/models/OWNER/NAME.\n3. Datasets are under /api/datasets.\n4. Check the licence and any gating before downloading weights.","example_request":"curl -s \"https://huggingface.co/api/models?search=bert&limit=1\"","writes":"read_only","writes_note":"These reads change nothing. Uploading needs an authenticated token.","rate_limits":"Rate limits apply and vary by plan; see the Hub documentation.","gotchas":"Some model files are very large; check sizes first. A gated model returns an error until access is granted. A model card is not a safety review.","tested_by":"read_tested","last_tested_at":"2026-10-16","check_status":"unchecked","checked_at":"","disclosure":"","details":{"purpose":"Find models and datasets and read their metadata.","interfaces":"JSON over HTTPS; official Python and JavaScript clients exist.","authentication":"None for public reads. A token is needed for private or gated repositories.","pricing":"Free tier; paid plans exist.","open_source":"Many hosted projects are open source; check each licence.","verification":"One read request returned HTTP 200 on 2026-10-16."},"field_notes":[]}