Image Search

Search and collect images from the web with metadata extraction, content validation, and copyright detection.

Search for images using text queries or reverse image search with comprehensive metadata extraction, content validation, and copyright detection capabilities.

Features

Text-based and reverse image search
Multiple image source support
Metadata extraction and content analysis
Copyright and license detection
Image validation and quality assessment

Connector Options

The node uses reusable connector configuration that applies to all image search operations:

Parameter	Type	Required	Description
`apiKeys`	Object	Yes	API keys for image search services (google, bing, etc.)
`defaultSource`	TEXT	No	Default image source when not specified
`maxImages`	INT	No	Default maximum images per search (default: 20)
`qualityFilter`	TEXT	No	Default image quality filter (default: medium)

Methods

imageSearch

Search for images using text queries with advanced filtering and metadata extraction.

Parameter	Type	Required	Description
`query`	TEXT	Yes	Search query for finding images
`searchType`	TEXT	No	Search type: keyword, reverse, similar (default: keyword)
`maxResults`	INT	No	Maximum number of images to return
`filters`	Object	No	Image filtering options
`metadata`	Object	No	Metadata extraction configuration

{
  "query": "data visualization charts examples",
  "searchType": "keyword",
  "maxResults": 20,
  "filters": {
    "license": ["creative_commons", "public_domain"],
    "format": ["png", "svg", "jpg"],
    "size": {
      "min": "1024x768",
      "max": "4096x4096"
    },
    "color": "any",
    "aspectRatio": "any"
  },
  "metadata": {
    "extractObjects": true,
    "checkCopyright": true,
    "generateDescription": true,
    "analyzeColors": true
  }
}

Output:

images (Array) - Found images with metadata and analysis
totalResults (Number) - Total number of images found
searchTime (Number) - Search execution time in milliseconds
query (Object) - Processed query information
filters (Object) - Applied filters and restrictions

reverseImageSearch

Find similar images or original sources using an existing image as input.

Parameter	Type	Required	Description
`sourceImage`	TEXT	Yes	Path to source image or image URL
`searchType`	TEXT	No	Type: exact, similar, variations (default: similar)
`similarityThreshold`	FLOAT	No	Minimum similarity score (0.0-1.0)
`maxResults`	INT	No	Maximum number of results
`includeMetadata`	BOOLEAN	No	Include source image metadata

{
  "sourceImage": "/sandbox/images/sample.jpg",
  "searchType": "similar",
  "similarityThreshold": 0.7,
  "maxResults": 15,
  "includeMetadata": true
}

downloadImages

Download images from search results with validation and processing.

Parameter	Type	Required	Description
`imageUrls`	Array	Yes	List of image URLs to download
`destination`	TEXT	No	Download destination directory
`processing`	Object	No	Image processing options
`validation`	Object	No	Content validation settings

{
  "imageUrls": [
    "https://example.com/image1.jpg",
    "https://example.com/image2.png"
  ],
  "destination": "/sandbox/images/downloaded",
  "processing": {
    "generateThumbnails": true,
    "thumbnailSize": "300x300",
    "convertFormat": "jpg",
    "optimizeSize": true
  },
  "validation": {
    "virusScan": true,
    "contentPolicy": true,
    "maxFileSize": "50MB",
    "allowedFormats": ["jpg", "png", "gif", "webp"]
  }
}

Size and Dimension Filters

Filter	Type	Description	Example Values
`size`	Object	Image dimensions	`{"min": "800x600", "max": "4096x4096"}`
`aspectRatio`	TEXT	Image aspect ratio	"square", "wide", "tall", "panoramic"
`orientation`	TEXT	Image orientation	"landscape", "portrait", "square"
`resolution`	TEXT	Image resolution	"low", "medium", "high", "vector"

Content and Style Filters

Filter	Type	Description	Example Values
`color`	TEXT	Dominant color	"red", "blue", "green", "black", "white", "transparent"
`colorType`	TEXT	Color composition	"color", "grayscale", "transparent"
`style`	TEXT	Image style	"photo", "illustration", "clipart", "diagram"
`subject`	TEXT	Image subject	"people", "face", "animals", "nature", "objects"

