Actions72
- eBay Search
- DuckDuckGo Search
- Amazon Search
- Baidu Search
- Bing Images
- Bing Search
- Facebook Profile
- Google AI Mode
- Google AI Overview
- Google Autocomplete
- Google Finance
- Google Flights
- Google Hotels
- Google Images
- Google Images Light
- Google Immersive Product
- Google Jobs
- Google Lens
- Google Light
- Google Local
- Google Maps
- Google Maps Directions
- Google Maps Reviews
- Google News
- Google News Light
- Google Play Games
- Google Play Product
- Google Play Store
- Google Product
- Google Scholar
- Google Search
- Google Shopping
- Google Trends
- Google Trends Trending Now
- Google Videos
- YouTube Search
- Search Actions
- Amazon Search
- Baidu Search
- Bing Images
- Bing Search
- DuckDuckGo Search
- eBay Search
- Facebook Profile
- Google AI Mode
- Google AI Overview
- Google Autocomplete
- Google Finance
- Google Flights
- Google Hotels
- Google Images
- Google Images Light
- Google Immersive Product
- Google Jobs
- Google Lens
- Google Light
- Google Local
- Google Maps
- Google Maps Directions
- Google Maps Reviews
- Google News
- Google News Light
- Google Play Games
- Google Play Product
- Google Play Store
- Google Product
- Google Scholar
- Google Search
- Google Shopping
- Google Trends
- Google Trends Trending Now
- Google Videos
- YouTube Search
Overview
This node integrates with SerpApi's Google Images Light search engine to perform image searches on Google using a lightweight API endpoint. It allows users to specify detailed search queries and various filtering options to retrieve image results efficiently.
Common scenarios where this node is beneficial include:
- Automating image search tasks for content creation or marketing.
- Gathering image data for research or analysis.
- Filtering images by size, color, type, license, or date range.
- Localizing image search results by country, language, or location.
Practical example: A user wants to find large, black-and-white coffee-related images from the US Google domain, filtered to only show photos licensed for commercial use. This node can be configured with those parameters to return relevant image metadata in JSON format.
Properties
| Name | Meaning |
|---|---|
| Search Query (q) | The main search query string for the image search. Supports standard Google search operators like inurl:, site:, intitle:. Example: "Coffee". |
| Additional Fields | A collection of optional parameters to refine the search: |
| - Location (location) | Origin location for the search. See SerpApi locations API for supported values. |
| - Encoded Location (uule) | Google encoded location string. Cannot be used together with location. |
| - Domain (google_domain) | Google domain to use for the search, e.g., google.com, google.co.uk, etc. |
| - Country (gl) | Country code to localize the search, e.g., us for United States, gb for United Kingdom. |
| - Language (hl) | Language code for the search interface, e.g., en for English, fr for French. |
| - Set Multiple Countries (cr) | Limit search to one or multiple countries using uppercase two-letter codes separated by ` |
| - Include/Exclude Site (as_dt) | Control inclusion or exclusion of results from a specific site. |
| - Required Phrase (as_epq) | Phrase that must appear in all documents returned. |
| - Excluded Word/Phrase (as_eq) | Words or phrases to exclude from results. |
| - Link to URL (as_lq) | Results must contain a link to this URL. |
| - Search Range Start (as_nlo) | Start value for a numeric search range. |
| - Search Range End (as_nhi) | End value for a numeric search range. |
| - Additional Search Terms (as_oq) | Additional terms where at least one must appear in results. |
| - Search Terms (as_q) | Additional search terms to check within documents. |
| - Time Period (as_qdr) | Quick date range filter for results. |
| - Related URL (as_rq) | Results related to the specified URL. |
| - Site Search (as_sitesearch) | Restrict results to a given site or exclude it based on as_dt. |
| - Time Period Unit (period_unit) | Unit for recent image time period filtering, e.g., seconds, minutes, hours, days, weeks, months, years. |
| - Time Period Value (period_value) | Numeric value for the time period unit, e.g., 15 hours. |
| - Start Date (start_date) | Start date for limiting image search (format YYYYMMDD). Overrides other date filters. |
| - End Date (end_date) | End date for limiting image search (format YYYYMMDD). Overrides other date filters. |
| - Advanced Search Parameter (tbs) | Advanced search parameters not possible in regular query field. |
| - Aspect Ratio Filtering (imgar) | Filter images by aspect ratio: Panoramic, Square, Tall, Wide. Default is Square. |
| - Image Size Filtering (imgsz) | Filter images by size: Icon, Medium, Large, or larger than specific resolutions (e.g., 400x300, 640x480, up to 70 MP). Default is Large. |
| - Image Color Filtering (image_color) | Filter images by color: Black, Black and white, Blue, Brown, Gray, Green, Orange, Pink, Purple, Red, Teal, Transparent, White, Yellow. Default is Black and white. |
| - Image Type Filtering (image_type) | Filter images by type: Animated, Clip art, Face, Line drawing, Photo. Default is Animated. |
| - Usage Rights Filtering (licenses) | Filter images by license scope: Commercial and other licenses, Creative Commons, Free to use/share, Free to use/share commercially, Free to modify, etc. Default is Free to use/share. |
| - Adult Content Filtering (safe) | Level of adult content filtering: Active (default) or Off. |
| - Exclude Auto-corrected Results (nfpr) | Exclude results from auto-corrected queries when original query is misspelled. Boolean. |
| - Results Filtering (filter) | Enable or disable filters for 'Similar Results' and 'Omitted Results'. Boolean, default true. |
| - Result Offset (start) | Skip a number of results to start from an offset. |
| - Device (device) | Device type for search results: desktop (default), tablet, or mobile. |
| - Disable Caching (no_cache) | Force fetching new results ignoring cache. Boolean, default false. Cannot be used with async. |
| - Async (async) | Perform search asynchronously. Boolean, default false. Cannot be used with no_cache or accounts with Ludicrous Speed enabled. |
| - ZeroTrace Mode (zero_trace) | Enterprise mode to skip storing search parameters and metadata on SerpApi servers. Boolean, default false. |
| - Output (output) | Format of final output: JSON (default) or raw HTML. |
| - JSON Restrictor (json_restrictor) | Restrict fields in JSON response, e.g., organic_results[0:3].{title,snippet} to limit returned data. |
Output
The node outputs a JSON object containing the structured results of the Google Images Light search according to the specified query and filters. The JSON includes metadata about each image result such as URLs, titles, thumbnails, source information, and possibly licensing details depending on the query.
If the output format is set to html, the node returns the raw HTML content retrieved from the search instead of JSON.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for SerpApi to authenticate requests.
- The node sends HTTP requests to
https://serpapi.com/search.jsonwith appropriate query parameters. - No additional external dependencies are required.
- Users must configure their SerpApi API key in n8n credentials before using this node.
Troubleshooting
- Invalid API Key or Authentication Errors: Ensure the SerpApi API key credential is correctly configured and active.
- Empty or Unexpected Results: Verify the search query and filters are valid and not overly restrictive.
- Conflicting Parameters: For example, do not use both
locationanduulesimultaneously as they are mutually exclusive. - Async and No Cache Conflict: Do not enable both
asyncandno_cacheat the same time; this will cause errors. - Rate Limits or Quotas: SerpApi enforces usage limits; exceeding them may result in errors or blocked requests.
- Date Format Errors: When using
start_dateorend_date, ensure the format isYYYYMMDD. - Unsupported Domains or Locations: Use only supported Google domains and location codes as per SerpApi documentation.