Skip to main content
GET
Search free stock images

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Query Parameters

query
string

What the image should show, e.g. misty pine forest at sunrise. Up to 200 characters. Omit to browse (combine with category).

Maximum string length: 200
category
enum<string>
Available options:
nature,
animals,
food,
travel,
transportation,
architecture,
business,
industry,
technology,
people,
education,
music,
art,
backgrounds,
wallpapers,
textures,
abstract,
holidays,
science,
health,
sports
orientation
enum<string>
Available options:
landscape,
portrait,
square
color
enum<string>

Dominant colour.

Available options:
red,
orange,
yellow,
green,
turquoise,
blue,
purple,
pink,
white,
gray,
black,
brown
type
enum<string>

photo for photographs; illustration for everything else (illustration, 3D, painting, vector).

Available options:
photo,
illustration
sort
enum<string>
default:popular

popular (default — with a query, best matches first), newest, or top (highest rated).

Available options:
popular,
newest,
top
limit
integer
default:20
Required range: 1 <= x <= 20
offset
integer
default:0

Results to skip. The next page is offset + limit; each page is a new search.

Required range: 0 <= x <= 5000

Response

Matching images.

credits_charged
integer
required
Example:

10

data
object[]
required
has_more
boolean
required

More results exist past this page.

limit
integer
required
object
enum<string>
required
Available options:
list
offset
integer
required
total
integer
required

Total matching images.