{ "properties": { "country": { "default": "US", "description": "Two-letter country used for Google's gl parameter (and Bing's cc parameter). Local sites rank higher in local results.", "editor": "select", "enum": [ "US", "GB", "CA", "AU", "DE", "FR", "ES", "IT", "NL", "BR", "MX", "IN", "JP", "KR", "CN", "SG", "AE", "ZA", "PL", "TR", "ID", "PK", "PH", "MY", "TH", "VN", "SE", "NO", "DK", "FI", "IE", "NZ", "CH", "AT", "BE", "PT", "GR", "CZ", "RO", "HU", "UA", "RU", "SA", "EG", "NG", "KE", "AR", "CL", "CO", "PE", "IL", "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AM", "AW", "AC", "AZ", "BS", "BH", "BD", "BB", "BY", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "IO", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "IC", "CV", "BQ", "KY", "CF", "EA", "TD", "CX", "CP", "CC", "KM", "CG", "CD", "CK", "CR", "HR", "CU", "CW", "CY", "CI", "DG", "DJ", "DM", "DO", "EC", "SV", "GQ", "ER", "EE", "SZ", "ET", "EU", "EZ", "FK", "FO", "FJ", "GF", "PF", "TF", "GA", "GM", "GE", "GH", "GI", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "IS", "IR", "IQ", "IM", "JM", "JE", "JO", "KZ", "KI", "XK", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NC", "NI", "NE", "NU", "NF", "KP", "MK", "MP", "OM", "QO", "PW", "PS", "PA", "PG", "PY", "PN", "XA", "XB", "PR", "QA", "RW", "RE", "WS", "SM", "CQ", "SN", "RS", "SC", "SL", "SX", "SK", "SI", "SB", "SO", "GS", "SS", "LK", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "SD", "SR", "SJ", "SY", "ST", "TW", "TJ", "TZ", "TL", "TG", "TK", "TO", "TT", "TA", "TN", "TM", "TC", "TV", "UM", "VI", "UG", "UN", "ZZ", "UY", "UZ", "VU", "VA", "VE", "WF", "EH", "YE", "ZM", "ZW", "AX" ], "enumTitles": [ "United States", "United Kingdom", "Canada", "Australia", "Germany", "France", "Spain", "Italy", "Netherlands", "Brazil", "Mexico", "India", "Japan", "South Korea", "China", "Singapore", "United Arab Emirates", "South Africa", "Poland", "Türkiye", "Indonesia", "Pakistan", "Philippines", "Malaysia", "Thailand", "Vietnam", "Sweden", "Norway", "Denmark", "Finland", "Ireland", "New Zealand", "Switzerland", "Austria", "Belgium", "Portugal", "Greece", "Czechia", "Romania", "Hungary", "Ukraine", "Russia", "Saudi Arabia", "Egypt", "Nigeria", "Kenya", "Argentina", "Chile", "Colombia", "Peru", "Israel", "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua & Barbuda", "Armenia", "Aruba", "Ascension Island", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia & Herzegovina", "Botswana", "Bouvet Island", "British Indian Ocean Territory", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canary Islands", "Cape Verde", "Caribbean Netherlands", "Cayman Islands", "Central African Republic", "Ceuta & Melilla", "Chad", "Christmas Island", "Clipperton Island", "Cocos (Keeling) Islands", "Comoros", "Congo - Brazzaville", "Congo - Kinshasa", "Cook Islands", "Costa Rica", "Croatia", "Cuba", "Curaçao", "Cyprus", "Côte d’Ivoire", "Diego Garcia", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Eswatini", "Ethiopia", "European Union", "Eurozone", "Falkland Islands", "Faroe Islands", "Fiji", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Ghana", "Gibraltar", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard & McDonald Islands", "Honduras", "Hong Kong SAR China", "Iceland", "Iran", "Iraq", "Isle of Man", "Jamaica", "Jersey", "Jordan", "Kazakhstan", "Kiribati", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao SAR China", "Madagascar", "Malawi", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar (Burma)", "Namibia", "Nauru", "Nepal", "New Caledonia", "Nicaragua", "Niger", "Niue", "Norfolk Island", "North Korea", "North Macedonia", "Northern Mariana Islands", "Oman", "Outlying Oceania", "Palau", "Palestinian Territories", "Panama", "Papua New Guinea", "Paraguay", "Pitcairn Islands", "Pseudo-Accents", "Pseudo-Bidi", "Puerto Rico", "Qatar", "Rwanda", "Réunion", "Samoa", "San Marino", "Sark", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Sint Maarten", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Georgia & South Sandwich Islands", "South Sudan", "Sri Lanka", "St. Barthélemy", "St. Helena", "St. Kitts & Nevis", "St. Lucia", "St. Martin", "St. Pierre & Miquelon", "St. Vincent & Grenadines", "Sudan", "Suriname", "Svalbard & Jan Mayen", "Syria", "São Tomé & Príncipe", "Taiwan", "Tajikistan", "Tanzania", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad & Tobago", "Tristan da Cunha", "Tunisia", "Turkmenistan", "Turks & Caicos Islands", "Tuvalu", "U.S. Outlying Islands", "U.S. Virgin Islands", "Uganda", "United Nations", "Unknown Region", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City", "Venezuela", "Wallis & Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe", "Åland Islands" ], "prefill": "US", "title": "Country", "type": "string" }, "enableFallback": { "default": true, "description": "When googleOnly is false, allow labelled Bing Images and then DuckDuckGo Images. Every fallback row carries engine, isFallback=true and fallbackReason.", "prefill": true, "title": "Enable labelled fallback", "type": "boolean" }, "fileType": { "default": "", "description": "Only images in this format. Google applies this server-side; Bing fallback applies it to the image URL extension locally.", "editor": "select", "enum": [ "", "jpg", "png", "gif", "bmp", "svg", "webp", "ico" ], "enumTitles": [ "Any format", "JPEG", "PNG", "GIF", "BMP", "SVG", "WebP", "ICO" ], "prefill": "", "title": "File type", "type": "string" }, "googleOnly": { "default": false, "description": "When true, a failed or empty Google search fails that query with a clear status instead of using another engine. The default is false so legacy saved tasks keep working; set this true for a strict Google-only contract.", "prefill": false, "title": "Google only", "type": "boolean" }, "imageColor": { "default": "", "description": "Google Images color filter. 'black_and_white' is grayscale; 'transparent' looks for a transparent background.", "editor": "select", "enum": [ "", "color", "black_and_white", "transparent", "red", "orange", "yellow", "green", "teal", "blue", "purple", "pink", "white", "gray", "black", "brown" ], "enumTitles": [ "Any color", "Full color", "Black and white", "Transparent", "Red", "Orange", "Yellow", "Green", "Teal", "Blue", "Purple", "Pink", "White", "Gray", "Black", "Brown" ], "prefill": "", "title": "Image color", "type": "string" }, "imageSize": { "default": "", "description": "Google Images size filter. The MP values are minimum megapixels. Bing fallback applies the nearest size category and enforces the exact MP floor locally when dimensions are known.", "editor": "select", "enum": [ "", "large", "medium", "icon", "2mp", "4mp", "8mp", "12mp", "20mp", "40mp", "70mp" ], "enumTitles": [ "Any size", "Large", "Medium", "Icon", "2 MP or larger", "4 MP or larger", "8 MP or larger", "12 MP or larger", "20 MP or larger", "40 MP or larger", "70 MP or larger" ], "prefill": "", "title": "Image size", "type": "string" }, "imageType": { "default": "", "description": "Google Images type filter: photographs, faces, clip art, line drawings or animated images.", "editor": "select", "enum": [ "", "photo", "face", "clipart", "lineart", "animated" ], "enumTitles": [ "Any type", "Photo", "Face", "Clip art", "Line drawing", "Animated" ], "prefill": "", "title": "Image type", "type": "string" }, "language": { "default": "en", "description": "Interface and result language used for Google's hl parameter (and Bing's setlang parameter).", "editor": "select", "enum": [ "en", "es", "de", "fr", "pt", "pt-BR", "it", "nl", "pl", "ru", "uk", "tr", "ar", "hi", "ur", "bn", "id", "ms", "th", "vi", "ja", "ko", "zh-CN", "zh-TW", "ab", "aa", "af", "ak", "sq", "am", "an", "hy", "as", "av", "ae", "ay", "az", "bm", "ba", "eu", "be", "bi", "bs", "br", "bg", "my", "ca", "ch", "ce", "zh", "cu", "cv", "kw", "co", "cr", "hr", "cs", "da", "dv", "dz", "eo", "et", "ee", "fo", "fj", "fi", "ff", "gl", "lg", "ka", "el", "gn", "gu", "ht", "ha", "he", "hz", "ho", "hu", "is", "io", "ig", "ia", "ie", "iu", "ik", "ga", "jv", "kl", "kn", "kr", "ks", "kk", "km", "ki", "rw", "kv", "kg", "kj", "ku", "ky", "lo", "la", "lv", "li", "ln", "lt", "lu", "lb", "mk", "mg", "ml", "mt", "gv", "mr", "mh", "mn", "mi", "na", "nv", "ng", "ne", "nd", "se", "no", "nb", "nn", "ny", "oc", "or", "oj", "om", "os", "pi", "ps", "fa", "pa", "qu", "ro", "rm", "rn", "sm", "sg", "sa", "sc", "gd", "sr", "sh", "sn", "ii", "sd", "si", "sk", "sl", "so", "nr", "st", "su", "sw", "ss", "sv", "tl", "ty", "tg", "ta", "tt", "te", "bo", "ti", "to", "ts", "tn", "tk", "tw", "ug", "uz", "ve", "vo", "wa", "cy", "fy", "wo", "xh", "yi", "yo", "za", "zu" ], "enumTitles": [ "English", "Spanish", "German", "French", "Portuguese", "Portuguese (Brazil)", "Italian", "Dutch", "Polish", "Russian", "Ukrainian", "Turkish", "Arabic", "Hindi", "Urdu", "Bangla", "Indonesian", "Malay", "Thai", "Vietnamese", "Japanese", "Korean", "Chinese (Simplified)", "Chinese (Traditional)", "Abkhazian", "Afar", "Afrikaans", "Akan", "Albanian", "Amharic", "Aragonese", "Armenian", "Assamese", "Avaric", "Avestan", "Aymara", "Azerbaijani", "Bambara", "Bashkir", "Basque", "Belarusian", "Bislama", "Bosnian", "Breton", "Bulgarian", "Burmese", "Catalan", "Chamorro", "Chechen", "Chinese", "Church Slavic", "Chuvash", "Cornish", "Corsican", "Cree", "Croatian", "Czech", "Danish", "Divehi", "Dzongkha", "Esperanto", "Estonian", "Ewe", "Faroese", "Fijian", "Finnish", "Fula", "Galician", "Ganda", "Georgian", "Greek", "Guarani", "Gujarati", "Haitian Creole", "Hausa", "Hebrew", "Herero", "Hiri Motu", "Hungarian", "Icelandic", "Ido", "Igbo", "Interlingua", "Interlingue", "Inuktitut", "Inupiaq", "Irish", "Javanese", "Kalaallisut", "Kannada", "Kanuri", "Kashmiri", "Kazakh", "Khmer", "Kikuyu", "Kinyarwanda", "Komi", "Kongo", "Kuanyama", "Kurdish", "Kyrgyz", "Lao", "Latin", "Latvian", "Limburgish", "Lingala", "Lithuanian", "Luba-Katanga", "Luxembourgish", "Macedonian", "Malagasy", "Malayalam", "Maltese", "Manx", "Marathi", "Marshallese", "Mongolian", "Māori", "Nauru", "Navajo", "Ndonga", "Nepali", "North Ndebele", "Northern Sami", "Norwegian", "Norwegian Bokmål", "Norwegian Nynorsk", "Nyanja", "Occitan", "Odia", "Ojibwa", "Oromo", "Ossetic", "Pali", "Pashto", "Persian", "Punjabi", "Quechua", "Romanian", "Romansh", "Rundi", "Samoan", "Sango", "Sanskrit", "Sardinian", "Scottish Gaelic", "Serbian", "Serbo-Croatian", "Shona", "Sichuan Yi", "Sindhi", "Sinhala", "Slovak", "Slovenian", "Somali", "South Ndebele", "Southern Sotho", "Sundanese", "Swahili", "Swati", "Swedish", "Tagalog", "Tahitian", "Tajik", "Tamil", "Tatar", "Telugu", "Tibetan", "Tigrinya", "Tongan", "Tsonga", "Tswana", "Turkmen", "Twi", "Uyghur", "Uzbek", "Venda", "Volapük", "Walloon", "Welsh", "Western Frisian", "Wolof", "Xhosa", "Yiddish", "Yoruba", "Zhuang", "Zulu" ], "prefill": "en", "title": "Language", "type": "string" }, "maxResults": { "default": 100, "description": "Maximum number of image rows to return for each query. Google Images usually runs out around 300-400 results for a query; this is a ceiling, not a guarantee.", "maximum": 500, "minimum": 1, "prefill": 3, "title": "Max results per query", "type": "integer" }, "minHeight": { "default": 0, "description": "Drop images shorter than this many pixels. Rows without published dimensions are dropped when this is set. 0 disables the filter.", "maximum": 10000, "minimum": 0, "prefill": 0, "title": "Minimum image height", "type": "integer" }, "minWidth": { "default": 0, "description": "Drop images narrower than this many pixels. Rows without published dimensions are dropped when this is set. 0 disables the filter.", "maximum": 10000, "minimum": 0, "prefill": 0, "title": "Minimum image width", "type": "integer" }, "queries": { "description": "One or more image search queries. Each query is searched independently. Google operators such as site:, quoted phrases and -exclusions are passed through. The legacy single `query` key is still accepted by the actor code.", "editor": "stringList", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "prefill": [ "Alfons Mucha" ], "title": "Search queries", "type": "array" }, "safeSearch": { "default": "active", "description": "Google SafeSearch level. 'active' filters explicit images; 'off' does not.", "editor": "select", "enum": [ "active", "off" ], "enumTitles": [ "Filter explicit results (active)", "Do not filter (off)" ], "prefill": "active", "title": "Safe search", "type": "string" }, "timeRange": { "default": "", "description": "Only images Google found within this period. Bing fallback maps 'hour' to its 24-hour window.", "editor": "select", "enum": [ "", "hour", "day", "week", "month", "year" ], "enumTitles": [ "Any time", "Past hour", "Past 24 hours", "Past week", "Past month", "Past year" ], "prefill": "", "title": "Time range", "type": "string" }, "usageRights": { "default": "", "description": "Google's usage-rights labels. These are Google's labels, not a legal guarantee; check the licence on the source page before reuse.", "editor": "select", "enum": [ "", "free_to_use_or_share", "free_to_use_or_share_commercially", "free_to_use_share_or_modify", "free_to_use_share_or_modify_commercially" ], "enumTitles": [ "Any usage rights", "Free to use or share", "Free to use or share, even commercially", "Free to use, share or modify", "Free to use, share or modify, even commercially" ], "prefill": "", "title": "Usage rights", "type": "string" } }, "schemaVersion": 1, "title": "Google Images Scraper Input", "type": "object" }