▣ DATA EXTRACTION

Art Search 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	Description
type	String	Artwork type filter. Pattern: any string, max length 1000.
query	String	Search text. Pattern: any string, max length 300.
number	Integer	Number of results to return. Minimum 1, maximum 10.
offset	Integer	Pagination offset. Minimum 0, maximum 1000.
origin	String	Origin filter. Pattern: any string, max length 100.
material	String	Material filter. Pattern: any string, max length 1000.
max-ratio	Number	Maximum ratio filter. Minimum 0, maximum 10.
min-ratio	Number	Minimum ratio filter. Minimum 0, maximum 10.
technique	String	Technique filter. Pattern: any string, max length 13.
latest-end-date	Integer	Latest end date filter.
earliest-end-date	Integer	Earliest end date filter.
latest-start-date	Integer	Latest start date filter.
earliest-start-date	Integer	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	Description
number	Integer	Number value echoed in the response.
offset	Integer	Offset value echoed in the response.
artworks	Object Array	List of matching artworks. Each item contains `id`, `image`, and `title`.
artworks[].id	Integer	Artwork identifier.
artworks[].image	String	Artwork image URL or value; nullable.
artworks[].title	String	Artwork title; nullable.
available	Integer	Total number of artworks available for the given search criteria.

▣ 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	Description
id	Integer	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	Description
id	Integer	Artwork identifier.
image	String	Artwork image URL or reference. Nullable.
title	String	Artwork title. Nullable.
end_date	Integer	Artwork end date.
start_date	Integer	Artwork start date.
description	String	Artwork description. Nullable.

▣ 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	Description
id	Integer	Artwork identifier.
image	String	Artwork image reference or URL. Nullable.
title	String	Artwork title. Nullable.
end_date	Integer	Artwork end date.
start_date	Integer	Artwork start date.
description	String	Artwork description. Nullable.
author	String	Artist name. Nullable.
origin	String	Country/region of origin. Nullable.
art_types[]	Array of Strings	Artwork type tags, e.g. photograph.
subjects[]	Array of Strings	Subject tags, e.g. dish.
materials[]	Array of Strings	Material tags, e.g. paper, silver.
techniques[]	Array of Strings	Technique tags, e.g. photographing.

▣ 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.

CALLGameBrain APISkycraft CALLSearch US Places APIDosvak LLC CALLBig Book APISkycraft CALLFood Search & Trivia APISkycraft

From the blog

Reads that touch this API.

Top Data Extraction APIs for Developers in 2025Jul 9, 2026 Web Data Extraction: Use Cases and ApproachesJul 9, 2026 Image watermarking APIs in 2026: visible overlays, invisible marks, and which to useSep 23, 2026 Exploring the Top Video Thumbnail ( Preview) APIsJul 9, 2026