> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt). ## This page - **On-site (HTML):** - **Markdown (.mdx) URL:** --- # Hugging Face Search API One query across every kind of result, grouped so you can see what exists before you open a list. `GET /v1/hugging-face/search` takes a required `query` and an optional `type` (`model`, `dataset`, `space`, `org`, `user`, `paper`, `collection`, `bucket`, `kernel` or `blog`). It returns `query` and ten groups: `models`, `datasets`, `spaces`, `organizations`, `users`, `papers`, `collections`, `buckets`, `kernels` and `blogs`. Each group has `total` and `items`, and each item has `id`, `url` and `title` where the match has one. Groups that do not match are empty. This is a discovery call; use the per-kind endpoints to page a full result set. ## Request - **Endpoint:** `GET /v1/hugging-face/search` - **Credits:** 1 credit Failed requests are free - **Input:** by keyword - **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/hugging-face/search/get) - **Platform page:** [/platforms/hugging-face](https://www.socialfetch.dev/platforms/hugging-face) ## FAQ ### How many results come back? A few per group, enough to show what matches. This endpoint has no cursor; use the per-kind search endpoints to page. ### Can I search only papers? Yes. Set type=paper. Omit type to search every kind. ### Does a group with no matches return an error? No. Its total is 0 and its items are empty. HTTP 200 only means the request finished. ### How much does a global search cost? Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.