---
title: "List recommended images"
method: GET
path: "/v2/images/recommendations"
tags: ["images"]
---

# List recommended images

`GET /v2/images/recommendations`

This endpoint returns images that customers put in the same collection as the specified image IDs.

## Query parameters

- `id` string[], required
- `max_items` integer
- `safe` boolean

## Response `200`

OK

- object — List of recommended images
  - `data` object[] — Recommended images
    - `id` string, required — Media ID
  - `errors` object[] — Error list; appears only if there was an error
    - `code` string — The error code of this error
    - `data` string — Debugging information about the error
    - `items` object[] — A list of items that produced the error
    - `message` string, required — Specific details about this error
    - `path` string — Internal code reference to the source of the error
  - `message` string — Server-generated message, if any
  - `page` integer — Current page that is returned
  - `per_page` integer — Number of results per page
  - `total_count` integer — Total count of all results across all pages

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer.md) · [All operations](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shutterstock/shutterstock-api-explorer/revisions/d2e03e7f655d/schema)