# Hugging Face — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Discover and browse the most popular Hugging Face Spaces ranked by likes, trending score, or recent updates to find the best machine learning demos and tools for your needs. Filter through top-performing projects to quickly identify trending applications and highly-rated community contributions.

**Category:** Developer Tools | **Website:** [huggingface.co/](https://huggingface.co/) | **Docs:** [parse.bot/marketplace/8c59c63b-7661-4ff7-927a-f10054f8ca15/huggingface-co-api](https://parse.bot/marketplace/8c59c63b-7661-4ff7-927a-f10054f8ca15/huggingface-co-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-huggingface-co-api-8c59c63b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### list_top_spaces

List Spaces ranked by the chosen sort criterion. Each Space includes its identifier, title, author, like count, SDK, tags, and timestamps. Results are returned as a single page; pass offset to advance manually. When sort is trendingScore, each item also carries its trending_score.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `direction` | string | No | Sort direction: -1 for descending, 1 for ascending. |
| `limit` | integer | No | Number of Spaces to return per page (1–100). |
| `offset` | integer | No | Number of items to skip for pagination. |
| `search` | string | No | Free-text filter applied to Space names and descriptions. Omit to return all Spaces. |
| `sort` | string | No | Ranking criterion for the returned list. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-huggingface-co-api-8c59c63b/list_top_spaces \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"direction":"<string>","limit":"<integer>","offset":"<integer>","search":"<string>","sort":"<string>"}'
```