search_images
Find openly-licensed images by entering search terms, filtering by license type, size, source, and more, helping users locate and use free, legal visuals efficiently.
Instructions
Search for openly-licensed images on Openverse
Input Schema
Name | Required | Description | Default |
---|---|---|---|
aspect_ratio | No | Image shape (tall, wide, square) | |
creator | No | Filter by creator name | |
extension | No | File type (jpg, png, gif, svg) | |
license | No | License filter (e.g., by, by-sa, cc0) | |
license_type | No | License type (commercial or modification) | |
mature | No | Include mature content (default: false) | |
page | No | Page number (default: 1) | |
page_size | No | Results per page (default: 20, max: 500) | |
query | Yes | Search terms (required) | |
size | No | Image size (small, medium, large) | |
source | No | Filter by source (e.g., flickr, wikimedia) |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"aspect_ratio": {
"description": "Image shape (tall, wide, square)",
"type": "string"
},
"creator": {
"description": "Filter by creator name",
"type": "string"
},
"extension": {
"description": "File type (jpg, png, gif, svg)",
"type": "string"
},
"license": {
"description": "License filter (e.g., by, by-sa, cc0)",
"type": "string"
},
"license_type": {
"description": "License type (commercial or modification)",
"type": "string"
},
"mature": {
"description": "Include mature content (default: false)",
"type": "boolean"
},
"page": {
"description": "Page number (default: 1)",
"type": "number"
},
"page_size": {
"description": "Results per page (default: 20, max: 500)",
"type": "number"
},
"query": {
"description": "Search terms (required)",
"type": "string"
},
"size": {
"description": "Image size (small, medium, large)",
"type": "string"
},
"source": {
"description": "Filter by source (e.g., flickr, wikimedia)",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}