{ "openapi": "3.0.1", "info": { "title": "Google Forums Search Scraper — Public Discussions", "description": "Search the Google Forums tab for public discussion threads. Returns one structured result per thread with query context, source, date, snippet, answer previews, and reproducible source routing.", "version": "0.7", "x-build-id": "fHtJfH20oxdEnGc8Y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~google-forums-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-google-forums-search-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/khadinakbar~google-forums-search-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-google-forums-search-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/khadinakbar~google-forums-search-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-google-forums-search-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": [ "queries" ], "properties": { "queries": { "title": "Forum search queries", "minItems": 1, "maxItems": 50, "type": "array", "description": "One or more phrases to search in Google's Forums tab. Each query returns public discussion threads only, not ordinary web results.", "items": { "type": "string" } }, "countryCode": { "title": "Country (gl)", "pattern": "^[a-z]{2}$", "type": "string", "description": "Two-letter lowercase country code used for Google result localization, such as us, gb, or de.", "default": "us" }, "languageCode": { "title": "Language (hl)", "pattern": "^[a-z]{2}$", "type": "string", "description": "Two-letter lowercase Google interface and result language code, such as en, de, or es.", "default": "en" }, "device": { "title": "Device", "enum": [ "desktop", "mobile", "tablet" ], "type": "string", "description": "Google Forums layout to request. Desktop is the default; mobile can return a different ranking.", "default": "desktop" }, "maxResultsPerQuery": { "title": "Maximum results per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum public thread records to save for each query. The Actor fetches only the pages necessary to reach this cap. Free Apify plan runs return up to 40 results per run.", "default": 20 }, "dateRange": { "title": "Date range", "enum": [ "anytime", "hour", "day", "week", "month", "year" ], "type": "string", "description": "Optional Google date filter. This limits Google results by recency; it does not modify the returned date text.", "default": "anytime" }, "includeAnswerPreviews": { "title": "Include answer previews", "type": "boolean", "description": "When Google returns answer previews under a forum result, include their public snippet, link, and labels. Defaults to true.", "default": true }, "includeDomains": { "title": "Only these forum domains (optional)", "maxItems": 20, "type": "array", "description": "Optional bare domains to include, such as reddit.com or stackoverflow.com. The Actor adds Google site: filters and keeps the original query in output. Do not include URLs, paths, or wildcards.", "default": [], "items": { "type": "string" } }, "excludeDomains": { "title": "Exclude forum domains (optional)", "maxItems": 20, "type": "array", "description": "Optional bare domains to exclude. The Actor adds Google -site: filters. A domain cannot be both included and excluded.", "default": [], "items": { "type": "string" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }