---
title: "Search assets"
method: GET
path: "/v2/assets/search"
tags: ["Assets"]
---

# Search assets

`GET /v2/assets/search`

## Request

- Base URL: `https://api-photos.icons8.com/api`
- URL: `https://api-photos.icons8.com/api/v2/assets/search`
- Auth: API key in header `api-key`

Get list of assets by query

## Query parameters

- `type` 'model' | 'object'
- `query` string, required
- `page` integer
- `perPage` integer
- `fields` string
- `orderBy` 'relevant' | 'random'
- `locale` 'en' | 'ru' | 'fr' | 'de' | 'it' | 'jp' | 'es' | 'br' | 'cn' | 'ko'

## Response `200`

Search assets

- MainEditorAssets: Main_EditorAssets model
  - `total` integer
  - `assets` MainEditorAsset[]
    - `id` string
    - `type` string
    - `urls` object
      - `thumb` MainAsset: Main_Asset model
        - `width` integer
        - `height` integer
        - `url` string
      - `small` MainAsset: Main_Asset model
        - `width` integer
        - `height` integer
        - `url` string
      - `thumb1xWebp` MainAsset: Main_Asset model
        - `width` integer
        - `height` integer
        - `url` string
      - `thumb2xWebp` MainAsset: Main_Asset model
        - `width` integer
        - `height` integer
        - `url` string
      - `medium` MainAsset: Main_Asset model
        - `width` integer
        - `height` integer
        - `url` string
    - `tags` string[]

---

[API](https://skmtc.dev/icons8/apis/photos-api.md) · [All operations](https://skmtc.dev/icons8/apis/photos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/icons8/apis/photos-api/revisions/76ea7419d720?raw)