Outscraper icon

Outscraper

Interact with Outscraper API

Actions49

Overview

The node integrates with the Outscraper API to perform Google Search operations, specifically here focusing on the "Search Images" operation. It allows users to query Google Images programmatically and retrieve image search results based on a variety of parameters such as search query, language, region, date range, pagination, and more.

This node is beneficial in scenarios where automated image data collection is needed, for example:

  • Marketing teams gathering images related to specific products or brands.
  • Content creators sourcing images for articles or social media posts.
  • Researchers collecting visual data sets for analysis.
  • Developers building applications that require image search capabilities integrated into workflows.

Practical example: A user wants to collect images related to "electric cars" from Google Images, filtered to only show results from the past month, limited to 2 pages of results, and localized to the US region.

Properties

Name Meaning
Query The search query string to find relevant images.
Pages Per Query Number of pages of image results to return per query (pagination limit).
Async Request Whether to make the request asynchronously (true/false).
Webhook URL to which Outscraper will send a POST callback once the asynchronous task is finished.
Language Language code for the search results (e.g., "en" for English, "fr" for French).
Additional Fields Collection of optional fields to refine the search:
- Date Range Filter results by date range; options include Past Hour, Past 24 Hours, Past Week, Past Month, Past Year.
- Fields Comma-separated list of specific fields to return in the response.
- Region Country code to localize search results (e.g., "us", "uk", "fr").
- Skip Number of results to skip for pagination purposes.
- UULE Parameter Google UULE parameter to encode a specific location for more precise geolocation-based searching.

Output

The node outputs JSON data containing the image search results returned by the Outscraper API. The structure typically includes metadata about each image result such as URLs, titles, thumbnails, source links, and possibly other fields depending on the requested fields.

If the node supports binary data output (not explicitly shown here), it would represent image files or thumbnails directly, but based on the provided information, the output is primarily JSON with image metadata.

Dependencies

  • Requires an active Outscraper API key credential configured in n8n.
  • The node sends requests to the Outscraper API endpoint specified in the credentials.
  • For asynchronous requests, a webhook URL must be provided to receive callbacks when the task completes.

Troubleshooting

  • Common issues:

    • Missing or invalid API key credential will cause authentication failures.
    • Incorrect or empty query string will result in no search results.
    • Invalid webhook URL format may cause asynchronous callback failures.
    • Exceeding API rate limits or quota can lead to errors or throttling.

  • Error messages:

    • Authentication errors: Check that the API key is correctly set and valid.
    • Validation errors: Ensure required fields like "Query" are not empty.
    • Network errors: Verify internet connectivity and API endpoint accessibility.
    • Asynchronous task errors: Confirm webhook URL is reachable and properly configured.

Links and References

Discussion