Search Stock Images

Tool name: search-email-editor-stock-images

Searches the free stock photo archives behind the KlickTipp email editor (Pexels, Pixabay) and returns candidates with preview URL, provider, licence and pixel size -- three by default, up to twelve. The search never comes back empty: a query without a match is answered with unrelated photos. Neither URL in the answer may go into a newsletter; pass sourceUrl and fileName of the chosen photo to upload-email-editor-image-from-url and use the URL it returns. The licence needs no attribution but restricts identifiable people. A host that renders MCP Apps shows the candidates as pictures. The account's own library (logo, product photos) is searched with list-email-editor-images.

Input schema

querystring, [ 1 .. 100 ] charactersrequired

What the picture shows, one or two words, in English (the archives are indexed in English)

limitnull or integer, [ 1 .. 12 ]

How many candidates, 1 to 12; default 3

Default:null

orientationnull or string

Only photos of this shape: landscape, portrait or square; omit for any shape

Default:null

Enum:"landscape""portrait""square"

minWidthnull or integer, [ 1 .. 10000 ]

Only photos at least this wide, in pixels; 1200 for a full-width image

Default:null

accountIdnull or integer, >= 1

User ID of the account; omit for the account the access token works in

Default:null

Input example

{
  "query": "string",
  "limit": null,
  "orientation": "landscape",
  "minWidth": null,
  "accountId": null
}

Output schema

accountIdintegerrequired

querystringrequired

countintegerrequired

matchIsNotGuaranteedbooleanrequired

imagesArray of objectsrequired

htmlstringrequired

Output example

{
  "accountId": 0,
  "query": "string",
  "count": 0,
  "matchIsNotGuaranteed": true,
  "images": [
    {
      "previewUrl": "string",
      "sourceUrl": "string",
      "fileName": "string",
      "provider": "string",
      "license": "string",
      "licenseUrl": "string",
      "licenseNote": "string",
      "width": 0,
      "height": 0,
      "orientation": "string"
    }
  ],
  "html": "string"
}