# Higgsfield — 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.

> Search and browse AI-generated images created by the Higgsfield community, viewing the prompts, artistic styles, and metadata behind each generation. Discover creative inspiration by exploring how other users crafted their images and what techniques they used.

**Category:** Other | **Website:** [higgsfield.ai/community/generations](https://higgsfield.ai/community/generations) | **Docs:** [parse.bot/marketplace/9bed17eb-74d2-48e0-9c14-9fe123cb924b/higgsfield-ai-api](https://parse.bot/marketplace/9bed17eb-74d2-48e0-9c14-9fe123cb924b/higgsfield-ai-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-higgsfield-ai-api-9bed17eb/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### search_generations

Browse trending AI-generated images from the Higgsfield community. Returns generations ordered by trending score, each with its full prompt, generation parameters (dimensions, seed, style), result image URL, publication stats (views, likes), and creator profile. Results are auto-iterated via cursor-based pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cursor` | string | No | Opaque pagination cursor returned by the previous response. Omit for the first page. |
| `size` | integer | No | Number of generations to return per page (1–50). |
| `type` | string | No | Content type filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-higgsfield-ai-api-9bed17eb/search_generations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cursor":"<string>","size":"<integer>","type":"<string>"}'
```
