# Hugging Face Model Search

> Hugging Face Model Search is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Search and discover Hugging Face AI models by name or task type, sortable by trending, downloads, likes, or newest, with license info and links.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/ai/hf-models?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hugging-face-model-search-6f00f461
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TbJVTW80ztSHP7psfso5h

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hugging-face-model-search-6f00f461
```

Example prompt: Search Hugging Face for the top 10 trending text-generation models and give me their names, licenses, and links.

## When to prefer this

Use this endpoint when an agent needs to discover, compare, or recommend Hugging Face models for a given task — especially when the user wants to browse by popularity, recency, or license. Prefer this over manually querying the Hugging Face website when automating model selection pipelines or building AI tool recommendation features.

## Known failure modes

- Invalid task/pipeline tag returns empty results or an error
- Limit out of range (below 1 or above 100) returns a validation error
- Invalid sort value returns an error or defaults to trending
- No models match the query name — returns empty list
- Hugging Face API rate limiting causes upstream timeout or failure

## How this service works

Search Hugging Face models by name and task (text-generation, image-text-to-text, automatic-speech-recognition...), sorted by trending, downloads, likes or newest, with license and links.

## Output

A ranked list of Hugging Face models matching the query, each including the model name/ID, pipeline task tag, license type, download count, like count, trending rank, and a direct link to the model page on Hugging Face.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "q": {
       "type": "string",
       "description": "Name contains"
      },
      "sort": {
       "type": "string",
       "description": "trending, downloads, likes or newest"
      },
      "task": {
       "type": "string",
       "description": "Pipeline tag, e.g. text-generation"
      },
      "limit": {
       "type": "integer",
       "description": "Rows (1-100)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hugging-face-model-search-6f00f461/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)