{ "description": "Choose what to collect: company reviews, company profiles, or companies matching a keyword.", "properties": { "companies": { "description": "Domains (booking.com, notion.so) or company names (Nike, Notion). Names are resolved through Trustpilot search. Merged with 'Company URLs'.", "editor": "stringList", "title": "Company domains or names", "type": "array" }, "filterDateRange": { "default": "all", "description": "Only include reviews posted in this rolling window.", "editor": "select", "enum": [ "all", "last30days", "last3months", "last6months", "last12months" ], "enumTitles": [ "All time", "Last 30 days", "Last 3 months", "Last 6 months", "Last 12 months" ], "prefill": "all", "title": "Date posted", "type": "string" }, "filterLanguage": { "default": "all", "description": "Only include reviews in this language. Trustpilot only serves a language a company actually has; otherwise the run returns no reviews for that company instead of mixing languages.", "editor": "select", "enum": [ "all", "en", "de", "fr", "es", "it", "nl", "pt", "pl", "sv", "da", "no", "fi", "cs", "sk", "hu", "ro", "bg", "el", "tr", "ru", "uk", "ar", "he", "hi", "ja", "ko", "zh", "th", "vi", "id", "ms", "ca", "et", "lv", "lt", "sl", "hr", "sr", "is", "fa", "bn", "ta", "te", "ml", "ur", "sw", "af", "sq", "mk", "bs", "be", "az", "ka", "hy", "kk", "uz", "mn", "ne", "si", "km", "lo", "my", "am", "zu" ], "enumTitles": [ "All languages", "English", "German", "French", "Spanish", "Italian", "Dutch", "Portuguese", "Polish", "Swedish", "Danish", "Norwegian", "Finnish", "Czech", "Slovak", "Hungarian", "Romanian", "Bulgarian", "Modern Greek (1453-)", "Turkish", "Russian", "Ukrainian", "Arabic", "Hebrew", "Hindi", "Japanese", "Korean", "Chinese", "Thai", "Vietnamese", "Indonesian", "Malay (macrolanguage)", "Catalan", "Estonian", "Latvian", "Lithuanian", "Slovenian", "Croatian", "Serbian", "Icelandic", "Persian", "Bengali", "Tamil", "Telugu", "Malayalam", "Urdu", "Swahili (macrolanguage)", "Afrikaans", "Albanian", "Macedonian", "Bosnian", "Belarusian", "Azerbaijani", "Georgian", "Armenian", "Kazakh", "Uzbek", "Mongolian", "Nepali (macrolanguage)", "Sinhala", "Khmer", "Lao", "Burmese", "Amharic", "Zulu" ], "prefill": "all", "title": "Review language", "type": "string" }, "filterReviewerCountries": { "description": "Only keep reviews from reviewers in these ISO country codes, e.g. US, GB, DE. Applied after collection.", "editor": "stringList", "title": "Reviewer countries", "type": "array" }, "filterStars": { "default": "", "description": "Only include reviews with this star rating. Leave on 'All stars' to include every rating.", "editor": "select", "enum": [ "", "1", "2", "3", "4", "5" ], "enumTitles": [ "All stars", "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ], "prefill": "", "title": "Star rating", "type": "string" }, "lastDays": { "description": "Rolling cutoff for scheduled runs, e.g. 7 for weekly or 1 for daily. If both this and the exact date are set, the more recent cutoff wins.", "maximum": 3650, "minimum": 1, "title": "Only the last N days", "type": "integer" }, "maxCompanies": { "default": 20, "description": "Maximum company results per search keyword (mode=searchCompanies).", "maximum": 1000, "minimum": 1, "prefill": 5, "title": "Max companies per search", "type": "integer" }, "maxItems": { "default": 50000, "description": "Maximum reviews across all companies in one run.", "maximum": 50000, "minimum": 1, "prefill": 3, "title": "Max reviews total", "type": "integer" }, "maxReviews": { "default": 100, "description": "Maximum reviews per company. Values above 200 are collected by splitting Trustpilot's 200-review view across star, language, and topic slices.", "maximum": 10000, "minimum": 1, "prefill": 3, "title": "Max reviews per company", "type": "integer" }, "mode": { "default": "reviews", "description": "What to collect. Reviews: scrape reviews. Companies: one profile record per company, with contacts and transparency data. Search companies: find companies by keyword.", "editor": "select", "enum": [ "reviews", "companies", "searchCompanies" ], "enumTitles": [ "Company reviews", "Company profiles", "Search companies" ], "prefill": "reviews", "title": "Mode", "type": "string" }, "onlyVerified": { "default": false, "description": "Only include reviews Trustpilot marks as verified purchases.", "prefill": false, "title": "Verified reviews only", "type": "boolean" }, "onlyWithReplies": { "default": false, "description": "Only include reviews that already have a company reply.", "prefill": false, "title": "Reviews with company replies only", "type": "boolean" }, "publishedAfter": { "description": "Exact cutoff date (YYYY-MM-DD). Reviews older than this are skipped. Works with mode=reviews.", "editor": "datepicker", "title": "Only reviews newer than", "type": "string" }, "searchCountry": { "default": "US", "description": "Country context for company search. It affects ranking and localisation, not a strict country filter.", "editor": "select", "enum": [ "US", "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "HR", "CU", "CW", "CY", "CZ", "CI", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RO", "RU", "RW", "RE", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TM", "TC", "TV", "TR", "UG", "UA", "AE", "GB", "UM", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW", "AX" ], "enumTitles": [ "United States", "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia, Plurinational State of", "Bonaire, Sint Eustatius and Saba", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cabo Verde", "Cambodia", "Cameroon", "Canada", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Congo, The Democratic Republic of the", "Cook Islands", "Costa Rica", "Croatia", "Cuba", "Curaçao", "Cyprus", "Czechia", "Côte d'Ivoire", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Eswatini", "Ethiopia", "Falkland Islands (Malvinas)", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Holy See (Vatican City State)", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran, Islamic Republic of", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Korea, Democratic People's Republic of", "Korea, Republic of", "Kuwait", "Kyrgyzstan", "Lao People's Democratic Republic", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia, Federated States of", "Moldova, Republic of", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Macedonia", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestine, State of", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Romania", "Russian Federation", "Rwanda", "Réunion", "Saint Barthélemy", "Saint Helena, Ascension and Tristan da Cunha", "Saint Kitts and Nevis", "Saint Lucia", "Saint Martin (French part)", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten (Dutch part)", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard and Jan Mayen", "Sweden", "Switzerland", "Syrian Arab Republic", "Taiwan, Province of China", "Tajikistan", "Tanzania, United Republic of", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Türkiye", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela, Bolivarian Republic of", "Viet Nam", "Virgin Islands, British", "Virgin Islands, U.S.", "Wallis and Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe", "Åland Islands" ], "prefill": "US", "title": "Search country", "type": "string" }, "searchKeyword": { "description": "Only include reviews whose title or text contains this phrase. Applied by Trustpilot before collection. Works with mode=reviews.", "editor": "textfield", "title": "Keyword in review text", "type": "string" }, "searchQueries": { "description": "Keywords for mode=searchCompanies, e.g. plumber, dentist, CRM software.", "editor": "stringList", "title": "Company search keywords", "type": "array" }, "sortBy": { "default": "recency", "description": "How Trustpilot orders reviews before collection.", "editor": "select", "enum": [ "recency", "relevance" ], "enumTitles": [ "Newest first", "Most relevant" ], "prefill": "recency", "title": "Sort order", "type": "string" }, "startUrls": { "description": "Trustpilot company page URLs, e.g. https://www.trustpilot.com/review/notion.so. You can also paste a company's own website URL. Merged with 'Company domains or names'.", "editor": "requestListSources", "prefill": [ { "url": "https://www.trustpilot.com/review/notion.so" } ], "title": "Company URLs", "type": "array" } }, "required": [ "mode" ], "schemaVersion": 1, "title": "Trustpilot Company Review Extractor Input", "type": "object" }