Image Search
AI-generatedSummary
Search images using a specified query with configurable result count, country, language, safe search, and spellcheck options.
Inputs
- Query (required) — The user's search query term, which must not be empty and can have up to 400 characters and 50 words.
- Count — The number of image results to return, between 1 and 200, defaulting to 50. The actual number returned may be fewer.
- Additional Parameters — Optional settings including Country (region from which results originate), Language (search language preference), Safe Search (adult content filtering: 'strict' or 'off'), and Spellcheck (boolean to enable or disable query spellchecking).
Output shape
a list of image search result items matching the query.
The operation returns up to the requested count of image results in JSON format. The actual count may be less than requested depending on available results.
Examples
Example 1: Search for images matching 'sunsets' restricting results to the United States, returning up to 100 results with safe search on.
Query='sunsets', Count=100, Additional Parameters: Country='US', Safe Search='strict'.