{ "openapi": "3.0.1", "info": { "title": "Bing Search API | SERP, Rank Tracking and Ads Data", "description": "Bing Search API for SERP data and Bing rank tracking. Returns organic results with titles, snippets, real URLs and dates, plus ad placements for competitor monitoring. Works as a Bing scraper billed per page rather than per result, so a thin page never costs more than it is worth. MCP ready.", "version": "0.0", "x-build-id": "91saaLWHmxqc6m25l" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~bing-search-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-bing-search-api", "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/johnvc~bing-search-api/runs": { "post": { "operationId": "runs-sync-johnvc-bing-search-api", "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/johnvc~bing-search-api/run-sync": { "post": { "operationId": "run-sync-johnvc-bing-search-api", "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": [ "query" ], "properties": { "query": { "title": "Search query", "type": "string", "description": "REQUIRED. The term to search Bing for. Supports Bing operators such as site:, filetype:, OR and NOT, so 'site:example.com pricing' works as you would expect." }, "max_pages": { "title": "Pages to fetch", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages of results to fetch. This is the billing unit: you are charged once per page, whatever that page happens to contain. Bing typically returns about 10 organic results per page, but commercial queries return far fewer because ads take the space.", "default": 1 }, "include_ads": { "title": "Include ad placements", "type": "boolean", "description": "Also return the paid placements on each page, marked with resultType 'ad'. Useful for competitor ad monitoring. Ads are already on the page you paid for, so switching this on costs nothing extra.", "default": false }, "country": { "title": "Country", "type": "string", "description": "Optional two letter country code such as us, gb or de. Cannot be combined with Market; if you set both, Market wins." }, "market": { "title": "Market", "type": "string", "description": "Optional language and country pair such as en-US or de-DE. More precise than Country because it sets the result language too. Cannot be combined with Country." }, "location": { "title": "Location", "type": "string", "description": "Optional city to search from, such as 'Seattle, Washington'. Use it for local rank tracking. Give it at city level for realistic results." }, "safe_search": { "title": "Safe search", "enum": [ "Moderate", "Strict", "Off" ], "type": "string", "description": "Optional adult content filter. Moderate filters adult text only, Strict removes adult content entirely, Off applies no filter.", "default": "Moderate" }, "device": { "title": "Device", "enum": [ "desktop", "mobile", "tablet" ], "type": "string", "description": "Optional device to emulate. Rankings differ between desktop and mobile, so pick the one you actually want to track.", "default": "desktop" } } }, "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 } } } } } } } } } }