Getting started with the API

The API itself is extremely simple to set up and use. You can download a list containing every clip art, and then just... use the given clip arts.

Setting the origin

To ensure only you can use the API and to monitor usage, we check the origin of every request. You need to add the base URL of every website you intend to use the API on here.

You do not need to set localhost as an origin for testing. When requesting images from a localhost address, you will always and automatically receive watermarked versions of the clip arts. These requests do not count towards your allowed daily usage.

Requesting clip arts

A user session will ususally begin with a call to this API route:

https://amillioncliparts.com/api/clip-arts

This route returns an array containing all available clip arts.

The array looks like this:

    [{ "description":"Smiling woman with hands on hips.", "name":"Smiling
      Woman", "tags":["woman","smiling","hands on hips","blue dress","yellow
      collar"], "category":"people", "style":"flat, modern",
      "file":"1716018158590", "id":"7be73151-0d95-43ff-aa22-c9e191f8f961" },
      ...]

You can use the file value to request the images. An Image Url looks like https://amillioncliparts.com/api/image/[file], while a thumbnail looks like https://amillioncliparts.com/api/thumbnail/[file]

Thumbails are lower resolution jpeg images, that are meant to be shown in a selection screen, or ideally as search results. They are not suitable to be used in an editor or similar application directly, as they offer no transparency, but have a much higher usage limit than full size images.

The other values are meant for filtering and searching through the vast amount of clip arts to find suitable images for the current usecase & user.