Actions6
Overview
The Google Images Search operation in this node allows users to perform image searches using the ScrapingDog API, which scrapes Google Images results. This node is useful for automating the retrieval of images based on specific search queries and filters without directly interacting with Google's official APIs.
Common scenarios include:
- Automatically gathering images for content creation or marketing.
- Collecting visual data for research or machine learning datasets.
- Filtering images by size, type, color, usage rights, or time period to meet specific project requirements.
For example, a user can search for "sunset landscapes" limited to large-sized photos labeled for reuse within the past year, filtered to English language results from the United States.
Properties
| Name | Meaning |
|---|---|
| Query | The search query string for Google Images (e.g., "cats", "modern architecture"). |
| Number of Results | Number of image results to return; options range from 10 to 100. |
| Country | Geotargeting country for search results; options include Australia, Brazil, Canada, China, etc. |
| Language | Language preference for search results; includes English, Spanish, French, German, etc. |
| Image Size | Filter images by size: Any Size, Large, Medium, Icon. |
| Image Type | Filter images by type: Any Type, Face, Photo, Clipart, Line Drawing, Animated. |
| Image Color | Filter images by color: Any Color, Color, Black and White, Transparent, Red, Orange, etc. |
| Usage Rights | Filter images by usage rights: Any, Labeled for Reuse, Labeled for Reuse with Modification, etc. |
| Time Period | Filter images by upload time: Any Time, Past Hour, Past 24 Hours, Past Week, Month, Year. |
| Safe Search | Safe search filter level: Strict, Moderate, Off. |
Output
The node outputs JSON data containing the search results from Google Images as returned by the ScrapingDog API. Each item typically includes metadata about an image such as its URL, title, source page, thumbnail, and possibly licensing information depending on the API response.
If binary data is included (not explicitly shown in the code), it would represent the actual image files or thumbnails fetched during the search.
Dependencies
- Requires an active API key credential for the ScrapingDog API.
- The node sends HTTP GET requests to the ScrapingDog endpoint
https://api.scrapingdog.com/google_images. - No additional environment variables are indicated beyond the API key credential.
Troubleshooting
Common issues:
- Invalid or missing API key will cause authentication errors.
- Exceeding rate limits imposed by the ScrapingDog API may result in request failures.
- Providing unsupported or invalid parameter values (e.g., unsupported country codes) might lead to empty or error responses.
Error messages:
- Authentication errors typically indicate problems with the API key; verify the key is correct and active.
- Network or timeout errors suggest connectivity issues; check internet connection and API service status.
- Unexpected empty results may mean the query is too restrictive or no images match the filters; try broadening filters.