License and Usage Filters

Filter	Type	Description	Example Values
`license`	Array	Usage rights	`["creative_commons", "public_domain", "commercial"]`
`usage`	TEXT	Allowed usage	"any", "commercial", "non_commercial"
`modification`	TEXT	Modification rights	"allowed", "restricted", "prohibited"
`attribution`	TEXT	Attribution requirements	"required", "optional", "none"

Image Analysis

Metadata Extraction

Comprehensive metadata extraction from found images:

{
  "metadata": {
    "basic": {
      "filename": "chart_example.png",
      "format": "PNG",
      "dimensions": {
        "width": 1920,
        "height": 1080
      },
      "fileSize": 245760,
      "colorDepth": 24
    },
    "technical": {
      "dpi": 72,
      "colorSpace": "sRGB",
      "compression": "none",
      "hasTransparency": true,
      "animationFrames": 0
    },
    "content": {
      "dominantColors": ["#2E86AB", "#A23B72", "#F18F01"],
      "colorPalette": ["#2E86AB", "#A23B72", "#F18F01", "#C73E1D"],
      "brightness": 0.65,
      "contrast": 0.82
    },
    "analysis": {
      "objects": ["chart", "graph", "data", "visualization"],
      "scenes": ["office", "presentation", "business"],
      "text": ["Q1 Sales", "Revenue", "2024"],
      "faces": 0,
      "estimatedQuality": "high"
    }
  }
}

Copyright Detection

Advanced copyright and licensing analysis:

{
  "copyrightAnalysis": {
    "status": "potential_copyright",
    "confidence": 0.85,
    "indicators": [
      "watermark_detected",
      "known_logo_found",
      "commercial_source"
    ],
    "license": {
      "type": "unknown",
      "restrictions": ["commercial_use_unclear"],
      "attribution": "required",
      "source": "Getty Images"
    },
    "recommendations": [
      "Verify licensing before commercial use",
      "Contact original source for permissions",
      "Consider alternative images with clear licenses"
    ]
  }
}

Content Validation

{
  "contentValidation": {
    "safetyCheck": {
      "adultContent": false,
      "violence": false,
      "inappropriate": false,
      "confidenceScore": 0.95
    },
    "qualityAssessment": {
      "resolution": "high",
      "sharpness": 0.88,
      "noise": 0.12,
      "compression": "minimal",
      "overallQuality": "excellent"
    },
    "technicalValidation": {
      "validFormat": true,
      "corruption": false,
      "virusScan": "clean",
      "metadata_intact": true
    }
  }
}

Advanced Search Features

Visual Similarity Search

Find images with similar visual characteristics:

{
  "visualSearch": {
    "sourceImage": "/sandbox/reference/chart_template.png",
    "similarityTypes": ["color", "composition", "objects", "style"],
    "weightings": {
      "color": 0.3,
      "composition": 0.4,
      "objects": 0.2,
      "style": 0.1
    },
    "threshold": 0.75,
    "maxResults": 25
  }
}

Object-Based Search

Search for images containing specific objects or elements:

{
  "objectSearch": {
    "requiredObjects": ["chart", "graph", "data"],
    "optionalObjects": ["laptop", "presentation", "business"],
    "objectConfidence": 0.8,
    "composition": "central_focus",
    "style": ["modern", "professional"]
  }
}

Color and Style Analysis

Search based on visual characteristics:

{
  "styleSearch": {
    "colorScheme": {
      "primary": ["#2E86AB", "#A23B72"],
      "secondary": ["#F18F01", "#C73E1D"],
      "tolerance": 0.2
    },
    "visualStyle": {
      "modern": 0.8,
      "minimalist": 0.7,
      "professional": 0.9
    },
    "composition": {
      "balance": "centered",
      "complexity": "medium",
      "focusArea": "center"
    }
  }
}

Batch Operations

Bulk Image Search

Search for multiple queries simultaneously:

