# Google News Scraper (`scrapepilotapi/google-news-scraper`) Actor 📰 Google News Scraper extracts real‑time headlines, snippets, publishers, timestamps & links from Google News by topic, keyword, region & language. ⚡ Ideal for media monitoring, PR, SEO, market research & competitive intelligence. 🔎 Clean JSON/CSV output. - **URL**: https://apify.com/scrapepilotapi/google-news-scraper.md - **Developed by:** [ScrapePilot](https://apify.com/scrapepilotapi) (community) - **Categories:** Automation, Lead generation, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $19.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Google News Scraper Google News Scraper is a real-time Google News scraping tool that collects headlines, publishers, timestamps, links, snippets, and thumbnails from Google News RSS results — filtered by query, region, language, and time period. It solves the pain of manual monitoring by turning Google News into structured, machine-readable data that marketers, developers, data analysts, and researchers can use at scale. With built‑in proxy fallback and pagination strategies, this Google News crawler powers media monitoring, SEO analysis, and automated intelligence pipelines with clean JSON/CSV exports. ### What data / output can you get? Below are the exact fields this Google News data extraction actor saves to the Apify dataset in real time: | Data type | Description | Example value | | --- | --- | --- | | position | Sequential rank within the collected set | 1 | | title | News article title | “Tesla shares rise after delivery update” | | link | Direct article URL (resolved from Google redirect) | “https://www.bloomberg.com/news/...” | | domain | Publisher domain (derived from source name or URL) | “bloomberg.com” | | source | Publisher name (parsed from RSS title) | “Bloomberg” | | date | Human‑readable relative time (e.g., “2 hours ago”) | “3 hours ago” | | date_utc | ISO‑8601 UTC timestamp | “2026-04-03T03:25:12+00:00” | | snippet | Cleaned article snippet extracted from RSS description | “Company reported stronger‑than‑expected deliveries...” | | thumbnail | Base64 data URL of a representative image (if found) | “data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...” | | block_position | Same as position (useful for downstream ordering) | 1 | Notes: - Items are pushed as they’re processed (streaming save). - You can export your dataset as JSON, CSV, or Excel from the Apify platform. - Thumbnails are encoded as base64 data URLs when an image is found via Open Graph/Twitter Card tags or on‑page images; if none are found, the field may be an empty string. ### Key features - ⚡ Real‑time RSS extraction Processes Google News RSS feeds for your query and saves items to the dataset as they’re discovered — ideal for real-time dashboards and alerts. - 🌍 Region & language targeting Control result location and language via gl (Google Country), hl (UI Language), lr (Language Results), and cr (Country Results) to build localized feeds. - ⏱ Time period filtering Filter results by last_hour, last_day, last_week, last_month, last_year, or a custom date range (MM/DD/YYYY). - 🧠 Clean snippets & normalized dates HTML descriptions are cleaned into concise snippets; dates are provided both as human‑readable (date) and ISO‑8601 UTC (date_utc). - đŸ–Œïž Smart thumbnail capture Attempts Open Graph/Twitter preview images first, then falls back to on‑page images; outputs base64 data URLs for portability. - đŸ›Ąïž Automatic proxy fallback Robust request pipeline escalates from no proxy ➜ datacenter ➜ residential proxies on block/timeout to maximize reliability. - 🔁 Resilient retries & pacing Built‑in retry logic and gentle rate limiting keep runs stable under varying network conditions. - đŸ§© Developer‑friendly workflow Built with the Apify Python SDK and aiohttp for performance; consume results via the Apify API from Python, Node.js, or any HTTP client to power Google News scraper API workflows. ### How to use Google News Scraper - step by step 1. Create or log in to your Apify account Access the Apify Console to run the actor. 2. Open the “Google News Scraper” actor Find it in your dashboard and click “Run”. 3. Enter your input - Required: - query: Your search term (e.g., “Elon Musk”) - maxItems: Number of results to retrieve (100–5000) - Optional: - gl (Google Country), hl (UI Language), lr (Language Results), cr (Country Results) - time_period and optional time_period_min / time_period_max for custom ranges - nfpr (0/1) to exclude autocorrected results - filter (0/1) to control similar/omitted results filter - proxyConfiguration to configure proxies (defaults to no proxy, with automatic fallback inside the run) 4. Review key settings Choose your region/language, set a time window (e.g., last_day), and adjust filters (nfpr, filter) as needed. 5. Start the run Click “Start”. The actor will fetch, parse, and stream results to the dataset as it processes strategies and pages. 6. Monitor progress Logs will show proxy fallback decisions, retries, and how many new articles were found. 7. Export results Open the run’s Dataset and export to JSON, CSV, or Excel — or consume via the Apify API for downstream automation. Pro Tip: Orchestrate scheduled jobs and pipe results into BI dashboards, databases, or NLP pipelines using the Apify API for a seamless Google News aggregator script. ### Use cases | Use case name | Description | | --- | --- | | Media monitoring for PR | Track mentions of brands, executives, and products across regions/languages and export daily digests. | | SEO trend discovery | Analyze fresh headlines and snippets to spot trending keywords and content gaps for faster content planning. | | Competitive intelligence | Monitor competitor announcements, launches, and coverage to inform strategy and positioning. | | Market and finance tracking | Collect business and financial news, earnings updates, and sentiment indicators for analysis. | | AI/NLP training datasets | Feed clean, structured news items into LLMs, topic modeling, and classification pipelines. | | Academic & policy research | Build time‑bounded corpora by topic, region, and language for research reproducibility. | | API-driven news feeds | Power internal apps with a Google News scraper API by consuming the Apify dataset programmatically. | ### Why choose Google News Scraper? Built for precision, automation, and reliability, this Google News web scraping actor turns Google News into structured data with minimal setup. - 🚀 Fast & scalable: Async fetching with pagination strategies collects hundreds to thousands of items per run. - 🌐 Multilingual & multi‑region: Fine‑tune gl, hl, lr, cr for localized and language‑specific feeds. - đŸ§Ÿ Structured, analytics‑ready output: Clean snippets, normalized dates, and base64 thumbnails in consistent JSON records. - đŸ§Ș Developer‑ready: Python-based actor; results accessible via the Apify API from any environment (Python, Node.js, etc.). - đŸ›Ąïž Robust reliability: Automatic proxy fallback (none ➜ datacenter ➜ residential) plus retries and backoff. - 💾 Cost‑effective: Test runs with trial minutes before scaling to larger workloads. - 🔌 Easy integrations: Export to CSV/JSON/Excel or pull via API into tools and pipelines. Unlike brittle browser extensions, this production-grade Google News scraping without API keys relies on stable RSS endpoints and resilient networking to deliver consistent, high‑quality data. ### Is it legal / ethical to use Google News Scraper? Yes — when done responsibly. This actor processes publicly available Google News RSS feeds and does not access private or authenticated data. Guidelines for compliant use: - Respect platform terms and robots directives. - Avoid abusive traffic; let retries/backoff handle transient issues. - Use data for permitted, ethical purposes (research, monitoring, analytics). - Attribute original publishers where appropriate and follow fair-use principles. - Consult your legal team for edge cases in your jurisdiction. ### Input parameters & output format #### Example input JSON ```json { "query": "Tesla", "maxItems": 200, "gl": "United States", "hl": "English", "lr": "English", "cr": "United States", "time_period": "last_day", "nfpr": 1, "filter": 1, "proxyConfiguration": { "useApifyProxy": false } } ```` #### Parameters | Field | Type | Description | Default | Required | | --- | --- | --- | --- | --- | | maxItems | integer | Maximum number of search results to retrieve (min 100, max 5000). If out of range, the actor clamps to the nearest bound. | 100 | Yes | | query | string | The search term to use. | “Elon Musk” | Yes | | gl | string (enum) | Google Country to use for the query (e.g., “United States”). | — | No | | hl | string (enum) | Google UI Language for returned results (e.g., “English”). | — | No | | lr | string (enum) | Limit results to a specific language (Language Results). | — | No | | cr | string (enum) | Limit results to a specific country (Country Results). | — | No | | time\_period | string (enum) | Time period for results: last\_hour, last\_day, last\_week, last\_month, last\_year, custom. | — | No | | time\_period\_min | string | Minimum date for custom time period (MM/DD/YYYY). | — | No | | time\_period\_max | string | Maximum date for custom time period (MM/DD/YYYY). | — | No | | nfpr | integer | Exclude results from auto‑corrected queries (0 or 1). | 0 | No | | filter | integer | Enable/disable Similar Results and Omitted Results filters (0 or 1). | 1 | No | | proxyConfiguration | object | Configure proxies. The run starts with no proxy, then falls back to datacenter, then residential if needed. | {"useApifyProxy": false} | No | #### Example output item (JSON) ```json { "position": 1, "title": "Tesla shares rise after delivery update", "link": "https://www.bloomberg.com/news/...", "domain": "bloomberg.com", "source": "Bloomberg", "date": "2 hours ago", "date_utc": "2026-04-03T03:25:12+00:00", "snippet": "Tesla posted stronger-than-expected deliveries for the quarter, boosting investor sentiment ahead of earnings...", "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...truncated...", "block_position": 1 } ``` Notes: - thumbnail may be empty if no suitable image is found or retrievable. - date is a friendly relative time; date\_utc is an ISO‑8601 UTC timestamp for precise filtering. ### FAQ #### Is there a free tier or trial? Yes. This actor includes trial minutes (120) so you can evaluate performance and output before subscribing. #### Does it support Python or Node.js integrations? Yes. The actor is built in Python, and you can consume results from the Apify API using Python, Node.js, or any HTTP client, making it a flexible Google News scraper API for your stack. #### How many results can I scrape per run? You can request between 100 and 5000 items via maxItems. The actor uses multiple strategies and pagination to increase coverage within your configured limits. #### What filters can I use for language, country, and time? You can set gl (Google Country), hl (UI Language), lr (Language Results), cr (Country Results), and time\_period (including custom ranges with time\_period\_min and time\_period\_max). #### What data fields are included in the output? Each item includes position, title, link, domain, source, date, date\_utc, snippet, thumbnail (base64 data URL when available), and block\_position. #### Does it fetch article images? Yes. It tries Open Graph/Twitter Card images first, then inspects on‑page images. Valid images are downloaded and returned as base64 data URLs in thumbnail. #### How does the proxy system work? The run starts without a proxy. If blocks or errors occur, it automatically falls back to datacenter proxies and then to residential proxies, with retries and backoff for resilience. #### Is this a Google News RSS feed scraper or a SERP scraper? This actor targets Google News RSS endpoints for reliability and speed, then enriches results (e.g., thumbnails) by visiting article pages when needed. ### Final thoughts Google News Scraper is built to turn Google News into structured, analysis‑ready data for marketers, developers, analysts, and researchers. With robust filters (language, country, time), resilient proxy fallback, and clean JSON output, it streamlines everything from media monitoring to SEO trend analysis and AI dataset creation. Developers can automate end‑to‑end using the Apify API to power real‑time Google News scraping without API keys or browser automation. Start extracting smarter news insights today. # Actor input Schema ## `maxItems` (type: `integer`): Maximum number of search results to retrieve ## `query` (type: `string`): The search term to use ## `gl` (type: `string`): The Google country to use for the query ## `hl` (type: `string`): The Google UI language to return results ## `lr` (type: `string`): Limit the results to a specific language ## `cr` (type: `string`): Limit the results to a specific country ## `time_period` (type: `string`): Time period for results ## `time_period_min` (type: `string`): Minimum date for custom time period (MM/DD/YYYY) ## `time_period_max` (type: `string`): Maximum date for custom time period (MM/DD/YYYY) ## `nfpr` (type: `integer`): Exclude results from auto-corrected queries (0 or 1) ## `filter` (type: `integer`): Enable/disable Similar Results and Omitted Results filters (0 or 1) ## `proxyConfiguration` (type: `object`): Configure proxy settings. The actor will start with no proxy, then fallback to datacenter, then residential proxies if needed. ## Actor input object example ```json { "maxItems": 100, "query": "Elon Musk", "nfpr": 0, "filter": 1, "proxyConfiguration": { "useApifyProxy": false } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapepilotapi/google-news-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`đŸ’Ÿ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "proxyConfiguration": { "useApifyProxy": False } } # Run the Actor and wait for it to finish run = client.actor("scrapepilotapi/google-news-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("đŸ’Ÿ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "proxyConfiguration": { "useApifyProxy": false } }' | apify call scrapepilotapi/google-news-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapepilotapi/google-news-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google News Scraper", "description": "📰 Google News Scraper extracts real‑time headlines, snippets, publishers, timestamps & links from Google News by topic, keyword, region & language. ⚡ Ideal for media monitoring, PR, SEO, market research & competitive intelligence. 🔎 Clean JSON/CSV output.", "version": "0.1", "x-build-id": "jMagpYkV6UvuaEgWW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapepilotapi~google-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapepilotapi-google-news-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapepilotapi~google-news-scraper/runs": { "post": { "operationId": "runs-sync-scrapepilotapi-google-news-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapepilotapi~google-news-scraper/run-sync": { "post": { "operationId": "run-sync-scrapepilotapi-google-news-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "maxItems", "query" ], "properties": { "maxItems": { "title": "Maximum Items", "minimum": 100, "maximum": 5000, "type": "integer", "description": "Maximum number of search results to retrieve", "default": 100 }, "query": { "title": "Search Query", "type": "string", "description": "The search term to use", "default": "Elon Musk" }, "gl": { "title": "Google Country", "enum": [ "Ascension Island", "Andorra", "United Arab Emirates", "Antigua & Barbuda", "Anguilla", "Albania", "Armenia", "Angola", "Antarctica", "Argentina", "American Samoa", "Austria", "Australia", "Aruba", "Åland Islands", "Azerbaijan", "Bosnia & Herzegovina", "Barbados", "Bangladesh", "Belgium", "Burkina Faso", "Bulgaria", "Bahrain", "Burundi", "Benin", "St. BarthĂ©lemy", "Bermuda", "Brunei", "Bolivia", "Caribbean Netherlands", "Brazil", "Bahamas", "Bhutan", "Bouvet Island", "Botswana", "Belarus", "Belize", "Canada", "Cocos (Keeling) Islands", "Congo (DRC)", "Central African Republic", "Congo (Republic)", "Switzerland", "CĂŽte d'Ivoire", "Cook Islands", "Chile", "Cameroon", "Colombia", "Costa Rica", "Cape Verde", "Curaçao", "Christmas Island", "Cyprus", "Czech Republic", "Germany", "Djibouti", "Denmark", "Dominica", "Dominican Republic", "Algeria", "Ecuador", "Estonia", "Egypt", "Western Sahara", "Eritrea", "Spain", "Ethiopia", "Finland", "Fiji", "Falkland Islands (Islas Malvinas)", "Micronesia", "Faroe Islands", "France", "Gabon", "United Kingdom", "Grenada", "Georgia", "French Guiana", "Guernsey", "Ghana", "Gibraltar", "Greenland", "Gambia", "Guinea", "Guadeloupe", "Equatorial Guinea", "Greece", "South Georgia & South Sandwich Islands", "Guatemala", "Guam", "Guinea-Bissau", "Guyana", "Hong Kong", "Heard & McDonald Islands", "Honduras", "Croatia", "Haiti", "Hungary", "Indonesia", "Ireland", "Israel", "Isle of Man", "India", "British Indian Ocean Territory", "Iraq", "Iceland", "Italy", "Jersey", "Jamaica", "Jordan", "Japan", "Kenya", "Kyrgyzstan", "Cambodia", "Kiribati", "Comoros", "St. Kitts & Nevis", "South Korea", "Kuwait", "Cayman Islands", "Kazakhstan", "Laos", "Lebanon", "St. Lucia", "Liechtenstein", "Sri Lanka", "Liberia", "Lesotho", "Lithuania", "Luxembourg", "Latvia", "Libya", "Morocco", "Monaco", "Moldova", "Montenegro", "St. Martin", "Madagascar", "Marshall Islands", "Macedonia (FYROM)", "Mali", "Myanmar (Burma)", "Mongolia", "Macau", "Northern Mariana Islands", "Martinique", "Mauritania", "Montserrat", "Malta", "Mauritius", "Maldives", "Malawi", "Mexico", "Malaysia", "Mozambique", "Namibia", "New Caledonia", "Niger", "Norfolk Island", "Nigeria", "Nicaragua", "Netherlands", "Norway", "Nepal", "Nauru", "Niue", "New Zealand", "Oman", "Panama", "Peru", "French Polynesia", "Papua New Guinea", "Philippines", "Pakistan", "Poland", "St. Pierre & Miquelon", "Pitcairn Islands", "Puerto Rico", "Palestine", "Portugal", "Palau", "Paraguay", "Qatar", "RĂ©union", "Romania", "Serbia", "Russia", "Rwanda", "Saudi Arabia", "Solomon Islands", "Seychelles", "Sweden", "Singapore", "St. Helena", "Slovenia", "Svalbard & Jan Mayen", "Slovakia", "Sierra Leone", "San Marino", "Senegal", "Somalia", "Suriname", "South Sudan", "SĂŁo TomĂ© & PrĂ­ncipe", "El Salvador", "Sint Maarten", "Swaziland", "Tristan da Cunha", "Turks & Caicos Islands", "Chad", "French Southern Territories", "Togo", "Thailand", "Tajikistan", "Tokelau", "Timor-Leste", "Turkmenistan", "Tunisia", "Tonga", "Turkey", "Trinidad & Tobago", "Tuvalu", "Taiwan", "Tanzania", "Ukraine", "Uganda", "U.S. Outlying Islands", "United States", "Uruguay", "Uzbekistan", "Vatican City", "St. Vincent & Grenadines", "Venezuela", "British Virgin Islands", "U.S. Virgin Islands", "Vietnam", "Vanuatu", "Wallis & Futuna", "Samoa", "Kosovo", "Yemen", "Mayotte", "South Africa", "Zambia", "Zimbabwe" ], "type": "string", "description": "The Google country to use for the query" }, "hl": { "title": "UI Language", "enum": [ "Afrikaans", "Akan", "Albanian", "Amharic", "Arabic", "Armenian", "Azerbaijani", "Basque", "Belarusian", "Bemba", "Bengali", "Bihari", "Bosnian", "Breton", "Bulgarian", "Catalan", "Cherokee", "Chichewa", "Chinese (Simplified)", "Chinese (Traditional)", "Corsican", "Croatian", "Czech", "Danish", "Dutch", "English", "Esperanto", "Estonian", "Ewe", "Filipino", "Finnish", "French", "Frisian", "Ga", "Galician", "Georgian", "German", "Greek", "Guarani", "Gujarati", "Haitian Creole", "Hausa", "Hawaiian", "Hebrew", "Hindi", "Hungarian", "Icelandic", "Igbo", "Indonesian", "Interlingua", "Irish", "Italian", "Japanese", "Javanese", "Kannada", "Kazakh", "Khmer", "Korean", "Krio", "Kurdish", "Kurdish (Sorani)", "Kyrgyz", "Lao", "Latin", "Latvian", "Lingala", "Lithuanian", "Lozi", "Luganda", "Acholi", "Macedonian", "Malagasy", "Malay", "Malayalam", "Maltese", "Maori", "Marathi", "Mauritian Creole", "Moldovan", "Mongolian", "Montenegrin", "Nepali", "Nigerian Pidgin", "Northern Sotho", "Norwegian", "Norwegian (Nynorsk)", "Occitan", "Oromo", "Pashto", "Persian", "Polish", "Portuguese", "Portuguese (Brazil)", "Portuguese (Portugal)", "Punjabi", "Quechua", "Romanian", "Romansh", "Runyankole", "Russian", "Scots Gaelic", "Serbian", "Serbo-Croatian", "Sesotho", "Shona", "Sindhi", "Sinhala", "Slovak", "Slovenian", "Somali", "Spanish", "Spanish (Latin America)", "Sundanese", "Swahili", "Swedish", "Tajik", "Tamil", "Telugu", "Thai", "Tigrinya", "Tonga", "Tumbuka", "Turkish", "Turkmen", "Twi", "Ukrainian", "Urdu", "Uzbek", "Vietnamese", "Welsh", "Wolof", "Xhosa", "Yiddish", "Yoruba", "Zulu" ], "type": "string", "description": "The Google UI language to return results" }, "lr": { "title": "Language Results", "enum": [ "Arabic", "Armenian", "Belarusian", "Bulgarian", "Catalan", "Chinese (Simplified)", "Chinese (Traditional)", "Croatian", "Czech", "Danish", "Dutch", "English", "Esperanto", "Estonian", "Filipino", "Finnish", "French", "German", "Greek", "Hebrew", "Hungarian", "Icelandic", "Indonesian", "Italian", "Japanese", "Korean", "Latvian", "Lithuanian", "Norwegian", "Persian", "Polish", "Portuguese", "Romanian", "Russian", "Serbian", "Slovak", "Slovenian", "Spanish", "Swedish", "Thai", "Turkish", "Ukrainian", "Vietnamese" ], "type": "string", "description": "Limit the results to a specific language" }, "cr": { "title": "Country Results", "enum": [ "Ascension Island", "Andorra", "United Arab Emirates", "Antigua & Barbuda", "Anguilla", "Albania", "Armenia", "Angola", "Antarctica", "Argentina", "American Samoa", "Austria", "Australia", "Aruba", "Åland Islands", "Azerbaijan", "Bosnia & Herzegovina", "Barbados", "Bangladesh", "Belgium", "Burkina Faso", "Bulgaria", "Bahrain", "Burundi", "Benin", "St. BarthĂ©lemy", "Bermuda", "Brunei", "Bolivia", "Caribbean Netherlands", "Brazil", "Bahamas", "Bhutan", "Bouvet Island", "Botswana", "Belarus", "Belize", "Canada", "Cocos (Keeling) Islands", "Congo (DRC)", "Central African Republic", "Congo (Republic)", "Switzerland", "CĂŽte d'Ivoire", "Cook Islands", "Chile", "Cameroon", "Colombia", "Costa Rica", "Cape Verde", "Curaçao", "Christmas Island", "Cyprus", "Czech Republic", "Germany", "Djibouti", "Denmark", "Dominica", "Dominican Republic", "Algeria", "Ecuador", "Estonia", "Egypt", "Western Sahara", "Eritrea", "Spain", "Ethiopia", "Finland", "Fiji", "Falkland Islands (Islas Malvinas)", "Micronesia", "Faroe Islands", "France", "Gabon", "United Kingdom", "Grenada", "Georgia", "French Guiana", "Guernsey", "Ghana", "Gibraltar", "Greenland", "Gambia", "Guinea", "Guadeloupe", "Equatorial Guinea", "Greece", "South Georgia & South Sandwich Islands", "Guatemala", "Guam", "Guinea-Bissau", "Guyana", "Hong Kong", "Heard & McDonald Islands", "Honduras", "Croatia", "Haiti", "Hungary", "Indonesia", "Ireland", "Israel", "Isle of Man", "India", "British Indian Ocean Territory", "Iraq", "Iceland", "Italy", "Jersey", "Jamaica", "Jordan", "Japan", "Kenya", "Kyrgyzstan", "Cambodia", "Kiribati", "Comoros", "St. Kitts & Nevis", "South Korea", "Kuwait", "Cayman Islands", "Kazakhstan", "Laos", "Lebanon", "St. Lucia", "Liechtenstein", "Sri Lanka", "Liberia", "Lesotho", "Lithuania", "Luxembourg", "Latvia", "Libya", "Morocco", "Monaco", "Moldova", "Montenegro", "St. Martin", "Madagascar", "Marshall Islands", "Macedonia (FYROM)", "Mali", "Myanmar (Burma)", "Mongolia", "Macau", "Northern Mariana Islands", "Martinique", "Mauritania", "Montserrat", "Malta", "Mauritius", "Maldives", "Malawi", "Mexico", "Malaysia", "Mozambique", "Namibia", "New Caledonia", "Niger", "Norfolk Island", "Nigeria", "Nicaragua", "Netherlands", "Norway", "Nepal", "Nauru", "Niue", "New Zealand", "Oman", "Panama", "Peru", "French Polynesia", "Papua New Guinea", "Philippines", "Pakistan", "Poland", "St. Pierre & Miquelon", "Pitcairn Islands", "Puerto Rico", "Palestine", "Portugal", "Palau", "Paraguay", "Qatar", "RĂ©union", "Romania", "Serbia", "Russia", "Rwanda", "Saudi Arabia", "Solomon Islands", "Seychelles", "Sweden", "Singapore", "St. Helena", "Slovenia", "Svalbard & Jan Mayen", "Slovakia", "Sierra Leone", "San Marino", "Senegal", "Somalia", "Suriname", "South Sudan", "SĂŁo TomĂ© & PrĂ­ncipe", "El Salvador", "Sint Maarten", "Swaziland", "Tristan da Cunha", "Turks & Caicos Islands", "Chad", "French Southern Territories", "Togo", "Thailand", "Tajikistan", "Tokelau", "Timor-Leste", "Turkmenistan", "Tunisia", "Tonga", "Turkey", "Trinidad & Tobago", "Tuvalu", "Taiwan", "Tanzania", "Ukraine", "Uganda", "U.S. Outlying Islands", "United States", "Uruguay", "Uzbekistan", "Vatican City", "St. Vincent & Grenadines", "Venezuela", "British Virgin Islands", "U.S. Virgin Islands", "Vietnam", "Vanuatu", "Wallis & Futuna", "Samoa", "Kosovo", "Yemen", "Mayotte", "South Africa", "Zambia", "Zimbabwe" ], "type": "string", "description": "Limit the results to a specific country" }, "time_period": { "title": "Time Period", "enum": [ "last_hour", "last_day", "last_week", "last_month", "last_year", "custom" ], "type": "string", "description": "Time period for results" }, "time_period_min": { "title": "Custom Time Period Min", "pattern": "^\\d{2}/\\d{2}/\\d{4}$", "type": "string", "description": "Minimum date for custom time period (MM/DD/YYYY)" }, "time_period_max": { "title": "Custom Time Period Max", "pattern": "^\\d{2}/\\d{2}/\\d{4}$", "type": "string", "description": "Maximum date for custom time period (MM/DD/YYYY)" }, "nfpr": { "title": "No Autocorrect", "minimum": 0, "maximum": 1, "type": "integer", "description": "Exclude results from auto-corrected queries (0 or 1)", "default": 0 }, "filter": { "title": "Filter", "minimum": 0, "maximum": 1, "type": "integer", "description": "Enable/disable Similar Results and Omitted Results filters (0 or 1)", "default": 1 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Configure proxy settings. The actor will start with no proxy, then fallback to datacenter, then residential proxies if needed." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```