{"name":"huggingface","domain":"huggingface.co","baseUrl":"https://huggingface.co","displayName":"Hugging Face","description":"Hugging Face Hub: search public models, datasets and Spaces, and read their repository metadata while logged out.","notes":"No account is needed. Reads public repositories only.\n\n- `searchModels` and `searchDatasets` match words in the repository id (`owner/name`), not in the\n  model card, sorted by trending by default, first page (30) only. `searchModels` also accepts\n  `sort=likes`, `downloads`, `created` or `modified`.\n- `getModel` takes the id split in two: `openai/whisper-large-v3` is `author=openai`,\n  `name=whisper-large-v3` (both come back from `searchModels`). The case of the id matters\n  (`Qwen`, not `qwen`).\n- A model id that doesn't exist, or a private one, answers `class: \"auth\"` (Hugging Face sends\n  HTTP 401 rather than 404 for both). Check the id with `searchModels` before anything else: a\n  login does not help with a public model.\n- `gated` is `false`, `\"auto\"` or `\"manual\"`: a gated model's record is public, but its files need\n  an account that accepted its terms.\n- `task` (the pipeline tag), `license`, `library` and `parameters` are missing when the repository\n  doesn't declare them; `parameters` is counted only from safetensors weights.\n- In `searchDatasets`, `rows` and `modalities` come from the dataset viewer and are missing for a\n  dataset it can't read.\n- `getDataset` and `getSpace` also take case-sensitive `author` and `name` parts of a repository\n  id. Dataset card fields can be absent; the description is a shortened card summary and\n  `license` can be a string or a list.\n- `searchSpaces` returns the first page, including Spaces that are not running. A Space's linked\n  models or datasets, runtime hardware, SDK, title and emoji may be absent when not declared.\n  Runtime status can change independently of the repository's last modification time.\n- `getModelFiles` lists the root of the `main` revision, not subdirectories or other revisions.\n  It returns the first page only, with sizes in bytes; a directory's size may be zero. It does not\n  download file contents.","operations":[{"hash":"e4fbc730854838b2d3947f1d02dc5b70fb19d7429d3ba5768e62a59848669f95","status":"live","confirmations":0,"registry":{"hash":"e4fbc730854838b2d3947f1d02dc5b70fb19d7429d3ba5768e62a59848669f95","status":"live","confirmations":0},"operation":{"name":"getDataset","description":"Read a public dataset's card summary, downloads, likes, tags, task categories, size categories, license and last modification time.","request":{"method":"GET","url":"https://huggingface.co/api/datasets/%7Bauthor%7D/%7Bname%7D","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36"}},"slots":[{"param":"author","at":["path:2"]},{"param":"name","at":["path:3"]}],"volatile":[],"trigger":{"url":"https://huggingface.co/api/datasets/{author}/{name}"},"match":{"method":"GET","host":"huggingface.co","path":"/api/datasets/*/*"},"response":{"format":"json","contentType":"","extract":".","pick":["id","description","downloads","likes","tags","taskCategories=cardData.task_categories","sizeCategories=cardData.size_categories","license=cardData.license","lastModified"]},"params":[{"name":"author","type":"string","required":true,"description":"dataset owner, the part of the repository id before the slash","example":"openai"},{"name":"name","type":"string","required":true,"description":"dataset name, the part of the repository id after the slash","example":"gsm8k"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false}},{"hash":"586450684498dee9e2dcf1fda7fcde215caeaea576f5f9fa2b568260c2810ba9","status":"live","confirmations":0,"registry":{"hash":"586450684498dee9e2dcf1fda7fcde215caeaea576f5f9fa2b568260c2810ba9","status":"live","confirmations":0},"operation":{"name":"getModel","description":"One model's record: id, author, task, library, license, parameters (from its safetensors files), downloads, likes, createdAt, lastModified, gated and tags.","request":{"method":"GET","url":"https://huggingface.co/api/models/%7Bauthor%7D/%7Bname%7D","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36"}},"slots":[{"param":"author","at":["path:2"]},{"param":"name","at":["path:3"]}],"volatile":[],"trigger":{"url":"https://huggingface.co/api/models/{author}/{name}"},"match":{"method":"GET","host":"huggingface.co","path":"/api/models/*/*"},"response":{"format":"json","contentType":"application/json; charset=utf-8","extract":".","pick":["id","author","task=pipeline_tag","library=library_name","license=cardData.license","parameters=safetensors.total","downloads","likes","createdAt","lastModified","gated","tags"]},"params":[{"name":"author","type":"string","required":true,"description":"the owner (user or organization): the part of the model id before \"/\"","example":"openai"},{"name":"name","type":"string","required":true,"description":"the model name: the part of the model id after \"/\"","example":"whisper-large-v3"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false}},{"hash":"e73ce07b56082624732bd3aef76dd1600eedb324a8e484d39756019e1b00cc3e","status":"live","confirmations":0,"registry":{"hash":"e73ce07b56082624732bd3aef76dd1600eedb324a8e484d39756019e1b00cc3e","status":"live","confirmations":0},"operation":{"name":"getModelFiles","description":"List the first page of files and directories at the root of a public model repository on its main revision, without downloading file contents.","request":{"method":"GET","url":"https://huggingface.co/api/models/%7Bauthor%7D/%7Bname%7D/tree/main","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36"}},"slots":[{"param":"author","at":["path:2"]},{"param":"name","at":["path:3"]}],"volatile":[],"trigger":{"url":"https://huggingface.co/api/models/{author}/{name}/tree/main"},"match":{"path":"/api/models/*/*/tree/main"},"response":{"format":"json","contentType":"application/json; charset=utf-8","pick":["path","size","type"],"shape":{"[].type":"string","[].size":"number","[].path":"string"}},"params":[{"name":"author","type":"string","required":true,"description":"model owner, the part of the repository id before the slash","example":"google-bert"},{"name":"name","type":"string","required":true,"description":"model name, the part of the repository id after the slash","example":"bert-base-uncased"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false}},{"hash":"904ffa5b8fd3a567ded2943c4dc8c3132b548a16e3931697ac16985c3d11ba45","status":"live","confirmations":0,"registry":{"hash":"904ffa5b8fd3a567ded2943c4dc8c3132b548a16e3931697ac16985c3d11ba45","status":"live","confirmations":0},"operation":{"name":"getSpace","description":"Read a public Space's title, SDK, runtime stage, hardware, likes and linked model and dataset repositories.","request":{"method":"GET","url":"https://huggingface.co/api/spaces/%7Bauthor%7D/%7Bname%7D","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","accept-language":"en-US,en;q=0.9","priority":"u=0, i","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\"","sec-fetch-dest":"document","sec-fetch-mode":"navigate","sec-fetch-site":"none","sec-fetch-user":"?1","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36"}},"slots":[{"param":"author","at":["path:2"]},{"param":"name","at":["path:3"]}],"volatile":[],"trigger":{"url":"https://huggingface.co/api/spaces/{author}/{name}"},"match":{"method":"GET","host":"huggingface.co","path":"/api/spaces/*/*"},"response":{"format":"json","contentType":"","extract":".","pick":["id","title=cardData.title","emoji=cardData.emoji","sdk","runtimeStage=runtime.stage","hardware=runtime.hardware","likes","models","datasets","lastModified"]},"params":[{"name":"author","type":"string","required":true,"description":"Space owner, the part of the repository id before the slash","example":"gradio"},{"name":"name","type":"string","required":true,"description":"Space name, the part of the repository id after the slash","example":"hello_world"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false}},{"hash":"6b0b9a0720518287b560ccf0ba07ef1efb213b4ecd665f29fecf5f577cfc5a13","status":"live","confirmations":0,"registry":{"hash":"6b0b9a0720518287b560ccf0ba07ef1efb213b4ecd665f29fecf5f577cfc5a13","status":"live","confirmations":0},"operation":{"name":"searchDatasets","description":"Search datasets by name, as typed into the Filter by name box on huggingface.co/datasets (trending order, up to 30): id, author, downloads, likes, lastModified, gated, rows and modalities.","request":{"method":"GET","url":"https://huggingface.co/datasets-json?sort=trending&search=%7Bq%7D&withCount=true","headers":{"accept":"*/*","referer":"https://huggingface.co/datasets","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\""}},"slots":[{"param":"q","at":["query:search"]}],"volatile":[],"trigger":{"url":"https://huggingface.co/datasets","steps":[{"action":"wait","ms":3000},{"action":"fill","selector":"input[placeholder=\"Filter by name\"]","value":"{q}"},{"action":"wait","ms":3000}]},"match":{"path":"/datasets-json"},"response":{"format":"json","contentType":"application/json; charset=utf-8","extract":"datasets","pick":["id","author","downloads","likes","lastModified","gated","rows=datasetsServerInfo.numRows","modalities=datasetsServerInfo.modalities"],"shape":{"datasets[].author":"string","datasets[].downloads":"number","datasets[].gated":"boolean","datasets[].id":"string","datasets[].lastModified":"string","datasets[].datasetsServerInfo.numRows":"null","datasets[].datasetsServerInfo.modalities":"null","datasets[].likes":"number"}},"params":[{"name":"q","type":"string","required":true,"description":"words in the dataset id","example":"squad"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"q":"zzqqxxwvnothingmatch"},"expect":"empty","purpose":"a name nothing matches reads as an empty list"}]}},{"hash":"c68c3a03ffe1861a7d3f7ef3044fc8e2afd899cdf08cdebaf4f13f9e29f9435c","status":"live","confirmations":0,"registry":{"hash":"c68c3a03ffe1861a7d3f7ef3044fc8e2afd899cdf08cdebaf4f13f9e29f9435c","status":"live","confirmations":0},"operation":{"name":"searchModels","description":"Search models by repository name, returning up to 30 results in the chosen order.","request":{"method":"GET","url":"https://huggingface.co/models-json?sort=%7Bsort%7D&search=%7Bq%7D&withCount=true","headers":{"accept":"*/*","referer":"https://huggingface.co/models?sort={sort}","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\""}},"slots":[{"param":"q","at":["query:search"]},{"param":"sort","at":["query:sort"]},{"param":"sort","at":["header:referer"],"template":"https://huggingface.co/models?sort={sort}"}],"volatile":[],"trigger":{"url":"https://huggingface.co/models?sort={sort}","steps":[{"action":"wait","ms":3000},{"action":"fill","selector":"input[placeholder=\"Filter by name\"]","value":"{q}"},{"action":"wait","ms":3000}]},"match":{"path":"/models-json"},"response":{"format":"json","contentType":"application/json; charset=utf-8","extract":"models","pick":["id","author","name=id~/(.+)$","task=pipeline_tag","downloads","likes","lastModified","gated"],"shape":{"models[].author":"string","models[].downloads":"number","models[].gated":"boolean","models[].id":"string","models[].lastModified":"string","models[].likes":"number","models[].pipeline_tag":"null"}},"params":[{"name":"q","type":"string","required":true,"description":"words in the model id","example":"bert"},{"name":"sort","type":"string","required":false,"description":"ordering of the search results","example":"likes","default":"trending","enum":["trending","likes","downloads","created","modified"]}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"q":"bert","sort":"modified"},"expect":"result","purpose":"a non-default ordering returns a different set of recent model results"},{"args":{"q":"zzqqxxwvnothingmatch"},"expect":"empty","purpose":"a name nothing matches reads as an empty list"}],"links":[{"from":"author","to":{"op":"getModel","arg":"author"}},{"from":"name","to":{"op":"getModel","arg":"name"}}]}},{"hash":"7187555dd5e1a52912ebb4658e4c9a28132a00fc8aeefa4bd6eae440fecb8e2a","status":"live","confirmations":0,"registry":{"hash":"7187555dd5e1a52912ebb4658e4c9a28132a00fc8aeefa4bd6eae440fecb8e2a","status":"live","confirmations":0},"operation":{"name":"searchSpaces","description":"Search public Spaces by name, returning the first page of titles, SDKs, emoji, likes and last modification times.","request":{"method":"GET","url":"https://huggingface.co/spaces-json?search=%7Bq%7D&includeNonRunning=true&withCount=true","headers":{"accept":"*/*","referer":"https://huggingface.co/spaces","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\""}},"slots":[{"param":"q","at":["query:search"]}],"volatile":[],"trigger":{"url":"https://huggingface.co/spaces","steps":[{"action":"wait","ms":3000},{"action":"fill","selector":"input[placeholder=\"Filter by name\"]","value":"{q}"},{"action":"wait","ms":3000}]},"match":{"path":"/spaces-json"},"response":{"format":"json","contentType":"application/json; charset=utf-8","extract":"spaces","pick":["id","title","emoji","sdk","likes","lastModified"],"shape":{"spaces[].emoji":"string","spaces[].id":"string","spaces[].lastModified":"string","spaces[].likes":"number","spaces[].sdk":"string","spaces[].title":"string"}},"params":[{"name":"q","type":"string","required":true,"description":"words in the Space repository id","example":"gradio"}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"q":"zzqqxxwvnothingmatch"},"expect":"empty","purpose":"an unmatched name returns an empty list"}]}}]}