# Riseart — 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 explore artworks by title, artist, or style, then view detailed information and high-quality images of paintings and artist portfolios from Rise Art's curated collection. Discover new artists and browse their complete galleries to find pieces that match your taste.

**Category:** Marketplaces | **Website:** [riseart.com/](https://riseart.com/) | **Docs:** [parse.bot/marketplace/d9c7a7e7-be60-4850-8491-a767f30208c9/riseart-com-api](https://parse.bot/marketplace/d9c7a7e7-be60-4850-8491-a767f30208c9/riseart-com-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-riseart-com-api-d9c7a7e7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_artist_detail

Retrieve an artist's public profile by numeric ID or URL slug. At least one identifier must be provided. Returns name, biography, nationality, gender, rating, and profile image URL. If only artist_id is provided, the slug is resolved automatically from the artist's portfolio. Returns input_not_found when the artist page does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_id` | string | No | The artist's numeric ID (e.g. '49429'). |
| `slug` | string | No | The artist's URL slug (e.g. 'nadiaattura'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riseart-com-api-d9c7a7e7/get_artist_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist_id":"<string>","slug":"<string>"}'
```

### get_artist_page_images

List artworks in a specific artist's portfolio. Returns paginated artwork entries with image keys, pricing, and metadata. Use artist_id from search results or get_artist_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_id` | string | Yes | The artist's numeric ID (e.g. '49429'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riseart-com-api-d9c7a7e7/get_artist_page_images \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist_id":"<string>","page":"<integer>"}'
```

### get_artwork_detail_images

Retrieve full artwork details including high-resolution image metadata, SKU/pricing information across regions, framing options, edition size, shipping estimates, and seller info. Each SKU includes multi-currency pricing via the stores array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `art_id` | string | Yes | The artwork's numeric ID (e.g. '185115'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riseart-com-api-d9c7a7e7/get_artwork_detail_images \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"art_id":"<string>"}'
```

### list_artworks

Browse artworks with optional filters for medium, style, and subject. Returns paginated results sorted by the specified order. Without filters, returns all available artworks. Paginated via page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page. |
| `medium` | string | No | Filter by medium (e.g. 'paintings', 'prints', 'photography', 'sculpture', 'drawings'). |
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sort order for results. |
| `style` | string | No | Filter by style (e.g. 'abstract', 'figurative', 'realistic', 'impressionistic', 'expressionistic'). |
| `subject` | string | No | Filter by subject (e.g. 'landscapes', 'portraits', 'abstract', 'animals', 'nature'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riseart-com-api-d9c7a7e7/list_artworks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","medium":"<string>","page":"<integer>","sort":"<string>","style":"<string>","subject":"<string>"}'
```

### search_artworks

Full-text search over artworks on Rise Art. Returns paginated results matching the query against artwork titles, artist names, subjects, styles, and mediums. Each result includes artwork metadata (title, artist, medium, style, subject), image keys, and pricing. Paginated via page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g. 'landscape', 'abstract', 'portrait'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-riseart-com-api-d9c7a7e7/search_artworks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```