---
title: "Search HuggingFace for models"
method: GET
path: "/v1/models/search"
tags: ["Models"]
---

# Search HuggingFace for models

`GET /v1/models/search`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/models/search`
- Auth: HTTP bearer

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Search results

- HFSearchResult[]
  - `id` string, required: HuggingFace repo ID
  - `downloads` integer
  - `likes` integer
  - `tags` string[]
  - `pipelineTag` string

## Other responses

- `400`: Invalid request
- `502`: HuggingFace API error

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)