{ "openapi": "3.0.1", "info": { "title": "Google Search Fast & Complete Result (SERP)", "description": "Extract structured, real-time Google Search engine results pages (SERPs) instantly. Get comprehensive search data including organic web rankings, Knowledge Graph cards, top news stories, People Also Ask questions, sponsored ads, video results, and related searches in clean JSON format.", "version": "0.0", "x-build-id": "GMKInbza5LKvomAfQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ilborso~google-search-fast-complete-result/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ilborso-google-search-fast-complete-result", "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/ilborso~google-search-fast-complete-result/runs": { "post": { "operationId": "runs-sync-ilborso-google-search-fast-complete-result", "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/ilborso~google-search-fast-complete-result/run-sync": { "post": { "operationId": "run-sync-ilborso-google-search-fast-complete-result", "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": [ "q" ], "properties": { "q": { "title": "Search Query", "type": "string", "description": "The search query string to execute on Google (e.g., 'Trump', 'best laptops 2026')." }, "max_page": { "title": "Max Pages", "minimum": 1, "type": "integer", "description": "Maximum page number up to which to retrieve search results (e.g. max_page = 5 retrieves pages 1 to 5 with start 0, 10, 20, 30, 40). Mutually exclusive with 'page_start'." }, "page_start": { "title": "Page Start", "minimum": 1, "type": "integer", "description": "The page number to retrieve (1 for first google result page, 2 for the second-one, 3 for third page, etc.). Mutually exclusive with 'max_page'." }, "device": { "title": "Device Type", "enum": [ "desktop", "mobile" ], "type": "string", "description": "Device type for SERP layout. Accepted values: desktop, mobile.", "default": "desktop" }, "include_html": { "title": "Include HTML", "type": "boolean", "description": "If enabled, fetches and includes the raw HTML string of the Google Search page in the output.", "default": false }, "hl": { "title": "Language", "enum": [ "aa", "ab", "af", "am", "ar", "as", "ay", "az", "ba", "be", "bg", "bh", "bi", "bn", "bo", "br", "ca", "co", "cs", "cy", "da", "de", "dz", "el", "en", "eo", "es", "et", "eu", "fa", "fi", "fj", "fo", "fr", "fy", "ga", "gd", "gl", "gn", "gu", "ha", "he", "hi", "hr", "hu", "hy", "ia", "id", "ie", "ik", "is", "it", "iu", "ja", "jw", "ka", "kk", "kl", "km", "kn", "ko", "ks", "ku", "ky", "la", "ln", "lo", "lt", "lv", "mg", "mi", "mk", "ml", "mn", "mo", "mr", "ms", "mt", "my", "na", "ne", "nl", "no", "oc", "om", "or", "pa", "pl", "ps", "pt", "qu", "rm", "rn", "ro", "ru", "rw", "sa", "sd", "sg", "sh", "si", "sk", "sl", "sm", "sn", "so", "sq", "sr", "ss", "st", "su", "sv", "sw", "ta", "te", "tg", "th", "ti", "tk", "tl", "tn", "to", "tr", "ts", "tt", "tw", "ug", "uk", "ur", "uz", "vi", "vo", "wo", "xh", "yi", "yo", "za", "zh", "zu" ], "type": "string", "description": "Host language for the Google Search results.", "default": "en" }, "gl": { "title": "Country", "enum": [ "ad", "ae", "af", "ag", "ai", "al", "am", "ao", "aq", "ar", "as", "at", "au", "aw", "ax", "az", "ba", "bb", "bd", "be", "bf", "bg", "bh", "bi", "bj", "bl", "bm", "bn", "bo", "bq", "br", "bs", "bt", "bv", "bw", "by", "bz", "ca", "cc", "cd", "cf", "cg", "ch", "ci", "ck", "cl", "cm", "cn", "co", "cr", "cu", "cv", "cw", "cx", "cy", "cz", "de", "dj", "dk", "dm", "do", "dz", "ec", "ee", "eg", "eh", "er", "es", "et", "fi", "fj", "fk", "fm", "fo", "fr", "ga", "gb", "gd", "ge", "gf", "gg", "gh", "gi", "gl", "gm", "gn", "gp", "gq", "gr", "gs", "gt", "gu", "gw", "gy", "hk", "hm", "hn", "hr", "ht", "hu", "id", "ie", "il", "im", "in", "io", "iq", "ir", "is", "it", "je", "jm", "jo", "jp", "ke", "kg", "kh", "ki", "km", "kn", "kp", "kr", "kw", "ky", "kz", "la", "lb", "lc", "li", "lk", "lr", "ls", "lt", "lu", "lv", "ly", "ma", "mc", "md", "me", "mf", "mg", "mh", "mk", "ml", "mm", "mn", "mo", "mp", "mq", "mr", "ms", "mt", "mu", "mv", "mw", "mx", "my", "mz", "na", "nc", "ne", "nf", "ng", "ni", "nl", "no", "np", "nr", "nu", "nz", "om", "pa", "pe", "pf", "pg", "ph", "pk", "pl", "pm", "pn", "pr", "ps", "pt", "pw", "py", "qa", "re", "ro", "rs", "ru", "rw", "sa", "sb", "sc", "sd", "se", "sg", "sh", "si", "sj", "sk", "sl", "sm", "sn", "so", "sr", "ss", "st", "sv", "sx", "sy", "sz", "tc", "td", "tf", "tg", "th", "tj", "tk", "tl", "tm", "tn", "to", "tr", "tt", "tv", "tw", "tz", "ua", "ug", "um", "us", "uy", "uz", "va", "vc", "ve", "vg", "vi", "vn", "vu", "wf", "ws", "ye", "yt", "za", "zm", "zw" ], "type": "string", "description": "Country perspective for Google Search results.", "default": "us" }, "google_domain": { "title": "Google Domain", "enum": [ "google.com", "google.co.uk", "google.ca", "google.com.au", "google.de", "google.fr", "google.it", "google.es", "google.co.jp", "google.co.kr", "google.com.br", "google.com.mx", "google.co.in", "google.ru", "google.nl", "google.be", "google.ch", "google.at", "google.se", "google.no", "google.dk", "google.fi", "google.pl", "google.pt", "google.co.za", "google.com.tr", "google.com.eg", "google.com.sa", "google.ae", "google.co.id", "google.com.my", "google.com.sg", "google.com.ph", "google.co.th", "google.com.vn", "google.com.tw", "google.com.hk", "google.co.nz", "google.com.ar", "google.cl", "google.com.co", "google.com.pe", "google.co.il", "google.ie", "google.gr", "google.hu", "google.cz", "google.ro", "google.com.ua", "google.co.ke", "google.com.ng", "google.com.pk" ], "type": "string", "description": "The Google domain to use for the search query.", "default": "google.com" }, "location": { "title": "Location (Canonical)", "type": "string", "description": "City or region in Google's canonical format (e.g., 'New York,New York,United States', 'Istanbul,Istanbul,Turkey')." }, "lr": { "title": "Language Restrict (lr)", "enum": [ "", "lang_ar", "lang_bg", "lang_ca", "lang_cs", "lang_da", "lang_de", "lang_el", "lang_en", "lang_es", "lang_et", "lang_fi", "lang_fr", "lang_hr", "lang_hu", "lang_id", "lang_is", "lang_it", "lang_iw", "lang_ja", "lang_ko", "lang_lt", "lang_lv", "lang_nl", "lang_no", "lang_pl", "lang_pt", "lang_ro", "lang_ru", "lang_sk", "lang_sl", "lang_sr", "lang_sv", "lang_tr", "lang_zh-CN", "lang_zh-TW" ], "type": "string", "description": "Filters results to pages written in a specific language only." }, "cr": { "title": "Country Restrict (cr)", "enum": [ "", "countryAE", "countryAL", "countryAR", "countryAT", "countryAU", "countryBA", "countryBD", "countryBE", "countryBG", "countryBH", "countryBO", "countryBR", "countryBY", "countryCA", "countryCH", "countryCL", "countryCN", "countryCO", "countryCR", "countryCU", "countryCZ", "countryDE", "countryDK", "countryDM", "countryDO", "countryDZ", "countryEC", "countryEE", "countryEG", "countryES", "countryET", "countryEU", "countryFI", "countryFR", "countryGE", "countryGH", "countryGR", "countryGT", "countryGY", "countryHK", "countryHN", "countryHR", "countryHT", "countryHU", "countryID", "countryIE", "countryIL", "countryIN", "countryIQ", "countryIR", "countryIS", "countryIT", "countryJM", "countryJO", "countryJP", "countryKE", "countryKG", "countryKH", "countryKP", "countryKR", "countryKW", "countryKZ", "countryLA", "countryLB", "countryLI", "countryLK", "countryLT", "countryLU", "countryLV", "countryLY", "countryMA", "countryMC", "countryMD", "countryMK", "countryMM", "countryMN", "countryMO", "countryMT", "countryMX", "countryMY", "countryNG", "countryNI", "countryNL", "countryNO", "countryNP", "countryNZ", "countryOM", "countryPA", "countryPE", "countryPH", "countryPK", "countryPL", "countryPR", "countryPS", "countryPT", "countryPY", "countryQA", "countryRO", "countryRU", "countrySA", "countrySD", "countrySE", "countrySG", "countrySI", "countrySK", "countrySM", "countrySR", "countrySV", "countryTH", "countryTN", "countryTR", "countryTT", "countryTW", "countryTZ", "countryUA", "countryUG", "countryUK", "countryUS", "countryUY", "countryVA", "countryVE", "countryVG", "countryVI", "countryVN", "countryZA", "countryZM", "countryZW" ], "type": "string", "description": "Filters results to pages originating from a specific country only." }, "safe": { "title": "SafeSearch (safe)", "enum": [ "", "active" ], "type": "string", "description": "Send 'active' to filter adult content from search results." }, "nfpr": { "title": "Disable Spelling Correction (nfpr)", "type": "boolean", "description": "When true, disables Google's automatic spelling correction ('Did you mean...').", "default": false }, "filter": { "title": "Results Filter (filter)", "enum": [ "", "1", "0" ], "type": "string", "description": "Controls 'Similar Results' and 'Omitted Results' filters. Send '0' to disable filtering and show all results." }, "time_period": { "title": "Time Period", "enum": [ "", "last_hour", "last_day", "last_week", "last_month", "last_year" ], "type": "string", "description": "Time-based filter to restrict search results by recency." } } }, "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 } } } } } } } } } }