Skip to main content
GET
Search Assets

Authorizations

Authorization
string
header
required

API key from Settings > Developer > REST API

Headers

Moda-Version
enum<string>
default:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Available options:
2026-04-12,
2026-05-01
Example:

"2026-05-01"

Query Parameters

q
string
required

Search query.

Minimum string length: 1
kind
enum<string>
default:photo

icon = Phosphor packs; photo = team gallery.

Available options:
icon,
photo
source
enum<string>
default:team

Where to search. 'team' (default) = this team's own assets. 'photo' + 'stock' searches the Unsplash stock library. Ignored for kind='icon': the icon packs ARE the stock icon library (public Phosphor packs, shared with every team), so there is no separate stock icon source.

Available options:
team,
stock
limit
integer
default:20

Max results per page. Defaults to 20, caps at 50.

Required range: 1 <= x <= 50
offset
integer
default:0

Results to skip — pass offset + limit (the response's echoed limit) to page through.

Required range: x >= 0

Response

Successful Response

The response is of type Response Searchassets · object.