Search stock photos

GET

/images/search

Searches Unsplash for landscape photos. Requires a bearer session. When a photo is chosen, call POST /images/track-download with its downloadLocation, as Unsplash's terms require.

Authorizations

BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type

HTTP (bearer)

Parameters

Query Parameters

q*

Type

string

Required

page

Type

integer

Minimum

1

Default

1

per_page

Type

integer

Minimum

1

Maximum

30

Default

20

Responses

Search results

Content-Type

application/json

{

"results": [

],

"total": 0,

"totalPages": 0,

"page": 0

}

GET

/images/search

Playground

Server

Authorization

BearerAuth

Variables

Key

Value

q*

page

per_page

Samples

Powered by VitePress OpenAPI