{
"openapi": "3.0.1",
"info": {
"title": "Multi-Engine SERP Scraper — Google, Bing, Yahoo, Yandex, Baidu",
"description": "Multi-engine SERP scraper: Google, Bing, Yahoo, DuckDuckGo, Ecosia, Yandex and Baidu in one run. Built for rank tracking and SERP comparison. Flat JSON row per result: title, URL, snippet, rank, page, engine, total results. Per-engine language/region and pagination. No API keys, no login.",
"version": "0.1",
"x-build-id": "76TqPrhVHZwaKKbN9"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/nomad-agent~serp-multi-engine-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-nomad-agent-serp-multi-engine-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/nomad-agent~serp-multi-engine-scraper/runs": {
"post": {
"operationId": "runs-sync-nomad-agent-serp-multi-engine-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/nomad-agent~serp-multi-engine-scraper/run-sync": {
"post": {
"operationId": "run-sync-nomad-agent-serp-multi-engine-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": "Search queries",
"type": "array",
"description": "Search queries to run, one per entry. Search operators like site: and filetype: work inline (e.g. annual report filetype:pdf site:example.com).",
"items": {
"type": "string"
}
},
"engines": {
"title": "Search engines",
"type": "array",
"description": "Engines to query. Each result row is tagged with its engine. Bing, DuckDuckGo, Baidu and Yahoo are the most reliable from datacenter IPs; Google, Ecosia and Yandex may serve captchas without residential proxies (blocked engines are logged and skipped, never fail the run).",
"items": {
"type": "string",
"enum": [
"google",
"bing",
"yahoo",
"duckduckgo",
"ecosia",
"yandex",
"baidu"
],
"enumTitles": [
"Google",
"Bing",
"Yahoo",
"DuckDuckGo",
"Ecosia",
"Yandex",
"Baidu"
]
},
"default": [
"bing",
"duckduckgo"
]
},
"device": {
"title": "Device",
"enum": [
"desktop",
"mobile"
],
"type": "string",
"description": "Search as a desktop or mobile browser. Only Google and Bing actually change their response based on this (Bing: a mobile signal also helps avoid its bot-block page). Other engines accept the field but ignore it — see the Device support table in the README.",
"default": "desktop"
},
"languageCode": {
"title": "Language code",
"type": "string",
"description": "BCP-47 language code, e.g. en, de, pt-BR. Mapped per engine: Google hl/gl/lr, Bing mkt/setlang/cc, DuckDuckGo kl, Yandex lang: operator, Yahoo vl. Baidu and Ecosia do not take a language param."
},
"region": {
"title": "Region / country",
"type": "string",
"description": "Country hint. Two-letter code for Google (gl) and Bing (cc), e.g. de, gb. For Yandex pass a numeric lr region id (e.g. 213 = Moscow). Ignored by engines without a region param."
},
"maxPagesPerQuery": {
"title": "Max pages per query",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "SERP pages to fetch per query per engine. Pagination uses each engine's native offset param (Google start, Bing first, DuckDuckGo s, Ecosia p, Yandex p, Baidu pn, Yahoo b). Stops early when a page is empty or blocked.",
"default": 1
},
"resultsPerPage": {
"title": "Results per page",
"minimum": 0,
"maximum": 50,
"type": "integer",
"description": "Results requested per page where the engine supports it (Google num, Bing count, Baidu rn, Yahoo n). 0 = engine default (~10, DuckDuckGo ~25).",
"default": 0
},
"maxItems": {
"title": "Max items",
"minimum": 0,
"maximum": 1000,
"type": "integer",
"description": "Hard cap on total results pushed across all queries and engines. Each result returned is billed as one dataset item — see Pricing in the README. 0 = no cap (costs then scale with queries × engines × pages; use with care).",
"default": 100
},
"includeAds": {
"title": "Include ads",
"type": "boolean",
"description": "Include sponsored/ad results (marked with ad: true). Off = organic results only.",
"default": false
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional proxy. Bing, DuckDuckGo, Baidu and Yahoo usually work without one. Google, Ecosia and Yandex serve captchas to datacenter IPs — use Apify residential proxy to unlock them."
},
"concurrency": {
"title": "Concurrency",
"minimum": 1,
"maximum": 8,
"type": "integer",
"description": "How many searches to run at the same time. Higher is faster but more likely to get rate-limited or blocked by a search engine. Extra pages within a single search are always fetched one at a time with a short delay between them, regardless of this setting.",
"default": 4
}
}
},
"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
}
}
}
}
}
}
}
}
}
}