Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: League Art API
description: API League is a Hub for World Class APIs.
termsOfService: https://apileague.com/terms
version: 1.9.0
contact:
name: David Urbansky
email: mail@apileague.com
servers:
- url: https://api.apileague.com
security:
- apiKey: []
- headerApiKey: []
tags:
- name: Art
paths:
/retrieve-random-poem:
get:
responses:
'200':
description: Success
headers: {}
content:
application/json:
schema:
type: object
properties:
title:
type:
- string
- 'null'
author:
type:
- string
- 'null'
poem:
type:
- string
- 'null'
examples:
Response:
value:
title: Purpose
author: Amos Russel Wells
poem: 'Deeply and long the sap must flow
Ere the merest layer of elm can grow.
Many a wave''s recurrent shock
Is needed to smooth the tiniest rock.
Thousands of leaves must fade and fall
To make the mold by the garden wall.
Thus, as the patient seasons roll,
Slowly is fashioned a human soul.
Purpose and failure and purpose still,
Steadily moved by a quiet will,—
Layer on layer in sturdy way,
Hardly seen the growth of a day,—
Times of failure and fear and fall,
But one strong tendency through it all,—
God and purpose and sun by sun
Reach the stars before they are done!
For I know the plans I have for you,” declares the Lord, “plans to prosper you and not to harm you, plans to give you hope and a future'
'401':
description: Unauthorized
'402':
description: Payment Required
'403':
description: Forbidden
'404':
description: Not Found
'406':
description: Not Acceptable
'429':
description: Too Many Requests
parameters:
- name: min-lines
description: The minimum number of lines of the poem.
schema:
format: int32
minimum: 0
maximum: 1000
type: integer
example: 5
required: false
style: form
explode: false
in: query
- name: max-lines
description: The maximum number of lines of the poem.
schema:
format: int32
minimum: 0
maximum: 1000
type: integer
example: 20
required: false
style: form
explode: false
in: query
externalDocs:
description: Read entire docs
url: https://apileague.com/apis/random-poem-api/
summary: Random Poem API
tags:
- Art
description: Retrieve a random poem by many famous authors. You can filter poem's by length (number of lines).
operationId: randomPoemAPI
deprecated: false
/convert-image-to-ascii-txt:
get:
responses:
'200':
description: Success
headers: {}
content:
text/plain:
schema:
type: string
examples:
Response:
value: '.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
..............................................,,,,,,,,...........................................
...........................................:+?%%%%%%%%*;,........................................
........................................,+%###S%????SS##S?;......................................
.......................................*S@#*;;:,,,,,::;+%##%;....................................
.....................................:%@S+:,............,;?##*,..................................
...................................,+##*,.................,;%#%:.................................
...................................*@S:.....................,*##;................................
..................................*#%:........................;#S;...............................
.................................*@%,..........................;#S:..............................
................................;#S:............................+@?,.............................
...............................,%#;..............................?#;.............................
...............................+#+...............................,SS,............................
..............................:S%,................................+@*............................
..............................+#+.................................,S#:...........................
.............................,?#:..................................*@*...........................
.............................,S?...................................,@%...........................
.............................:#+....................................%#,..........................
.............................;#;....................................+#:..........................
.............................*S,....................................:@+..........................
.............................?S,....................................:@*..........................
.............................*S,....................................:@+..........................
.............................?S,....................................:@*..........................
.............................*S,....................................:@+..........................
.............................:#;....................................*#:..........................
.............................:#*....................................SS,..........................
.............................,%%,..................................,@%...........................
..............................*#:..................................?@+...........................
..............................;#*.................................:##,...........................
..............................,%S,................................*@*............................
...............................;#*...............................:S%,............................
...............................,?#+.............................,%#:.............................
................................:##;............................*@*..............................
.................................+#S:..........................*#%,..............................
..................................;#S:.......................,*@%:...............................
...................................;SS+,....................:?#%:................................
....................................:%@S+.................,*##*,.................................
.....................................,+#@%;.............,*S@S;...................................
.......................................:?#@S?+;:,,,,:;*%#@S+,....................................
.........................................,+%#@@#####@@@#%;,......................................
............................................:+*?S#@S?*;,.........................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................:S@?,............................................
...............................................,?@@@+............................................
...............................................*#@@@S:...........................................
..............................................*@%%@@@?...........................................
.............................................+@S;?S%@#;..........................................
............................................+@#;,%S;%@S,.........................................
...........................................:##;.,%#::#@*.........................................
..........................................:##;..,%#:.*@#;........................................
.........................................;##;...,%#:.,%@S,.......................................
........................................:S#+....,%#:..:S@*.......................................
.......................................,%#*.....,%#:...+@#;......................................
......................................,%#*......,%#:...,%@S,.....................................
.....................................:%@+.......,%#:....:S@*.....................................
....................................,%@*........,%#:.....+@#;....................................
...................................,*@?,........,%#:.....,?@%,...................................
...................................*#?,.........,%#:......:%#+...................................
..................................*@?,..........,%#:.......;#S:..................................
................................,*@%,...........,%#:.......,*@?..................................
................................+@#;............,%#:........:S@+.................................
...............................;##;.............,%#:.........+#S:................................
..............................;S#;..............,%#:.........,?@*,...............................
.............................:S#;...............,%#:..........,%#;...............................
............................:#@*................,%#:...........:#%:..............................
...........................:#@*.................,%#:............*@*..............................
..........................,%@?..................,%#:............,SS:.............................
.........................,%@?...................,%#:.............;#?,............................
........................:%@?....................,%#:..............?@*............................
.......................:%@%,....................,%#:..............,##;...........................
......................,%@%,.....................,%#:...............;#S,..........................
......................*@S:......................,%#:................+@?..........................
....................,*@S:.......................,%#:.................?#;.........................
...................,*@S:........................,%#:.................:SS,........................
...................*@%:.........................,%#:..................+@?........................
..................+@%,..........................,%#:..................,%#;.......................
.................;#S:...........................,%#:...................:#S:......................
................:##;............................,%#:....................+@?,.....................
...............:S#;.............................,%#:....................,?#+.....................
..............;##;..............................,%#:.....................:SS:....................
.............:S#;...............................,%#:......................+#?,...................
............,%@+................................,%#:......................,?#+...................
...........,%@*.................................,%#:.......................:SS:..................
...........?@*..................................,%#:........................+#*..................
...........+*...................................,%#:........................,*;..................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................,%#:.............................................
................................................+#@+.............................................
...............................................;SS##;............................................
..............................................+#%;+#S;...........................................
.............................................+#S;..?@S:..........................................
............................................;#S;...,%@%,.........................................
..........................................,*#S:.....,%@?.........................................
.........................................,?@S:.......:S@*........................................
.........................................?@S:.........:S@+.......................................
........................................?@S:...........:##;......................................
.......................................?@S:.............+@#;.....................................
......................................?@S:...............+@S:....................................
....................................,?@S;.................*@%,...................................
...................................,*@S:...................*@*,..................................
..................................,?#%:....................,?#*..................................
.................................:%@?,......................,%#+.................................
................................:%@?,........................:S#;................................
...............................:%@?,..........................;##;...............................
..............................:%@?,............................+#S:..............................
.............................,%@?,..............................+#%..............................
............................,S@?,...............................,?@?.............................
...........................,S@%,.................................,%@;............................
..........................:S@*,...................................:S@;...........................
.........................;S#+......................................;S#:..........................
........................+#S;........................................:#S:.........................
.......................;##:..........................................;@%,........................
......................;##;............................................+@*........................
.....................;##:.............................................,%@*.......................
....................;##;...............................................,%#+......................
...................;#S;.................................................,S#;.....................
..................;S#;...................................................:#S:....................
.................+S#;.....................................................+#%:...................
...............,*#S;.......................................................+#?,..................
..............,*#%,.........................................................*#?,.................
.............,*@%,..........................................................,?@*.................
.............;@?,............................................................:%#:................
.............:*,..............................................................:+,................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................
.................................................................................................'
'401':
description: Unauthorized
'402':
description: Payment Required
'403':
description: Forbidden
'404':
description: Not Found
'406':
description: Not Acceptable
'429':
description: Too Many Requests
parameters:
- name: url
description: The URL to the image.
schema:
pattern: .
maxLength: 1000
type: string
example: https://upload.wikimedia.org/wikipedia/commons/3/35/Basic_human_drawing.png
required: true
style: form
explode: false
in: query
- name: width
description: The maximum width of the image (default 400, max. 500).
schema:
format: int32
minimum: 1
maximum: 500
type: integer
example: 200
required: false
style: form
explode: false
in: query
- name: height
description: The maximum height of the image (default 400, max. 500).
schema:
format: int32
minimum: 1
maximum: 500
type: integer
example: 200
required: false
style: form
explode: false
in: query
externalDocs:
description: Read entire docs
url: https://apileague.com/apis/image-to-ascii-art-api/
summary: Image to Ascii Art by URL API
tags:
- Art
description: Convert an image to ASCII art. You can pass the image URL as a query parameter. The API returns the ASCII art as plain text. This endpoint is using the GET method and an image URL as a query parameter.
operationId: imageToAsciiArtByURLAPI
deprecated: false
/search-artworks:
get:
responses:
'200':
description: Success
headers: {}
content:
application/json:
schema:
type: object
properties:
available:
type: integer
number:
type: integer
offset:
type: integer
artworks:
type: array
items:
type: object
properties:
id:
type: integer
title:
type:
- string
- 'null'
image:
type:
- string
- 'null'
examples:
Response:
value:
available: 993
number: 3
offset: 0
artworks:
- id: 25623857
title: Knightly Sword
image: https://img.apileague.com/artworks/knightly_sword_unknown23_1450.jpg
- id: 25426886
title: Sculpture of a Kneeling Knight or King
image: https://img.apileague.com/artworks/sculpture_of_a_kneeling_knight_or_king_unknown383_1250.jpg
- id: 25934005
title: A Knight in Armor
image: https://img.apileague.com/artworks/a_knight_in_armor_unknown32_1907.jpg
'401':
description: Unauthorized
'402':
description: Payment Required
'403':
description: Forbidden
'404':
description: Not Found
'406':
description: Not Acceptable
'429':
description: Too Many Requests
parameters:
- name: query
description: The search query.
schema:
pattern: .
maxLength: 300
type: string
example: landscape paintings
required: false
style: form
explode: false
in: query
- name: earliest-start-date
description: The artwork must have been created after this date.
schema:
format: int32
type: integer
example: 1750
required: false
style: form
explode: false
in: query
- name: latest-start-date
description: The artwork must have been created before this date.
schema:
format: int32
type: integer
example: 1755
required: false
style: form
explode: false
in: query
- name: earliest-end-date
description: For artworks with a period of creation, the completion date must be after this date.
schema:
format: int32
type: integer
example: 1751
required: false
style: form
explode: false
in: query
- name: latest-end-date
description: For artworks with a period of creation, the completion date must be before this date.
schema:
format: int32
type: integer
example: 1760
required: false
style: form
explode: false
in: query
- name: min-ratio
description: The minimum aspect ratio (width/height) the artwork image must have.
schema:
format: double
minimum: 0
maximum: 10
type: number
example: 0.8
required: false
style: form
explode: false
in: query
- name: max-ratio
description: The maximum aspect ratio (width/height) the artwork image must have.
schema:
format: double
minimum: 0
maximum: 10
type: number
example: 1.5
required: false
style: form
explode: false
in: query
- name: type
description: The artwork type. Possible values are tapestry, collotype, collage, printmaking, cutting, digital_art, sculpture, metalwork, fragment, token, embroidery, painting, jewellery, print, ornament, photograph, statuette, furniture, needlework, drawing, miniature, tile, stereograph, calligraphy.
schema:
pattern: .
maxLength: 1000
type: string
example: painting
required: false
style: form
explode: false
in: query
- name: material
description: The art material used. Possible values are ferrous_lactate, ink, textile, metal, bronze, canvas, stone, reduced_iron, horn, stoneware, in_shell_walnuts, chalk, velvet, silver, charcoal, gold_leaf, candied_walnuts, porcelain, walnut_halves, jade, cotton, paint, ferrous_fumarate, graphite, cobalt, sandstone, plastic, walnut_pieces, clay, walnuts, cupric_sulfate, ivory, ferric_orthophosphate, earthenware, tin, pen, linen, mahogany, electrolytic_iron, silk, crayon, black_walnuts, brush, beech_wood, terracotta, glass, lead, brass, oil_paint, pencil, leather, gold, marble, watercolor, diamond, iron, ferrous_sulfate, walnut_halves_and_pieces, gouache, wool, ceramic, parchment, cork, limestone, copper_gluconate, paper, pastel, copper, cardboard, plant_material, oak, wood.
schema:
pattern: .
maxLength: 1000
type: string
example: ivory
required: false
style: form
explode: false
in: query
- name: technique
description: The art technique used. Possible values are engraving, grinding, embroidering, etching, vitrification, gilding, lithography
# --- truncated at 32 KB (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/api-league/refs/heads/main/openapi/api-league-art-api-openapi.yml