▣ DATA EXTRACTION

Find & Explore Artworks API

What it does

Art Search lets you search artworks by query, type, origin, material, technique, and date range, then fetch a specific artwork or a random one by ID. Use it when you need a simple art catalog lookup layer without building your own metadata index.

Send search filters like query, type, origin, material, technique, number, offset, and date bounds such as earliest-start-date or latest-end-date. The search response returns number, offset, available, and an artworks array with each item's id, image, and title, so you can page through results and render lightweight previews.

If you already have an artwork ID, retrieve the full record with id. That response includes id, image, title, start_date, end_date, and description. The random artwork endpoint returns the same object shape, which is useful for discovery features, featured picks, or QA fixtures.

Use Art Search when you need to browse museum-style records, power an internal art catalog, or surface artwork details in a gallery app, marketplace, or editorial workflow.

▣ ENDPOINT 01 / 03

GET

Search Artworks

https://api.eu.apyhub.com/skycraft/art-search-api/artworks

QUICKSTART

GUIDE

Quickstart

Search the art catalog with a simple query and return the first results.

curl -X GET "https://api.eu.apyhub.com/skycraft/art-search-api/artworks?query=landscape%20paintings&number=10" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with number and offset integers, an available integer, and an artworks array of objects. Each artwork object includes id as an integer, plus image and title strings that may be null.

{
  "number": 10,
  "offset": 0,
  "available": 124,
  "artworks": [
    {
      "id": 12345,
      "image": "https://example.com/art.jpg",
      "title": "Landscape with Trees"
    }
  ]
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Searches for artworks using the provided query filters and returns a paginated list of matching artworks. The response includes the requested number, offset, a collection of artworks, and the total available count.

Query Parameter(s)

Attribute	Type	Mandatory	Description
type	String	No	Artwork type filter. Pattern: any string, max length 1000.
query	String	Yes	Search text. Pattern: any string, max length 300.
number	Integer	No	Number of results to return. Minimum 1, maximum 10.
offset	Integer	No	Pagination offset. Minimum 0, maximum 1000.
origin	String	No	Origin filter. Pattern: any string, max length 100.
material	String	No	Material filter. Pattern: any string, max length 1000.
max-ratio	Number	No	Maximum ratio filter. Minimum 0, maximum 10.
min-ratio	Number	No	Minimum ratio filter. Minimum 0, maximum 10.
technique	String	No	Technique filter. Pattern: any string, max length 13.
latest-end-date	Integer	No	Latest end date filter.
earliest-end-date	Integer	No	Earliest end date filter.
latest-start-date	Integer	No	Latest start date filter.
earliest-start-date	Integer	No	Earliest start date filter.

Response

Returns a JSON object with number and offset integers, an artworks array of objects, and an available integer. Each artwork item contains an id integer, plus nullable image and title string fields.

Parameter	Type	Mandatory	Description
number	Integer	No	Number value echoed in the response.
offset	Integer	No	Offset value echoed in the response.
artworks	Object Array	No	List of matching artworks. Each item contains `id`, `image`, and `title`.
artworks[].id	Integer	No	Artwork identifier.
artworks[].image	String	No	Artwork image URL or value; nullable.
artworks[].title	String	No	Artwork title; nullable.
available	Integer	No	Total number of artworks available for the given search criteria.

Query parameters

Name

Type

Description

typeOPTIONAL

string

—

queryREQUIRED

string

—

numberOPTIONAL

integer

—

offsetOPTIONAL

integer

—

originOPTIONAL

string

—

materialOPTIONAL

string

—

max-ratioOPTIONAL

number

—

min-ratioOPTIONAL

number

—

techniqueOPTIONAL

string

—

latest-end-dateOPTIONAL

integer

—

earliest-end-dateOPTIONAL

integer

—

latest-start-dateOPTIONAL

integer

—

earliest-start-dateOPTIONAL

integer

—

▣ ENDPOINT 02 / 03

GET

Retrieve Artwork by Id

https://api.eu.apyhub.com/skycraft/art-search-api/artworks/retrieve/:id

QUICKSTART

GUIDE

Quickstart

Fetch an art listing by its path id.

curl -X GET "https://api.eu.apyhub.com/skycraft/art-search-api/artworks/retrieve/:id" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with these top-level fields: id (integer), image (string or null), title (string or null), end_date (integer), start_date (integer), and description (string or null).

{
  "id": 26226350,
  "image": "https://example.com/art.jpg",
  "title": "Sunset Study",
  "end_date": 1717200000,
  "start_date": 1714608000,
  "description": "A contemporary landscape artwork."
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves a single artwork by its numeric ID and returns the artwork record as a JSON object.

Path Parameter(s)

Attribute	Type	Mandatory	Description
id	Integer	Yes	Artwork identifier in `int32` format, minimum `0`, maximum `99999999`.

Response

Returns a JSON object with the artwork fields id (integer), image (string, nullable), title (string, nullable), end_date (integer), start_date (integer), and description (string, nullable).

Parameter	Type	Mandatory	Description
id	Integer	Yes	Artwork identifier.
image	String	No	Artwork image URL or reference. Nullable.
title	String	No	Artwork title. Nullable.
end_date	Integer	No	Artwork end date.
start_date	Integer	No	Artwork start date.
description	String	No	Artwork description. Nullable.

Path parameters

Name

Type

Description

idREQUIRED

string

The numeric id of the artwork.

▣ ENDPOINT 03 / 03

GET

Random Artwork

https://api.eu.apyhub.com/skycraft/art-search-api/artworks/random

QUICKSTART

GUIDE

Quickstart

Fetch the art search result with no request body.

curl -X GET "https://api.eu.apyhub.com/skycraft/art-search-api/artworks/random" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with these top-level fields: id as an integer, image, title, and description as nullable strings, and start_date and end_date as integers.

{
  "id": 123,
  "image": "https://example.com/art.jpg",
  "title": "Sunset Over Water",
  "end_date": 1717200000,
  "start_date": 1717113600,
  "description": "A landscape artwork."
}

TRY ITLIVE · 20 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns a random artwork as a JSON object, including its numeric identifier, date range, and optional text/image metadata.

Response

Returns a JSON object with id, image, title, end_date, start_date, and description fields.

Parameter	Type	Mandatory	Description
id	Integer	Yes	Artwork identifier.
image	String	Yes	Artwork image reference or URL. Nullable.
title	String	Yes	Artwork title. Nullable.
end_date	Integer	Yes	Artwork end date.
start_date	Integer	Yes	Artwork start date.
description	String	Yes	Artwork description. Nullable.
author	String	No	Artist name. Nullable.
origin	String	No	Country/region of origin. Nullable.
art_types[]	Array of Strings	No	Artwork type tags, e.g. photograph.
subjects[]	Array of Strings	No	Subject tags, e.g. dish.
materials[]	Array of Strings	No	Material tags, e.g. paper, silver.
techniques[]	Array of Strings	No	Technique tags, e.g. photographing.

Parameters

No parameters.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLFind & Explore Games APISkycraft CALLSearch US Places APIDosvak LLC CALLSearch Books & Authors APISkycraft CALLAnalyze AI Search Performance APISE Ranking SEO & AI Search API

From the blog

Reads that touch this API.

Top Data Extraction APIs for Developers in 2025Apr 17, 2025 Web Data Extraction: Use Cases and ApproachesJul 23, 2025 Image watermarking APIs in 2026: visible overlays, invisible marks, and which to useApr 14, 2025 Exploring the Top Video Thumbnail ( Preview) APIsMar 19, 2024