{
  "batchSearch": {
    "queries": [
      "data visualization charts",
      "business infographics",
      "financial graphs",
      "dashboard mockups"
    ],
    "sharedFilters": {
      "license": ["creative_commons"],
      "format": ["png", "svg"],
      "minSize": "1024x768"
    },
    "maxResultsPerQuery": 15,
    "parallelRequests": 3,
    "rateLimiting": {
      "requestsPerMinute": 30,
      "delayBetweenRequests": 2000
    }
  }
}

Collection Building

Build curated image collections with categorization:

{
  "buildCollection": {
    "theme": "Data Visualization Examples",
    "categories": {
      "charts": {
        "query": "bar charts pie charts line graphs",
        "maxImages": 10
      },
      "infographics": {
        "query": "business infographics data presentation",
        "maxImages": 8
      },
      "dashboards": {
        "query": "dashboard ui data visualization interface",
        "maxImages": 12
      }
    },
    "qualityFilter": "high",
    "licenseRequirement": "commercial_use_allowed"
  }
}

Error Handling

Common Error Scenarios

Error Type	Cause	Resolution
`NO_RESULTS_FOUND`	Query too specific or restrictive	Broaden search terms or relax filters
`QUOTA_EXCEEDED`	API limit reached	Wait for quota reset or use different service
`INVALID_IMAGE_FORMAT`	Unsupported image type	Check supported formats list
`COPYRIGHT_DETECTED`	Potentially copyrighted content	Use alternative search or verify licensing
`DOWNLOAD_FAILED`	Network or server error	Retry with error handling

Error Response Format

{
  "success": false,
  "error": {
    "type": "COPYRIGHT_DETECTED",
    "message": "Image may be copyrighted and require licensing",
    "imageUrl": "https://example.com/image.jpg",
    "details": {
      "copyrightSource": "Getty Images",
      "confidence": 0.92,
      "indicators": ["watermark", "known_source"]
    },
    "suggestions": [
      "Search for images with clear licenses",
      "Use Creative Commons or Public Domain filters",
      "Contact copyright holder for permissions"
    ]
  }
}

Performance Optimization

Caching Strategy

{
  "caching": {
    "searchResults": {
      "enabled": true,
      "ttl": 7200,
      "maxSize": "100MB"
    },
    "imageMetadata": {
      "enabled": true,
      "ttl": 86400,
      "compression": true
    },
    "downloadedImages": {
      "enabled": true,
      "location": "/sandbox/cache/images",
      "maxSize": "500MB",
      "cleanup": "lru"
    }
  }
}

Resource Management

{
  "resources": {
    "maxConcurrentDownloads": 5,
    "downloadTimeout": 30000,
    "maxImageSize": "50MB",
    "memoryLimit": "512MB",
    "processingTimeout": 60000,
    "bandwidthThrottle": "5MB/s"
  }
}

Usage Examples

Marketing Asset Collection

{
  "query": "business team collaboration modern office",
  "maxResults": 25,
  "filters": {
    "license": ["creative_commons", "royalty_free"],
    "format": ["jpg", "png"],
    "size": {
      "min": "1920x1080"
    },
    "aspectRatio": "wide",
    "style": "photo"
  },
  "metadata": {
    "extractObjects": true,
    "checkCopyright": true,
    "analyzeComposition": true
  }
}

Technical Documentation Images

{
  "query": "software architecture diagrams cloud computing",
  "maxResults": 15,
  "filters": {
    "license": ["public_domain", "creative_commons"],
    "format": ["svg", "png"],
    "style": "diagram",
    "color": "any"
  },
  "processing": {
    "generateThumbnails": true,
    "optimizeForWeb": true,
    "addWatermark": false
  }
}

Product Research Images

{
  "query": "mobile app ui dashboard design",
  "maxResults": 30,
  "filters": {
    "license": ["commercial_use_allowed"],
    "format": ["png", "jpg"],
    "size": {
      "min": "800x600"
    },
    "style": ["screenshot", "mockup"]
  },
  "analysis": {
    "extractUI": true,
    "colorAnalysis": true,
    "designTrends": true
  }
}