# Advanced Google Trends Scraper (`enrich-stream/advanced-google-trends-scraper`) Actor Powerful Google Trends Scraper. Extract Interest Over Time, Regional Data, Daily & Real-Time Trends. Supports keyword comparison, custom date ranges, and 100+ countries. - **URL**: https://apify.com/enrich-stream/advanced-google-trends-scraper.md - **Developed by:** [Abbas Meb](https://apify.com/enrich-stream) (community) - **Categories:** SEO tools, Social media, Automation - **Stats:** 4 total users, 2 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $20.00/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 ## Advanced Google Trends Scraper A comprehensive Apify Actor for extracting trend data from Google Trends. This actor provides access to all major Google Trends features including interest over time, regional data, related queries/topics, and trending searches. ### πŸš€ Features #### **4 Scraping Modes** - βœ… **Interest Over Time** - Track keyword popularity over time - βœ… **Interest By Region** - Geographic distribution of search interest - βœ… **Daily Trends** - Current top trending searches by country - βœ… **Real-Time Trends** - Live trending searches #### **Comprehensive Coverage** - 🌍 **118 Countries** - Full global coverage with user-friendly dropdown - ⏰ **10 Time Range Presets** - From past hour to all-time (2004-present) - πŸ“ **20 Categories** - Filter by topic (Finance, Health, Technology, etc.) - πŸ” **5 Google Properties** - Search across Web, Images, News, YouTube, Shopping - πŸ—ΊοΈ **4 Resolution Levels** - Country, Region/State, City, DMA (metro areas) #### **Advanced Features** - πŸ”„ **Keyword Comparison** - Compare up to 5 keywords simultaneously - πŸ“… **Custom Date Ranges** - Specify exact start and end dates - 🌐 **Multi-Language Support** - Search in any language - πŸ• **Timezone Control** - Adjust for local timezones - πŸ”’ **Proxy Support** - Built-in Apify Proxy integration --- ### πŸ“‹ Input Parameters #### **Scraping Modes** Enable one of the following sections to determine the scraping mode. **Note:** If multiple sections are enabled, the actor prioritizes in this order: 1. `Interest Over Time` 2. `Interest By Region` 3. `Daily Trends` 4. `Real-Time Trends` #### **1. Interest Over Time** (Toggle `enableInterestOverTime`) Track keyword popularity over a specific time range. | Field | Description | Type | Default | | -------------- | ---------------------------------- | ------ | ------------- | | `iotKeyword` | Search term(s) (Max 5) | Array | `["Bitcoin"]` | | `iotTimeRange` | Time period | String | `"now 1-d"` | | `iotGeo` | Location code | String | `"US"` | | `iotCategory` | Filter by category ID | String | `"0"` | | `iotProperty` | Google property (web, image, etc.) | String | `"web"` | #### **2. Interest By Region** (Toggle `enableInterestByRegion`) See where your keywords are most popular. | Field | Description | Type | Default | | --------------- | ------------------------------------------------ | ------ | ------------- | | `ibrKeyword` | Search term(s) (Max 5) | Array | `["Bitcoin"]` | | `ibrResolution` | Granularity (`COUNTRY`, `REGION`, `CITY`, `DMA`) | String | `"COUNTRY"` | | `ibrTimeRange` | Time period | String | `"now 1-d"` | | `ibrGeo` | Location code | String | `"US"` | #### **3. Daily Trends** (Toggle `enableDailyTrends`) Get today's top trending searches. | Field | Description | Type | Default | | ------------- | -------------------------------- | ------ | ------- | | `dtGeo` | Location code (e.g., "US", "JP") | String | `"US"` | | `dtTrendDate` | Specific date (YYYY-MM-DD) | String | Today | #### **4. Real-Time Trends** (Toggle `enableRealTimeTrends`) Get live, minute-by-minute trending stories. | Field | Description | Type | Default | | ------------ | --------------------- | ------ | ------- | | `rtGeo` | Location code | String | `"US"` | | `rtCategory` | Filter by category ID | String | `"0"` | --- #### **System Settings** | Field | Description | Type | Default | | -------------------- | ------------------------------------ | ------ | ------- | | `proxyConfiguration` | Proxies to key (Apify Proxy advised) | Object | Default | --- ### πŸ“Š Output Format The actor outputs structured JSON data to the Apify dataset. The exact format depends on the mode: #### **Interest Over Time** ```json { "default": { "timelineData": [ { "time": "1609459200", "formattedTime": "Jan 1, 2021", "formattedAxisTime": "Jan 1", "value": [75], "formattedValue": ["75"] } ] } } ```` #### **Interest By Region** ```json { "default": { "geoMapData": [ { "geoCode": "US-CA", "geoName": "California", "value": [100], "formattedValue": ["100"], "maxValueIndex": 0 } ] } } ``` #### **Daily Trends** ```json { "default": { "trendingSearchesDays": [ { "date": "20240201", "formattedDate": "Thursday, February 1, 2024", "trendingSearches": [ { "title": { "query": "Super Bowl 2024" }, "formattedTraffic": "2M+ searches", "articles": [...] } ] } ] } } ``` *** ### πŸ’‘ Use Cases #### **Market Research** - Track brand awareness over time - Compare competitor mentions - Identify seasonal trends - Find emerging markets by region #### **Content Strategy** - Discover trending topics before they peak - Find related keywords for SEO - Analyze search intent by property (web vs images) - Monitor regional content preferences #### **Investment Analysis** - Track interest in stocks, crypto, or sectors - Correlate search trends with market movements - Identify early signals of attention shifts - Monitor competitor interest #### **Academic Research** - Study public interest in scientific topics - Analyze political discourse trends - Track social movements geographically - Historical trend analysis (2004-present) *** ### 🎯 Example Inputs #### **Example 1: Compare Cryptocurrencies (Interest Over Time)** ```json { "enableInterestOverTime": true, "iotKeyword": ["Bitcoin", "Ethereum", "Solana"], "iotTimeRange": "today 12-m", "iotGeo": "US", "iotCategory": "7", "proxyConfiguration": { "useApifyProxy": true } } ``` #### **Example 2: Regional Interest in AI** ```json { "enableInterestByRegion": true, "ibrKeyword": ["Artificial Intelligence"], "ibrTimeRange": "today 3-m", "ibrGeo": "", "ibrResolution": "COUNTRY", "proxyConfiguration": { "useApifyProxy": true } } ``` #### **Example 3: Today's Trending Searches in Japan** ```json { "enableDailyTrends": true, "dtGeo": "JP", "proxyConfiguration": { "useApifyProxy": true } } ``` #### **Example 4: Real-Time Trends in UK** ```json { "enableRealTimeTrends": true, "rtGeo": "GB", "rtCategory": "0", "proxyConfiguration": { "useApifyProxy": true } } ``` *** ### πŸ”§ Development #### **Local Setup** ```bash ## Clone the repository git clone cd google-trends-scraper ## Install dependencies npm install ## Run locally npm start ``` #### **Test Inputs** The actor includes 15+ pre-configured test inputs in `.actor/test-inputs/`: - Basic interest over time - Multiple keyword comparisons - All 6 scraping modes - Different time ranges and properties - Various countries and categories See `.actor/test-inputs/README.md` for complete testing guide. *** ### πŸ“š Technical Details #### **Built With** - **Apify SDK** - Actor runtime and data storage - **@alkalisummer/google-trends-js** - Google Trends API wrapper - **TypeScript** - Type-safe development #### **Rate Limiting** - Google Trends has internal rate limiting - Use Apify Proxy (residential) for best results - Avoid rapid successive requests for same queries #### **Data Accuracy** - Data is normalized (0-100 scale) - 100 = peak popularity in selected timeframe - Real-time and daily trends show absolute search volumes - See [Google Trends Help](https://support.google.com/trends/) for methodology *** ### ⚠️ Limitations & Notes 1. **Keyword Requirements** - `dailyTrends` and `realTimeTrends` don't require keywords - Other modes require at least one keyword 2. **Time Windows** - Very short windows (e.g., past hour) may have insufficient data - Maximum lookback: 2004 (`all` option) 3. **Resolution Restrictions** - `COUNTRY` resolution requires `geo: ""`(worldwide) - `DMA` resolution only available for United States 4. **Comparison Limits** - Maximum 5 keywords for comparison - Results are relative to each other in the selected timeframe *** ### πŸ†˜ Troubleshooting | Issue | Solution | | ---------------------------- | --------------------------------------------------------------- | | "Keyword is required" | Check you're not using keywords with dailyTrends/realTimeTrends | | "Custom Start Time required" | Set `customStartTime` when `timeRange` is `"custom"` | | No data returned | Try broader keywords or longer time range | | Rate limit errors | Enable Apify Proxy (residential recommended) | | Empty results | Verify country code and category are valid | # Actor input Schema ## `interestOverTimeHeading` (type: `string`): Scrape interest over time for a keyword. ## `enableInterestOverTime` (type: `boolean`): Enable this section to scrape Interest Over Time. ## `iotKeyword` (type: `array`): Enter keyword(s). ## `iotGeo` (type: `string`): Target location. ## `iotTimeRange` (type: `string`): Time period. ## `iotCustomStartTime` (type: `string`): Start date (YYYY-MM-DD). Used if Time Range is 'Custom'. ## `iotCustomEndTime` (type: `string`): End date (YYYY-MM-DD). Used if Time Range is 'Custom'. ## `iotCategory` (type: `string`): Filter by category. ## `iotProperty` (type: `string`): Which Google service to search. ## `interestByRegionHeading` (type: `string`): Scrape interest by region. ## `enableInterestByRegion` (type: `boolean`): Enable this section to scrape Interest By Region. ## `ibrKeyword` (type: `array`): Enter keyword(s). ## `ibrGeo` (type: `string`): Target location. ## `ibrTimeRange` (type: `string`): Time period. ## `ibrCustomStartTime` (type: `string`): Start date (YYYY-MM-DD). ## `ibrCustomEndTime` (type: `string`): End date (YYYY-MM-DD). ## `ibrResolution` (type: `string`): Granularity of location data. ## `ibrCategory` (type: `string`): Filter by category. ## `ibrProperty` (type: `string`): Which Google service to search. ## `dailyTrendsHeading` (type: `string`): Scrape daily trending searches. ## `enableDailyTrends` (type: `boolean`): Enable this section to scrape Daily Trends. ## `dtGeo` (type: `string`): Target location. ## `dtTrendDate` (type: `string`): Date for daily trends (YYYY-MM-DD). Defaults to today if empty. ## `realTimeTrendsHeading` (type: `string`): Scrape real-time trending searches. ## `enableRealTimeTrends` (type: `boolean`): Enable this section to scrape Real-Time Trends. ## `rtGeo` (type: `string`): Target location. ## `rtCategory` (type: `string`): Filter by category. ## `proxyConfiguration` (type: `object`): Select proxies to use for the request. Residential proxies are recommended. ## Actor input object example ```json { "enableInterestOverTime": false, "iotKeyword": [ "Bitcoin" ], "iotGeo": "US", "iotTimeRange": "now 1-d", "iotCategory": "0", "iotProperty": "web", "enableInterestByRegion": false, "ibrKeyword": [ "Bitcoin" ], "ibrGeo": "US", "ibrTimeRange": "now 1-d", "ibrResolution": "COUNTRY", "ibrCategory": "0", "ibrProperty": "web", "enableDailyTrends": false, "dtGeo": "US", "enableRealTimeTrends": false, "rtGeo": "US", "rtCategory": "0", "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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "iotKeyword": [ "Bitcoin" ], "ibrKeyword": [ "Bitcoin" ] }; // Run the Actor and wait for it to finish const run = await client.actor("enrich-stream/advanced-google-trends-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 = { "iotKeyword": ["Bitcoin"], "ibrKeyword": ["Bitcoin"], } # Run the Actor and wait for it to finish run = client.actor("enrich-stream/advanced-google-trends-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 '{ "iotKeyword": [ "Bitcoin" ], "ibrKeyword": [ "Bitcoin" ] }' | apify call enrich-stream/advanced-google-trends-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=enrich-stream/advanced-google-trends-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Advanced Google Trends Scraper", "description": "Powerful Google Trends Scraper. Extract Interest Over Time, Regional Data, Daily & Real-Time Trends. Supports keyword comparison, custom date ranges, and 100+ countries.", "version": "0.0", "x-build-id": "9IamXv3FOUjXsDffo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/enrich-stream~advanced-google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-enrich-stream-advanced-google-trends-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/enrich-stream~advanced-google-trends-scraper/runs": { "post": { "operationId": "runs-sync-enrich-stream-advanced-google-trends-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/enrich-stream~advanced-google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-enrich-stream-advanced-google-trends-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", "properties": { "interestOverTimeHeading": { "title": "Enable Mode", "type": "string", "description": "Scrape interest over time for a keyword." }, "enableInterestOverTime": { "title": "Enable Interest Over Time Mode", "type": "boolean", "description": "Enable this section to scrape Interest Over Time.", "default": false }, "iotKeyword": { "title": "Search Term(s)", "type": "array", "description": "Enter keyword(s).", "items": { "type": "string" } }, "iotGeo": { "title": "Location", "enum": [ "", "US", "GB", "DE", "FR", "CA", "AU", "JP", "IN", "BR", "MX", "IT", "ES", "NL", "RU", "KR", "TR", "PL", "ID", "SA", "SE", "CH", "TW", "BE", "AT", "IE", "NO", "DK", "FI", "PT", "GR", "CZ", "RO", "HU", "NZ", "SG", "ZA", "TH", "VN", "PH", "MY", "CL", "CO", "PE", "AR", "UA", "PK", "BD", "NG", "EG", "IL", "AE" ], "type": "string", "description": "Target location.", "default": "US" }, "iotTimeRange": { "title": "Time Range", "enum": [ "now 1-H", "now 4-H", "now 1-d", "now 7-d", "today 1-m", "today 3-m", "today 12-m", "today 5-y", "all", "custom" ], "type": "string", "description": "Time period.", "default": "now 1-d" }, "iotCustomStartTime": { "title": "Custom Start Time", "type": "string", "description": "Start date (YYYY-MM-DD). Used if Time Range is 'Custom'." }, "iotCustomEndTime": { "title": "Custom End Time", "type": "string", "description": "End date (YYYY-MM-DD). Used if Time Range is 'Custom'." }, "iotCategory": { "title": "Category", "enum": [ "0", "3", "47", "44", "22", "12", "5", "71", "14", "66", "18", "13", "16", "282", "32", "29", "45", "67", "7", "19" ], "type": "string", "description": "Filter by category.", "default": "0" }, "iotProperty": { "title": "Google Property", "enum": [ "web", "images", "news", "youtube", "shopping" ], "type": "string", "description": "Which Google service to search.", "default": "web" }, "interestByRegionHeading": { "title": "Enable Mode", "type": "string", "description": "Scrape interest by region." }, "enableInterestByRegion": { "title": "Enable Interest By Region Mode", "type": "boolean", "description": "Enable this section to scrape Interest By Region.", "default": false }, "ibrKeyword": { "title": "Search Term(s)", "type": "array", "description": "Enter keyword(s).", "items": { "type": "string" } }, "ibrGeo": { "title": "Location", "enum": [ "", "US", "GB", "DE", "FR", "CA", "AU", "JP", "IN", "BR", "MX", "IT", "ES", "NL", "RU", "KR", "TR", "PL", "ID", "SA", "SE", "CH", "TW", "BE", "AT", "IE", "NO", "DK", "FI", "PT", "GR", "CZ", "RO", "HU", "NZ", "SG", "ZA", "TH", "VN", "PH", "MY", "CL", "CO", "PE", "AR", "UA", "PK", "BD", "NG", "EG", "IL", "AE" ], "type": "string", "description": "Target location.", "default": "US" }, "ibrTimeRange": { "title": "Time Range", "enum": [ "now 1-H", "now 4-H", "now 1-d", "now 7-d", "today 1-m", "today 3-m", "today 12-m", "today 5-y", "all", "custom" ], "type": "string", "description": "Time period.", "default": "now 1-d" }, "ibrCustomStartTime": { "title": "Custom Start Time", "type": "string", "description": "Start date (YYYY-MM-DD)." }, "ibrCustomEndTime": { "title": "Custom End Time", "type": "string", "description": "End date (YYYY-MM-DD)." }, "ibrResolution": { "title": "Resolution", "enum": [ "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Granularity of location data.", "default": "COUNTRY" }, "ibrCategory": { "title": "Category", "enum": [ "0", "3", "47", "44", "22", "12", "5", "71", "14", "66", "18", "13", "16", "282", "32", "29", "45", "67", "7", "19" ], "type": "string", "description": "Filter by category.", "default": "0" }, "ibrProperty": { "title": "Google Property", "enum": [ "web", "images", "news", "youtube", "shopping" ], "type": "string", "description": "Which Google service to search.", "default": "web" }, "dailyTrendsHeading": { "title": "Enable Mode", "type": "string", "description": "Scrape daily trending searches." }, "enableDailyTrends": { "title": "Enable Daily Trends Mode", "type": "boolean", "description": "Enable this section to scrape Daily Trends.", "default": false }, "dtGeo": { "title": "Location", "enum": [ "", "US", "GB", "DE", "FR", "CA", "AU", "JP", "IN", "BR", "MX", "IT", "ES", "NL", "RU", "KR", "TR", "PL", "ID", "SA", "SE", "CH", "TW", "BE", "AT", "IE", "NO", "DK", "FI", "PT", "GR", "CZ", "RO", "HU", "NZ", "SG", "ZA", "TH", "VN", "PH", "MY", "CL", "CO", "PE", "AR", "UA", "PK", "BD", "NG", "EG", "IL", "AE" ], "type": "string", "description": "Target location.", "default": "US" }, "dtTrendDate": { "title": "Trend Date", "type": "string", "description": "Date for daily trends (YYYY-MM-DD). Defaults to today if empty." }, "realTimeTrendsHeading": { "title": "Enable Mode", "type": "string", "description": "Scrape real-time trending searches." }, "enableRealTimeTrends": { "title": "Enable Real-Time Trends Mode", "type": "boolean", "description": "Enable this section to scrape Real-Time Trends.", "default": false }, "rtGeo": { "title": "Location", "enum": [ "", "US", "GB", "DE", "FR", "CA", "AU", "JP", "IN", "BR", "MX", "IT", "ES", "NL", "RU", "KR", "TR", "PL", "ID", "SA", "SE", "CH", "TW", "BE", "AT", "IE", "NO", "DK", "FI", "PT", "GR", "CZ", "RO", "HU", "NZ", "SG", "ZA", "TH", "VN", "PH", "MY", "CL", "CO", "PE", "AR", "UA", "PK", "BD", "NG", "EG", "IL", "AE" ], "type": "string", "description": "Target location.", "default": "US" }, "rtCategory": { "title": "Category", "enum": [ "0", "3", "47", "44", "22", "12", "5", "71", "14", "66", "18", "13", "16", "282", "32", "29", "45", "67", "7", "19" ], "type": "string", "description": "Filter by category.", "default": "0" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Select proxies to use for the request. Residential proxies are recommended.", "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 } } } } } } } } } } ```