# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/fineartamerica/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/fineartamerica/get-artist-about \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fineartamerica/get-artist-contact-form \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fineartamerica/get-artist-directory \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fineartamerica/get-artist-images \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fineartamerica/get-artist-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fineartamerica/search-artworks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/fineartamerica/submit-artist-contact-form \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"artist_id":"<string>","captcha_token":"<string>","email":"<string>","message":"<string>","name":"<string>","subject":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.