# Fineartamerica — 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 discover millions of artworks by style, medium, and artist, then browse detailed artist profiles and portfolios to connect directly with creators. Reach out to artists through integrated contact forms to inquire about commissions, purchases, or collaborations.

**Category:** Marketplaces | **Website:** [fineartamerica.com/](https://fineartamerica.com/) | **Docs:** [parse.bot/marketplace/d4e9e288-8098-4633-9195-c1ad6ba55346/fineartamerica-com-api](https://parse.bot/marketplace/d4e9e288-8098-4633-9195-c1ad6ba55346/fineartamerica-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-fineartamerica-com-api-d4e9e288/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_artist_about

Retrieve an artist's biography text from their About tab. Returns the full biography as a text block. Empty string if the artist has no biography.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Artist profile slug (e.g. 'scott-listfield'), obtainable from get_artist_directory results |

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

### get_artist_contact_form

Retrieve the contact form structure and reCAPTCHA sitekey for an artist. Returns form fields (name, type, label) and the Google reCAPTCHA v2 sitekey needed for form submission. Useful for discovering what fields are required to contact an artist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_id` | string | Yes | Numeric artist member ID, obtainable from get_artist_profile member_id field |

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

### get_artist_directory

Browse or search the artist directory on Fine Art America. Returns a paginated list of artists with name, location, join year, profile URL, and slug. Without keywords returns featured/all artists; with keywords filters by artist name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keywords` | string | No | Optional name filter to search artists by keyword |
| `page` | integer | No | Page number for pagination |

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

### get_artist_images

Retrieve artwork images for an artist from their artwork tab. Returns a paginated list of artworks with title, artwork page URL, and image URL. Each page returns up to ~24 artworks.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `slug` | string | Yes | Artist profile slug (e.g. 'scott-listfield'), obtainable from get_artist_directory results |

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

### get_artist_profile

Retrieve an artist's profile details including display name, numeric member ID, social media links, and contact form availability. The slug is obtained from the artist directory or artwork search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Artist profile slug (e.g. 'scott-listfield'), obtainable from get_artist_directory results |

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

### search_artworks

Full-text search over artworks on Fine Art America. Returns paginated results with artwork titles, URLs, image URLs, and artist info. Results are ordered by relevance. Pagination via integer page counter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `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-fineartamerica-com-api-d4e9e288/search_artworks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### submit_artist_contact_form

Submit a contact form message to an artist (requires a valid reCAPTCHA token).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_id` | string | Yes | Artist ID |
| `captcha_token` | string | Yes | reCAPTCHA g-recaptcha-response token |
| `email` | string | Yes | Sender email |
| `message` | string | Yes | Message content |
| `name` | string | Yes | Sender name |
| `subject` | string | Yes | Message subject |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fineartamerica-com-api-d4e9e288/submit_artist_contact_form \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist_id":"<string>","captcha_token":"<string>","email":"<string>","message":"<string>","name":"<string>","subject":"<string>"}'
```