Search licensed stock photos

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.

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

Query parameters

querystring required

English, 2-4 broad nouns. Words are AND-matched: 5+ usually returns nothing

per_pageinteger
orientation'landscape' | 'portrait' | 'squarish'
detail'thumb' | 'large'

Inline preview size. thumb (default) is a ~200px thumbnail; large returns fewer photos at a size where a logo on a shirt is readable — use it before a photo becomes the sample of a brand template

startinteger

Photo number the page starts at (default 1), in the same numbering the thumbnails carry: start=7 with detail=large shows photo 7 big. A number past the end of the list is refused and the refusal says how many photos there are

Headers

X-Rendry-Accountstring

Browser/OAuth current member account selector. API keys/embed credentials are bound to their persisted account and reject another account. Omitting this header selects the browser actor personal account.

Response

Photos

Changes

No recorded changes to this operation across all 1 revision of this API.