{"openapi":"3.1.0","info":{"title":"Hugging Face API","version":"1.0.0","description":"The Hugging Face Hub as an API — the central, open registry of machine-learning models and datasets that powers much of the modern AI ecosystem. This API wraps the public huggingface.co Hub into clean JSON. /v1/models searches the Hub's models and lets you filter by task (pipeline_tag — e.g. text-generation, text-to-image, image-classification, automatic-speech-recognition, sentence-similarity) and by library (transformers, diffusers, sentence-transformers, …), sorted by downloads, likes, last-modified, created or trending score — each model returned with its id, author, task, library, download and like counts, license, tags and timestamps. /v1/model?id=google-bert/bert-base-uncased returns a single model's full metadata. /v1/datasets searches ML datasets the same way, and /v1/dataset?id=ILSVRC/imagenet-1k returns a single dataset's metadata. Ids are in org/name form (take them from the search endpoints). Ideal for ML and MLOps tooling, model-discovery and comparison sites, AI leaderboards and dashboards, and AI assistants that recommend models. Data comes from the public Hugging Face Hub (free to use). This is the AI/ML model and dataset hub — distinct from software-package registries (npm, PyPI, Maven, NuGet) and academic paper indexes (arXiv).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/huggingface-api","description":"oanor gateway"}],"tags":[{"name":"Models"},{"name":"Datasets"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/model":{"get":{"operationId":"get_v1_model","tags":["Models"],"summary":"A model metadata","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Model id (org/name), e.g. google-bert/bert-base-uncased","schema":{"type":"string"},"example":"google-bert/bert-base-uncased"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"model":{"id":"google-bert/bert-base-uncased","url":"https://huggingface.co/google-bert/bert-base-uncased","tags":["transformers","pytorch","tf","jax","rust","coreml","onnx","safetensors","bert","fill-mask","exbert","en"],"gated":false,"likes":2670,"author":"google-bert","created":"2022-03-02T23:29:04.000Z","library":"transformers","license":"apache-2.0","private":false,"downloads":68246210,"pipeline_tag":"fill-mask","last_modified":"2024-02-19T11:06:12.000Z"}},"meta":{"timestamp":"2026-06-01T16:23:34.249Z","request_id":"faa324f1-f936-4105-87e1-8f6e1c58ea0f"},"status":"ok","message":"Model retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/models":{"get":{"operationId":"get_v1_models","tags":["Models"],"summary":"Search ML models","description":"","parameters":[{"name":"search","in":"query","required":false,"description":"Search text, e.g. bert","schema":{"type":"string"},"example":"bert"},{"name":"pipeline_tag","in":"query","required":false,"description":"Task, e.g. text-generation","schema":{"type":"string"}},{"name":"library","in":"query","required":false,"description":"Library, e.g. transformers","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"downloads, likes, lastModified, trendingScore","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"models":[{"id":"google-bert/bert-base-uncased","url":"https://huggingface.co/google-bert/bert-base-uncased","tags":["transformers","pytorch","tf","jax","rust","coreml","onnx","safetensors","bert","fill-mask","exbert","en"],"likes":2670,"author":"google-bert","created":"2022-03-02T23:29:04.000Z","library":"transformers","license":"apache-2.0","downloads":68246210,"pipeline_tag":"fill-mask"},{"id":"google-bert/bert-large-uncased","url":"https://huggingface.co/google-bert/bert-large-uncased","tags":["transformers","pytorch","tf","jax","rust","safetensors","bert","fill-mask","en","endpoints_compatible"],"likes":146,"author":"google-bert","created":"2022-03-02T23:29:04.000Z","library":"transformers","license":"apache-2.0","downloads":5634013,"pipeline_tag":"fill-mask"},{"id":"google-bert/bert-base-multilingual-uncased","url":"https://huggingface.co/google-bert/bert-base-multilingual-uncased","tags":["transformers","pytorch","tf","jax","safetensors","bert","fill-mask","multilingual","af","sq","ar","an"],"likes":157,"author":"google-bert","created":"2022-03-02T23:29:04.000Z","library":"transformers","license":"apache-2.0","downloads":4369054,"pipeline_tag":"fill-mask"},{"id":"google-bert/bert-base-cased","url":"https://huggingface.co/google-bert/bert-base-cased","tags":["transformers","pytorch","tf","jax","safetensors","bert","fill-mask","exbert","en","endpoints_compatible"],"likes":358,"author":"google-bert","created":"2022-03-02T23:29:04.000Z","library":"transformers","license":"apache-2.0","downloads":4300127,"pipeline_tag":"fill-mask"},{"id":"facebook/w2v-bert-2.0","url":"https://huggingface.co/facebook/w2v-bert-2.0","tags":["transformers","safetensors","wav2vec2-bert","feature-extraction","af","am","ar","as","az","be","bn","bs"],"likes":217,"author":"facebook","created":"2023-12-19T07:41:49.000Z","library":"transformers","license":"mit","downloads":4171140,"pipeline_tag":"feature-extraction"},{"id":"google-bert/bert-base-multilingual-cased","url":"https://huggingface.co/google-bert/bert-base-multilingual-cased","tags":["transformers","pytorch","tf","jax","safetensors","bert","fill-mask","multilingual","af","sq","ar","an"],"likes":591,"author":"google-bert","created":"2022-03-02T23:29:04.000Z","library":"transformers","license":"apache-2.0","downloads":4010918,"pipeline_tag":"fill-mask"},{"id":"neuralmind/bert-large-portuguese-cased","url":"https://huggingface.co/neuralmind/bert-large-portuguese-cased","tags":["transformers","pytorch","jax","bert","fill-mask","pt","endpoints_compatible"],"likes":73,"author":"neuralmind","created":"2022-03-02T23:29:05.000Z","library":"transformers","license":"mit","downloads":2061925,"pipeline_tag":"fill-mask"},{"id":"prajjwal1/bert-tiny","url":"https://huggingface.co/prajjwal1/bert-tiny","tags":["transformers","pytorch","BERT","MNLI","NLI","transformer","pre-training","en","endpoints_compatible"],"likes":146,"author":"prajjwal1","created":"2022-03-02T23:29:05.000Z","library":"transformers","license":"mit","downloads":1778012},{"id":"dslim/bert-base-NER","url":"https://huggingface.co/dslim/bert-base-NER","tags":["transformers","pytorch","tf","jax","onnx","safetensors","bert","token-classification","en","model-index","endpoints_compatible"],"likes":718,"author":"dslim","created":"2022-03-02T23:29:05.000Z","library":"transformers","license":"mit","downloads":1563231,"pipeline_tag":"token-classification"},{"id":"dominguesm/legal-bert-base-cased-ptbr","url":"https://huggingface.co/dominguesm/legal-bert-base-cased-ptbr","tags":["transformers","pytorch","tensorboard","safetensors","bert","fill-mask","legal","pt","model-index","endpoints_compatible"],"likes":15,"author":"dominguesm","created":"2022-10-09T13:27:55.000Z","library":"transformers","license":"cc-by-4.0","downloads":1247723,"pipeline_tag":"fill-mask"},{"id":"YituTech/conv-bert-base","url":"https://huggingface.co/YituTech/conv-bert-base","tags":["transformers","pytorch","tf","convbert","feature-extraction","endpoints_compatible"],"likes":10,"author":"YituTech","created":"2022-03-02T23:29:05.000Z","library":"transformers","downloads":1063416,"pipeline_tag":"feature-extraction"},{"id":"sentence-transformers-testing/stsb-bert-tiny-safetensors","url":"https://huggingface.co/sentence-transformers-testing/stsb-bert-tiny-safetensors","tags":["sentence-transformers","pytorch","safetensors","bert","feature-extraction","sentence-similarity","transformers","text-embeddings-inference","endpoints_compatible"],"likes":4,"author":"sentence-transformers-testing","created":"2023-11-06T13:20:57.000Z","library":"sentence-transformers","downloads":1047331,"pipeline_tag":"sentence-similarity"},{"id":"nlptown/bert-base-multilingual-uncased-sentiment","url":"https://huggingface.co/nlptown/bert-base-multilingual-uncased-sentiment","tags":["transformers","pytorch","tf","jax","safetensors","bert","text-classification","en","nl","de","fr","it"],"likes":477,"author":"nlptown","created":"2022-03-02T23:29:05.000Z","library":"transformers","license":"mit","downloads":1013408,"pipeline_tag":"text-classification"},{"id":"google-bert/bert-base-chinese","url":"https://huggingface.co/google-bert/bert-base-chinese","tags":["transformers","pytorch","tf","jax","safetensors","bert","fill-mask","zh","endpoints_compatible"],"likes":1429,"author":"google-bert","created":"2022-03-02T23:29:04.000Z","library":"transformers","license":"apache-2.0","downloads":813962,"pipeline_tag":"fill-mask"},{"id":"GozdeA/finetuned-bertweet-poskd3","url":"https://huggingface.co/GozdeA/finetuned-bertweet-poskd3","tags":["transformers","safetensors","distilbert","token-classification","endpoints_compatible"],"likes":0,"author":"GozdeA","created":"2025-04-03T01:14:52.000Z","library":"transformers","downloads":749306,"pipeline_tag":"token-classification"},{"id":"dbmdz/bert-large-cased-finetuned-conll03-english","url":"https://huggingface.co/dbmdz/bert-large-cased-finetuned-conll03-english","tags":["transformers","pytorch","tf","jax","rust","safetensors","bert","token-classification","endpoints_compatible"],"likes":96,"author":"dbmdz","created":"2022-03-02T23:29:05.000Z","library":"transformers","downloads":696018,"pipeline_tag":"token-classification"},{"id":"jinaai/jina-bert-flash-implementation","url":"https://huggingface.co/jinaai/jina-bert-flash-implementation","tags":["transformers","bert","custom_code","endpoints_compatible"],"likes":5,"author":"jinaai","created":"2024-02-21T11:19:46.000Z","library":"transformers","downloads":657479},{"id":"aubmindlab/bert-base-arabertv02","url":"https://huggingface.co/aubmindlab/bert-base-arabertv02","tags":["transformers","pytorch","tf","jax","tensorboard","safetensors","bert","fill-mask","ar","endpoints_compatible"],"likes":44,"author":"aubmindlab","created":"2022-03-02T23:29:05.000Z","library":"transformers","downloads":611250,"pipeline_tag":"fill-mask"},{"id":"sentence-transformers/msmarco-bert-base-dot-v5","url":"https://huggingface.co/sentence-transformers/msmarco-bert-base-dot-v5","tags":["sentence-transformers","pytorch","tf","onnx","safetensors","openvino","bert","feature-extraction","sentence-similarity","transformers","en","text-embeddings-inference"],"likes":21,"author":"sentence-transformers","created":"2022-03-02T23:29:05.000Z","library":"sentence-transformers","downloads":563302,"pipeline_tag":"sentence-similarity"},{"id":"google-bert/bert-base-german-cased","url":"https://huggingface.co/google-bert/bert-base-german-cased","tags":["transformers","pytorch","tf","jax","onnx","safetensors","bert","fill-mask","exbert","de","endpoints_compatible"],"likes":82,"author":"google-bert","created":"2022-03-02T23:29:04.000Z","library":"transformers","license":"mit","downloads":497257,"pipeline_tag":"fill-mask"}],"search":"bert"},"meta":{"timestamp":"2026-06-01T16:23:34.459Z","request_id":"c37d8677-a912-4a8f-9785-2dfb2690149e"},"status":"ok","message":"Models retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/dataset":{"get":{"operationId":"get_v1_dataset","tags":["Datasets"],"summary":"A dataset metadata","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Dataset id (org/name), e.g. ILSVRC/imagenet-1k","schema":{"type":"string"},"example":"ILSVRC/imagenet-1k"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"dataset":{"id":"ILSVRC/imagenet-1k","url":"https://huggingface.co/datasets/ILSVRC/imagenet-1k","tags":[],"gated":"auto","likes":819,"author":"ILSVRC","license":"other","downloads":76389,"last_modified":"2025-09-17T04:58:55.000Z"}},"meta":{"timestamp":"2026-06-01T16:23:34.676Z","request_id":"1609cd19-aea4-4e4a-8564-178a1d662e95"},"status":"ok","message":"Dataset retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/datasets":{"get":{"operationId":"get_v1_datasets","tags":["Datasets"],"summary":"Search datasets","description":"","parameters":[{"name":"search","in":"query","required":false,"description":"Search text, e.g. imagenet","schema":{"type":"string"},"example":"imagenet"},{"name":"sort","in":"query","required":false,"description":"downloads, likes, lastModified","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"search":"imagenet","datasets":[{"id":"ILSVRC/imagenet-1k","url":"https://huggingface.co/datasets/ILSVRC/imagenet-1k","tags":[],"likes":819,"author":"ILSVRC","license":"other","downloads":76389,"last_modified":"2025-09-17T04:58:55.000Z"},{"id":"ShaomuTan/imagenette","url":"https://huggingface.co/datasets/ShaomuTan/imagenette","tags":[],"likes":0,"author":"ShaomuTan","license":"apache-2.0","downloads":25867,"last_modified":"2026-04-03T12:56:42.000Z"},{"id":"zh-plus/tiny-imagenet","url":"https://huggingface.co/datasets/zh-plus/tiny-imagenet","tags":[],"likes":98,"author":"zh-plus","downloads":25097,"last_modified":"2022-07-12T09:04:30.000Z"},{"id":"ilee0022/ImageNet100","url":"https://huggingface.co/datasets/ilee0022/ImageNet100","tags":[],"likes":6,"author":"ilee0022","downloads":24465,"last_modified":"2024-04-23T05:23:58.000Z"},{"id":"gmongaras/CC12M_and_Imagenet21K_Recap","url":"https://huggingface.co/datasets/gmongaras/CC12M_and_Imagenet21K_Recap","tags":[],"likes":10,"author":"gmongaras","downloads":23606,"last_modified":"2025-09-17T18:21:25.000Z"},{"id":"jiachenlei/imagenet","url":"https://huggingface.co/datasets/jiachenlei/imagenet","tags":[],"likes":4,"author":"jiachenlei","downloads":17219,"last_modified":"2024-11-28T02:31:55.000Z"},{"id":"vrachit/imagenet-1k-webdataset","url":"https://huggingface.co/datasets/vrachit/imagenet-1k-webdataset","tags":[],"likes":0,"author":"vrachit","downloads":13421,"last_modified":"2025-12-26T06:27:43.000Z"},{"id":"adams-story/imagenet1k-256-wds-latents","url":"https://huggingface.co/datasets/adams-story/imagenet1k-256-wds-latents","tags":[],"likes":0,"author":"adams-story","downloads":11216,"last_modified":"2024-11-22T18:16:52.000Z"},{"id":"chenweicui/Imagenet21K","url":"https://huggingface.co/datasets/chenweicui/Imagenet21K","tags":[],"likes":0,"author":"chenweicui","downloads":9612,"last_modified":"2026-05-01T19:32:21.000Z"},{"id":"timm/imagenet-1k-wds","url":"https://huggingface.co/datasets/timm/imagenet-1k-wds","tags":["webdataset"],"likes":34,"author":"timm","license":"other","downloads":8695,"last_modified":"2024-01-07T18:12:43.000Z"},{"id":"timm/mini-imagenet","url":"https://huggingface.co/datasets/timm/mini-imagenet","tags":[],"likes":26,"author":"timm","license":"other","downloads":8203,"last_modified":"2024-11-20T22:44:47.000Z"},{"id":"Aditmeh/imagenet21k-dinov3-embeddings","url":"https://huggingface.co/datasets/Aditmeh/imagenet21k-dinov3-embeddings","tags":[],"likes":0,"author":"Aditmeh","downloads":7780,"last_modified":"2026-05-01T08:34:13.000Z"},{"id":"timm/imagenet-22k-wds","url":"https://huggingface.co/datasets/timm/imagenet-22k-wds","tags":["webdataset"],"likes":14,"author":"timm","license":"other","downloads":7222,"last_modified":"2024-01-29T08:06:46.000Z"},{"id":"ChristophSchuhmann/Imagenet-1k-SD-1.4","url":"https://huggingface.co/datasets/ChristophSchuhmann/Imagenet-1k-SD-1.4","tags":[],"likes":5,"author":"ChristophSchuhmann","license":"apache-2.0","downloads":6452,"last_modified":"2023-01-28T12:05:26.000Z"},{"id":"evanarlian/imagenet_1k_resized_256","url":"https://huggingface.co/datasets/evanarlian/imagenet_1k_resized_256","tags":[],"likes":28,"author":"evanarlian","license":"other","downloads":5801,"last_modified":"2023-08-01T10:26:36.000Z"},{"id":"spaicom-lab/semasia-imagenet-1k","url":"https://huggingface.co/datasets/spaicom-lab/semasia-imagenet-1k","tags":[],"likes":0,"author":"spaicom-lab","downloads":5780,"last_modified":"2026-05-28T16:11:32.000Z"},{"id":"gmongaras/Imagenet21K","url":"https://huggingface.co/datasets/gmongaras/Imagenet21K","tags":[],"likes":6,"author":"gmongaras","downloads":5526,"last_modified":"2025-02-03T04:57:53.000Z"},{"id":"rudanie89/tiny_imagenet_60k","url":"https://huggingface.co/datasets/rudanie89/tiny_imagenet_60k","tags":[],"likes":0,"author":"rudanie89","downloads":5335,"last_modified":"2026-04-10T03:05:57.000Z"},{"id":"rudanie89/tiny_imagenet_valid","url":"https://huggingface.co/datasets/rudanie89/tiny_imagenet_valid","tags":[],"likes":0,"author":"rudanie89","downloads":5269,"last_modified":"2026-04-10T04:31:04.000Z"},{"id":"clane9/imagenet-100","url":"https://huggingface.co/datasets/clane9/imagenet-100","tags":[],"likes":12,"author":"clane9","downloads":5157,"last_modified":"2024-05-04T01:24:09.000Z"}]},"meta":{"timestamp":"2026-06-01T16:23:34.882Z","request_id":"e31392e9-6a82-484a-b6ad-a28893c71f93"},"status":"ok","message":"Datasets retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Hugging Face Hub is the central registry of open AI/ML models and datasets. /v1/models = search models, filter by pipeline_tag (the task, e.g. text-generation, image-classification, text-to-image, automatic-speech-recognition) and by library (transformers, diffusers, …), sorted by downloads, likes, lastModified or trendingScore — each result with its id, author, task, library, download and like counts, license, tags and timestamps; /v1/model?id=google-bert/bert-base-uncased = a single model's metadata; /v1/datasets = search datasets the same way; /v1/dataset?id=ILSVRC/imagenet-1k = a single dataset's metadata. Ids are org/name (use them from /v1/models or /v1/datasets). Data from the public Hugging Face Hub (free). Distinct from software-package registries (npm, PyPI, Maven, …) and academic paper indexes (arXiv) — this is the AI/ML model & dataset hub. Ideal for ML tooling, model-discovery and leaderboard sites, MLOps dashboards and AI assistants.","source":"Hugging Face Hub API (huggingface.co/api)","endpoints":["/v1/models","/v1/model","/v1/datasets","/v1/dataset","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:23:34.971Z","request_id":"0de45785-3b98-45f1-a099-4f91822c2231"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2800,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":700,"monthly_call_quota":55000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2300,"monthly_call_quota":240000,"rps_limit":12,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6300,"monthly_call_quota":880000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/huggingface-api"}