fineartamerica.com APIfineartamerica.com ↗
Search millions of artworks, browse artist profiles, retrieve biographies, portfolio images, and contact forms from Fine Art America via 7 REST endpoints.
curl -X GET 'https://api.parse.bot/scraper/c3b479f4-3c49-4530-aec5-91ad833812ca/search_artworks?page=1&query=landscape' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for artworks by keyword. Returns paginated results with artwork titles, URLs, and image URLs.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| queryrequired | string | Search keyword (e.g. 'landscape', 'abstract') |
{
"type": "object",
"fields": {
"page": "integer — current page number",
"query": "string — the search keyword used",
"artworks": "array of artwork objects with title, url, image_url, and artist info",
"has_next_page": "boolean — whether more pages are available"
},
"sample": {
"data": {
"page": 1,
"query": "landscape",
"artworks": [
{
"url": "https://fineartamerica.com/featured/aspen-sunset-over-bear-lake-colorado-captures.html",
"title": "Majestic Mountain Lake at Sunset Print",
"artist": {
"url": null,
"name": "Unknown Artist"
},
"image_url": "https://render.fineartamerica.com/images/images-profile-flow/400/images/artworkimages/mediumlarge/1/aspen-sunset-over-bear-lake-mike-berenson.jpg"
}
],
"has_next_page": true
},
"status": "success"
}
}About the fineartamerica.com API
The Fine Art America API covers 7 endpoints for searching artworks by keyword, browsing the artist directory, and retrieving individual artist profiles with social links, biographies, and portfolio images. The search_artworks endpoint returns paginated results including artwork titles, URLs, image URLs, and artist info for any keyword query. Contact form discovery and submission are also supported, giving developers end-to-end access to artist outreach data.
Artwork and Artist Discovery
The search_artworks endpoint accepts a required query string and an optional page integer, returning an array of artwork objects—each with title, url, image_url, and attached artist info—alongside a has_next_page boolean for pagination. The get_artist_directory endpoint lets you browse or filter the full artist roster by optional keywords, returning each artist's name, location, join_year, url, and slug. The slug field is the key that links directory results to all profile-level endpoints.
Artist Profile and Portfolio Data
get_artist_profile returns structured profile data for a given slug, including member_id, profile_url, a social_links object keyed by platform (facebook, instagram, twitter, pinterest), and a contact_available boolean indicating whether the artist has a contact form enabled. get_artist_about fetches the artist's full biography text from their About tab. get_artist_images returns a paginated array of that artist's artworks—each with title, url, and image_url—useful for building portfolio displays or comparison tools.
Contact Form Access
get_artist_contact_form takes the numeric artist_id (available from get_artist_profile's member_id field) and returns the form's field definitions, submission action path, and a recaptcha_sitekey for Google reCAPTCHA v2. submit_artist_contact_form accepts name, email, subject, message, artist_id, and a captcha_token, then returns a confirmation message string. Note that a valid reCAPTCHA token must be generated client-side before calling the POST endpoint.
- Build an art discovery feed by querying
search_artworkswith style or subject keywords and displaying returnedimage_urlthumbnails. - Aggregate artist contact details—social platform URLs and contact availability—by iterating
get_artist_directoryandget_artist_profile. - Generate artist biography pages by pulling
biographytext fromget_artist_aboutalongside portfolio images fromget_artist_images. - Track when artists joined the platform by extracting
join_yearfromget_artist_directoryresults for trend analysis. - Power a commission-inquiry tool by using
get_artist_contact_formto render the correct fields, then submitting viasubmit_artist_contact_form. - Identify artists with active social presences by checking the
social_linksobject inget_artist_profilefor populated platform URLs. - Index artist portfolios for a curated gallery app by paginating through
get_artist_imagesresults per artist slug.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Fine Art America have an official developer API?+
What does `get_artist_profile` return beyond a name and URL?+
get_artist_profile returns the artist's member_id, profile_url, a social_links object with per-platform URLs for Facebook, Instagram, Twitter, and Pinterest, and a contact_available boolean. The member_id is also the value required as artist_id in the contact form endpoints.Does the API return artwork pricing or purchase information?+
search_artworks and get_artist_images include title, url, and image_url but do not include pricing, print sizes, or product options. You can fork this API on Parse and revise it to add an endpoint that retrieves per-artwork product and pricing details.Is there a limit to how `search_artworks` can be filtered beyond a keyword?+
query string and a page integer. Filtering by medium, style, or price range is not currently supported. You can fork this API on Parse and revise it to add additional filter parameters if the source exposes them.Does the contact form submission endpoint work without a reCAPTCHA token?+
submit_artist_contact_form requires a valid captcha_token (a Google reCAPTCHA v2 g-recaptcha-response). The recaptcha_sitekey needed to generate that token is returned by get_artist_contact_form. Calls made without a valid token will not complete form submission successfully.