# Google Keyword Finder (`scrapepilot/google-keyword-finder`) Actor

Scrape unlimited keyword ideas from Google & Bing Autocomplete instantly. Get search volume, CPC, and competition data for any seed keyword. Supports country & language targeting with proxy rotation. Perfect for SEO, PPC campaigns, and content planning. Pay only per result scraped.

- **URL**: https://apify.com/scrapepilot/google-keyword-finder.md
- **Developed by:** [Scrape Pilot](https://apify.com/scrapepilot) (community)
- **Categories:** SEO tools, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 scraped keyword results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## 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 Keyword Finder

🔍 **Google Keyword Finder** is a powerful Apify Actor designed to discover and analyze **Google Keyword** suggestions using multiple search engines and expansion methods. This tool provides comprehensive **Google Keyword** data including search volume estimates, competition levels, CPC estimates, and trend analysis. Whether you're conducting SEO research, keyword planning, or content strategy development, the Google Keyword Finder delivers actionable **Google Keyword** intelligence efficiently.

With multi-source keyword aggregation, intelligent alphabet expansion, estimated metrics, and real-time dataset integration, the Google Keyword Finder ensures comprehensive discovery of relevant **Google Keyword** opportunities. It focuses on key **Google Keyword** metrics including search volume, competition, CPC rates, and trends, making it an essential tool for **Google Keyword** research and SEO strategy planning.

---

### 📋 Table of Contents

- [Features](#-features)
- [How It Works](#-how-it-works)
- [Input](#-input)
- [Output](#-output)
- [Keyword Sources](#-keyword-sources)
- [Metrics Explained](#-metrics-explained)
- [Technical Stack](#-technical-stack)
- [Data Fields](#-data-fields)
- [Use Cases](#-use-cases)
- [Quick Start](#-quick-start)
- [Configuration](#-configuration)
- [Performance](#-performance)
- [Important Notes](#-important-notes)
- [Keywords](#-keywords)
- [Changelog](#-changelog)
- [Support](#-support)

---

### 🔥 Features

- **Google Autocomplete Scraping** – Fetches **Google Keyword** suggestions directly from Google autocomplete API with country and language targeting.
- **Bing Autocomplete Integration** – Aggregates **Google Keyword** suggestions from Bing search suggestions for comprehensive results.
- **Alphabet Expansion** – Intelligently expands seed keywords with alphabet characters (a-z) to discover long-tail **Google Keyword** variations.
- **Search Volume Estimation** – Calculates realistic search volume estimates based on keyword characteristics.
- **Competition Analysis** – Analyzes keyword competitiveness (High, Medium, Low) based on commercial intent signals.
- **CPC Estimation** – Estimates cost-per-click for PPC advertising campaigns.
- **Trend Detection** – Identifies rising trends (AI-related keywords detected as trending).
- **Multi-Country Support** – Supports location-based **Google Keyword** research with country/language targeting.
- **Proxy Support** – Apify residential proxy support for reliable access to search engines.
- **Bulk Keyword Processing** – Analyzes multiple keywords and variations in batch.
- **Deduplication** – Automatically removes duplicate keyword suggestions.
- **Real-Time Dataset Push** – Pushes results to Apify Dataset with metrics.
- **Timestamp Recording** – Records analysis timestamp for tracking.
- **Error Handling** – Graceful error handling with detailed logging.
- **Asyncio-Friendly** – Non-blocking async/await architecture.

---

### ⚙️ How It Works

The Google Keyword Finder takes a seed keyword as input and discovers related keywords using multiple sources and expansion methods. It queries Google and Bing autocomplete APIs, expands the keyword using alphabet methods, and assigns estimated metrics. Results are aggregated, deduplicated, and pushed to the Apify Dataset.

**Key Processing Steps:**

1. **Input Parsing** – Accept seed keyword and configuration from Actor input
2. **Proxy Setup** – Configure Apify residential proxy if available
3. **Google Autocomplete** – Query Google suggestions with locale targeting
4. **Bing Autocomplete** – Query Bing suggestions for additional keywords
5. **Alphabet Expansion** – Expand seed keyword with alphabet characters
6. **Additional Expansions** – Continue expanding until limit reached
7. **Deduplication** – Remove duplicate keywords
8. **Metric Estimation** – Calculate volume, competition, CPC
9. **Trend Detection** – Identify trending keywords
10. **Result Compilation** – Aggregate findings
11. **Dataset Push** – Push to Apify Dataset

**Key Benefits:**

- Discover long-tail **Google Keyword** variations
- Research competitors' **Google Keyword** strategies
- Find low-competition **Google Keyword** opportunities
- Plan content calendars based on **Google Keyword** trends
- Estimate traffic and revenue potential
- Identify seasonal keyword trends
- Build comprehensive keyword databases

---

### 📥 Input

The Actor accepts the following input parameters:

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `seed_keyword` | string | required | Base keyword to expand (e.g., "digital marketing", "seo tools") |
| `limit` | integer | `100` | Maximum keywords to discover (1-1000) |
| `country` | string | `"us"` | Country code for localized results (us, uk, de, fr, etc.) |
| `language` | string | `"en"` | Language code (en, de, fr, es, etc.) |
| `proxyConfiguration` | object | `{"useApifyProxy": true}` | Proxy settings |

**Example Input:**

```json
{
  "seed_keyword": "digital marketing",
  "limit": 150,
  "country": "us",
  "language": "en",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
````

**International Example:**

```json
{
  "seed_keyword": "seo tools",
  "limit": 100,
  "country": "uk",
  "language": "en"
}
```

**Long-tail Keyword Example:**

```json
{
  "seed_keyword": "best digital marketing agencies",
  "limit": 200
}
```

***

### 📤 Output

The Actor pushes **Google Keyword** records with the following structure:

| Field | Type | Description |
|-------|------|-------------|
| `keyword` | string | Discovered **Google Keyword** |
| `search_volume` | integer | Estimated monthly search volume |
| `competition` | string | Competition level (High, Medium, Low) |
| `cpc` | float | Estimated cost-per-click in USD |
| `trend` | string | Trend status (Rising, Stable, Declining) |
| `scraped_at` | string | ISO 8601 analysis timestamp |

**Example Output Records:**

```json
{
  "keyword": "digital marketing services",
  "search_volume": 2300,
  "competition": "High",
  "cpc": 3.45,
  "trend": "Stable",
  "scraped_at": "2025-02-14T12:00:00Z"
}
```

```json
{
  "keyword": "affordable digital marketing",
  "search_volume": 890,
  "competition": "Medium",
  "cpc": 2.15,
  "trend": "Rising",
  "scraped_at": "2025-02-14T12:00:00Z"
}
```

```json
{
  "keyword": "digital marketing ai tools",
  "search_volume": 1200,
  "competition": "Medium",
  "cpc": 3.80,
  "trend": "Rising",
  "scraped_at": "2025-02-14T12:00:00Z"
}
```

***

### 🌐 Keyword Sources

#### **1. Google Autocomplete**

- **API**: `https://suggestqueries.google.com/complete/search`
- **Method**: GET request with parameters
- **Parameters**: `q` (query), `hl` (language), `gl` (country), `client` (firefox)
- **Response**: JSON with keyword suggestions
- **Reliability**: High (primary search engine data)
- **Latency**: Low (<500ms)

#### **2. Bing Autocomplete**

- **API**: `https://api.bing.com/osjson.aspx`
- **Method**: GET request with parameters
- **Parameters**: `query` (search term)
- **Response**: JSON with suggestions
- **Reliability**: High (secondary search engine)
- **Latency**: Low (<500ms)

#### **3. Alphabet Expansion**

- **Method**: Combine seed keyword with alphabet characters (a-z)
- **Query Pattern**: "{seed\_keyword} {letter}"
- **Coverage**: Discovers long-tail variations
- **Examples**: "seo tools a", "seo tools b", etc.
- **Deduplication**: Removes duplicates across sources

***

### 📊 Metrics Explained

#### **Search Volume**

- **Definition**: Estimated monthly searches for the keyword
- **Calculation**: Based on keyword complexity and word count
- **Range**: 100-5000+ depending on keyword specificity
- **Formula**: Base volume / (word count \* 0.5) rounded to nearest 100
- **Interpretation**:
  - **>10,000**: High demand, competitive
  - **1,000-10,000**: Medium demand
  - **<1,000**: Low demand, niche

#### **Competition**

- **Definition**: Estimated difficulty of ranking
- **Levels**: High, Medium, Low
- **Signals**:
  - **High**: Contains commercial terms ("buy", "best", "service", "agency")
  - **Medium**: Neutral commercial intent
  - **Low**: Informational terms
- **Interpretation**:
  - **High**: More paid competition, harder to rank
  - **Medium**: Balanced competition
  - **Low**: Less competition, easier to rank

#### **CPC (Cost-Per-Click)**

- **Definition**: Estimated PPC advertising cost
- **Currency**: USD
- **Range**: $0.50-$5.00+
- **Calculation**: Random estimate between $0.50-$5.00
- **Interpretation**:
  - **>$3.00**: Valuable keywords, competitive
  - **$1.00-$3.00**: Moderate value
  - **<$1.00**: Lower value, niche

#### **Trend**

- **Definition**: Keyword popularity direction
- **Status**: Rising, Stable, Declining
- **Detection**: AI-related keywords marked as "Rising"
- **Interpretation**:
  - **Rising**: Increasing interest, opportunity
  - **Stable**: Consistent demand
  - **Declining**: Decreasing interest

***

### 🧰 Technical Stack

- **HTTP Requests:** requests library with asyncio executor
- **APIs:** Google Autocomplete, Bing Autocomplete
- **Async:** asyncio for concurrent requests
- **Pattern Matching:** Python regex for text cleaning
- **JSON:** Native JSON parsing
- **Proxy:** Apify Proxy with residential support
- **SSL:** urllib3 for SSL handling (warnings disabled)
- **Logging:** Apify Actor logging system
- **Platform:** Apify Actor serverless environment
- **Timeout:** 15 seconds per request

***

### 📊 Data Fields Explained

#### **Keyword Data**

- **keyword**: Clean, normalized **Google Keyword** text

#### **Performance Metrics**

- **search\_volume**: Estimated monthly searches
- **competition**: Relative competitiveness level
- **cpc**: Advertising cost estimate
- **trend**: Popularity direction

#### **Metadata**

- **scraped\_at**: Timestamp of analysis (UTC)

***

### 🎯 Use Cases

- **SEO Keyword Research** – Find **Google Keyword** opportunities for content
- **Content Strategy** – Plan content calendar around **Google Keyword** trends
- **PPC Campaign Planning** – Identify profitable **Google Keyword** targets
- **Competitor Analysis** – Research competitor keyword strategies
- **Long-tail Discovery** – Find low-competition long-tail **Google Keyword** variations
- **Niche Market Research** – Discover profitable niches via **Google Keyword** analysis
- **Product Ideas** – Identify market demand for products via **Google Keyword** search volume
- **Blog Topic Planning** – Generate blog topics from trending **Google Keywords**
- **Landing Page Optimization** – Create landing pages for target **Google Keywords**
- **Paid Search Strategy** – Plan PPC campaigns using **Google Keyword** data
- **International SEO** – Research keywords in different languages/countries
- **Seasonal Keyword Planning** – Identify seasonal **Google Keyword** trends
- **Question-Based Content** – Find common questions in **Google Keyword** data
- **Keyword Gap Analysis** – Identify unranked **Google Keywords** for your site
- **Market Sizing** – Estimate market size via **Google Keyword** volume

***

### 🚀 Quick Start

#### **1. Prepare Input**

Go to Apify Console and enter:

```json
{
  "seed_keyword": "digital marketing",
  "limit": 150,
  "country": "us",
  "language": "en"
}
```

#### **2. Run the Actor**

Click **Start** button. The Actor will:

- Query Google Autocomplete
- Query Bing Autocomplete
- Expand with alphabet variations
- Estimate metrics for each keyword
- Push results to Dataset

#### **3. Monitor Progress**

Console shows:

```
Starting search for: digital marketing (Proxy: Enabled)
Fetching Google Autocomplete...
Expanding via alphabet method...
Successfully found 142 keywords.
```

#### **4. View & Download Results**

- **Results Tab**: All keyword records
- **Export**: JSON, CSV, Excel
- **Filter**: By search volume or competition
- **Sort**: By CPC or search volume

***

### ⚙️ Configuration

#### **Seed Keyword**

Single word:

```json
{
  "seed_keyword": "seo"
}
```

Multi-word:

```json
{
  "seed_keyword": "best seo tools"
}
```

Long-tail:

```json
{
  "seed_keyword": "best affordable seo tools for small business"
}
```

#### **Geographic Targeting**

US English:

```json
{
  "country": "us",
  "language": "en"
}
```

UK English:

```json
{
  "country": "uk",
  "language": "en"
}
```

German:

```json
{
  "country": "de",
  "language": "de"
}
```

#### **Resource Usage**

- Memory: ~30-50MB
- CPU: ~10-15% during processing
- Network: ~200KB-500KB per search
- API calls: ~3 (Google, Bing, alphabet expansions)

#### **Batch Processing**

- Handles 50-1000 keywords efficiently
- Real-time Dataset push
- Deduplication across sources

#### **Data Quality**

- **Accuracy**: Estimates are based on keyword characteristics
- **Volume Estimates**: Not exact, use for relative comparison
- **Competition**: Binary classification may oversimplify
- **CPC Estimates**: Vary by industry and search intent
- **Verification**: Always verify with official tools (Google Ads)

#### **Best Practices**

- Use search volume for relative comparison, not absolute
- Verify keywords with Google Keyword Planner
- Consider search intent alongside volume
- Test keywords before investing heavily
- Monitor keyword trends over time
- Combine with competitor analysis
- Validate metrics with actual PPC campaigns

### 📦 Changelog

#### v1.0.0 (February 2025)

**Initial Release:**

- Google Autocomplete API integration
- Bing Autocomplete API integration
- Alphabet expansion method (a-f letters)
- Search volume estimation
- Competition level analysis
- CPC cost estimation
- Trend detection (AI keywords marked as rising)
- Country and language targeting
- Multi-locale support (us, uk, de, fr, etc.)
- Apify proxy support
- Bulk keyword processing
- Deduplication across sources
- Asyncio executor for non-blocking requests
- Real-time Dataset push
- ISO 8601 timestamp recording
- Error handling and logging

***

### 🧑‍💻 Support & Feedback

- **Issues:** Submit via Apify console
- **Documentation:** Check Actor details page
- **Community:** Apify forum discussions
- **Feature Requests:** Suggest improvements
- **Bug Reports:** Include seed keywords and errors

#### **Output Access**

- **Results Tab**: All keyword records
- **Export**: JSON, CSV, Excel
- **Filter**: By volume, competition, CPC
- **API**: Query via Apify API

***

**Disclaimer:**
Google Keyword Finder is provided as-is for keyword research purposes. Users are responsible for ensuring compliance with search engine policies. Always verify metrics with official tools like Google Keyword Planner.

***

### 🎉 Get Started Today

**Deploy now for keyword research!**

Use for:

- 📊 SEO Research
- 🎯 Content Planning
- 💡 Keyword Discovery
- 📈 Trend Analysis
- 💰 PPC Strategy

**Perfect for:**

- SEO Professionals
- Content Marketers
- PPC Specialists
- Digital Marketers
- Agency Teams

***

**Last Updated:** February 2025\
**Version:** 1.0.0\
**Status:** Production Ready\
**Platform:** Apify Actor\
**Architecture:** Async/Await\
**Sources:** 2 (Google + Bing)\
**Expansion:** Alphabet method

***

### 📚 Related Tools

- Smart Article Extractor
- Business Social Media Finder
- Fast News Content Scraper
- Website Technology Stack Scraper

**Your complete Apify-powered keyword research solution!** 🚀✨

***

### 🔍 Keyword Research Excellence

This Actor is optimized for **Google Keyword** discovery with:

- ✅ Multi-source aggregation
- ✅ Google and Bing integration
- ✅ Alphabet expansion method
- ✅ Intelligent metric estimation
- ✅ Trend detection
- ✅ Real-time Dataset integration
- ✅ Error recovery
- ✅ Production-ready code

# Actor input Schema

## `seed_keyword` (type: `string`):

The main keyword to find suggestions for.

## `limit` (type: `integer`):

Maximum number of keywords to collect.

## `country` (type: `string`):

Target country (e.g., us, uk, bd).

## `language` (type: `string`):

Target language (e.g., en, bn).

## `proxyConfiguration` (type: `object`):

Select the proxy to avoid Google blocks.

## Actor input object example

```json
{
  "seed_keyword": "digital marketing",
  "limit": 100,
  "country": "us",
  "language": "en",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "seed_keyword": "digital marketing"
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapepilot/google-keyword-finder").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "seed_keyword": "digital marketing" }

# Run the Actor and wait for it to finish
run = client.actor("scrapepilot/google-keyword-finder").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 '{
  "seed_keyword": "digital marketing"
}' |
apify call scrapepilot/google-keyword-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapepilot/google-keyword-finder",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Keyword Finder",
        "description": "Scrape unlimited keyword ideas from Google & Bing Autocomplete instantly. Get search volume, CPC, and competition data for any seed keyword. Supports country & language targeting with proxy rotation. Perfect for SEO, PPC campaigns, and content planning. Pay only per result scraped.",
        "version": "0.0",
        "x-build-id": "p3RP1RDDlNdESL5vH"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapepilot~google-keyword-finder/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapepilot-google-keyword-finder",
                "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/scrapepilot~google-keyword-finder/runs": {
            "post": {
                "operationId": "runs-sync-scrapepilot-google-keyword-finder",
                "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/scrapepilot~google-keyword-finder/run-sync": {
            "post": {
                "operationId": "run-sync-scrapepilot-google-keyword-finder",
                "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": [
                    "seed_keyword"
                ],
                "properties": {
                    "seed_keyword": {
                        "title": "Seed Keyword",
                        "type": "string",
                        "description": "The main keyword to find suggestions for."
                    },
                    "limit": {
                        "title": "Max Keywords",
                        "type": "integer",
                        "description": "Maximum number of keywords to collect.",
                        "default": 100
                    },
                    "country": {
                        "title": "Country Code",
                        "type": "string",
                        "description": "Target country (e.g., us, uk, bd).",
                        "default": "us"
                    },
                    "language": {
                        "title": "Language Code",
                        "type": "string",
                        "description": "Target language (e.g., en, bn).",
                        "default": "en"
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Select the proxy to avoid Google blocks.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
