---
title: "Search licensed stock photos"
method: GET
path: "/images/search"
---

# Search licensed stock photos

`GET /images/search`

## Request

- Base URL: `https://rendry.io/api/v1`
- URL: `https://rendry.io/api/v1/images/search`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Returns image_url, dimensions and author per photo, all distinct. Costs no credits, but IS rationed: a daily ration per account, shared by every agent and session on it, because the provider pool is shared by every user of this server — the reply carries searches_left and the MCP tool description states the number. Repeating a query you already ran today NORMALLY spends no ration, whatever detail and start you pass: the day's list is kept in memory per process, so a repeat after a deploy or on another replica does spend one, and looking closer at a photo of a kept list is free. Hotlink the returned URL directly in a layer.

## Query parameters

- `query` string, required
- `per_page` integer
- `orientation` 'landscape' | 'portrait' | 'squarish'
- `detail` 'thumb' | 'large'
- `start` integer

## Headers

- `X-Rendry-Account` string

## Response `200`

Photos

## Other responses

- `400`: Missing query
- `401`: Missing/invalid API key

---

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