Image search

Images your agents can use.

Search openly licensed public images and receive source links, creators, dimensions, and license metadata through one GET request.

Request

curl --get 'https://extractor.sh/api/images' \
  --data-urlencode 'q=coral reef' \
  --data-urlencode 'limit=10' \
  --data-urlencode 'format=json'

Parameter	Required	Description
`q`	Yes	Image query with up to 200 characters.
`limit`	No	An integer from `1` to `20`. Default: `10`.
`usage`	No	`all`, `commercial`, `modify`, or `commercial-and-modify`. Default: `all`.
`orientation`	No	`any`, `landscape`, `portrait`, or `square`. Default: `any`.
`format`	No	`json` or `markdown`. Default: `json`.

Response

JSON returns a schema-v1 image-search feed. Every usable item is a document with a source page and an image in media. Creator links, dimensions, file type, tags, computed orientation, description, and license details are included when available.

{
  "schemaVersion": 1,
  "type": "feed",
  "source": "image-search",
  "attributes": { "feedType": "image-search", "query": "coral reef", "usage": "all", "orientation": "any", "resultCount": 1 },
  "items": [
    {
      "type": "document",
      "title": "Coral reef",
      "author": "Example creator",
      "url": "https://example.com/image-page",
      "media": [{ "type": "image", "url": "https://example.com/image.jpg" }],
      "attributes": { "license": "CC BY 4.0", "licenseUrl": "https://…" }
    }
  ]
}

Boundaries

Results cover openly licensed public media rather than the entire visual web.
Always inspect and follow the returned license and attribution requirements.
No reverse-image search, face recognition, generated images, or binary image proxy is provided.
Successful searches may be cached for up to one hour.