{
  "openapi": "3.0.1",
  "info": {
    "title": "Bing Search Scraper",
    "description": "Scrape Bing search results — organic results, paid ads, related queries, People Also Ask, news, videos, and the entity/knowledge card. Filter by market, country, language, safe search, and freshness. Decodes Bing /ck/a tracking redirects to canonical URLs.",
    "version": "1.0",
    "x-build-id": "Jh8buRjBmitO25mHS"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~bing-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-bing-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/memo23~bing-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-bing-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/memo23~bing-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-bing-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": "Search queries",
            "type": "array",
            "description": "One or more search queries. Each query produces one or more SERP rows (one row per page).",
            "items": {
              "type": "string"
            }
          },
          "resultsPerPage": {
            "title": "Results per page",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many organic results to request per SERP page (Bing's count parameter). Bing honors up to ~50, but caps the rendered page near 10-30 in practice.",
            "default": 10
          },
          "maxPagesPerQuery": {
            "title": "Max pages per query",
            "minimum": 1,
            "type": "integer",
            "description": "Paginate through this many SERP pages per query.",
            "default": 1
          },
          "market": {
            "title": "Market (mkt)",
            "type": "string",
            "description": "Bing market code, e.g. en-US, en-GB, de-DE, fr-FR. The cleanest geo + language selector — takes precedence over Country / Language when set."
          },
          "countryCode": {
            "title": "Country code (cc)",
            "type": "string",
            "description": "Two-letter country code, e.g. US, GB, DE. Used when no market is set.",
            "default": "US"
          },
          "languageCode": {
            "title": "UI language (setLang)",
            "type": "string",
            "description": "BCP-47 language tag for the Bing UI, e.g. en-US, de-DE. Used when no market is set.",
            "default": "en-US"
          },
          "safeSearch": {
            "title": "Safe search",
            "enum": [
              "off",
              "moderate",
              "strict"
            ],
            "type": "string",
            "description": "Bing SafeSearch level.",
            "default": "off"
          },
          "freshness": {
            "title": "Freshness filter",
            "enum": [
              "Day",
              "Week",
              "Month"
            ],
            "type": "string",
            "description": "Limit results by recency. Maps to Bing's filters=ex1:\"ezN\"."
          },
          "includeAds": {
            "title": "Include paid ads",
            "type": "boolean",
            "description": "Parse and return sponsored (Ad) results alongside organic.",
            "default": true
          },
          "includeRelated": {
            "title": "Include related searches",
            "type": "boolean",
            "description": "Include the 'Related searches' box.",
            "default": true
          },
          "includePeopleAlsoAsk": {
            "title": "Include People Also Ask",
            "type": "boolean",
            "description": "Include the 'People also ask' Q&A box.",
            "default": true
          },
          "includeNews": {
            "title": "Include news results",
            "type": "boolean",
            "description": "Include the in-SERP news block.",
            "default": true
          },
          "includeVideos": {
            "title": "Include video results",
            "type": "boolean",
            "description": "Include the in-SERP videos block.",
            "default": true
          },
          "includeKnowledgePanel": {
            "title": "Include knowledge / entity card",
            "type": "boolean",
            "description": "Parse Bing's entity card (the 'answer' block with title, description, facts, image).",
            "default": true
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "type": "integer",
            "description": "How many query-pages to process in parallel.",
            "default": 5
          },
          "maxRequestRetries": {
            "title": "Max request retries",
            "minimum": 0,
            "type": "integer",
            "description": "Retries per SERP page request when soft-blocked (rotates to a fresh proxy exit).",
            "default": 5
          },
          "useBrowser": {
            "title": "Use headless browser (full SERP features)",
            "type": "boolean",
            "description": "Render each SERP in a headless Chromium to capture AJAX-loaded features — ads, People Also Ask, related searches, news, videos, and the knowledge panel. Bing only server-renders organic results over plain HTTP, so the default (off) returns organic + total count only. Turn this on for the full SERP feature surface. Slower per page.",
            "default": false
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify RESIDENTIAL proxy is strongly recommended — Bing soft-blocks datacenter IPs by returning an empty 'no results' page. Defaults to Apify residential.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          },
          "site": {
            "title": "Site (site: operator)",
            "type": "string",
            "description": "Limit results to one site, e.g. example.com (applies Bing's site: operator)."
          },
          "fileTypes": {
            "title": "File types (ext: operator)",
            "type": "array",
            "description": "Restrict to file types, OR-combined (e.g. pdf, docx). Applies Bing's ext: operator.",
            "items": {
              "type": "string"
            }
          },
          "forceExactMatch": {
            "title": "Force exact match",
            "type": "boolean",
            "description": "Wrap the query in quotes for an exact-phrase match.",
            "default": false
          },
          "saveHtml": {
            "title": "Save HTML to dataset",
            "type": "boolean",
            "description": "Attach the raw SERP HTML to each dataset row under html. Makes the dataset large — use for debugging.",
            "default": false
          },
          "saveHtmlToKeyValueStore": {
            "title": "Save HTML to key-value store",
            "type": "boolean",
            "description": "Save each SERP's raw HTML to the key-value store and add a htmlSnapshotUrl to the dataset row.",
            "default": false
          },
          "enrichEmails": {
            "title": "Enrich results with contact emails",
            "type": "boolean",
            "description": "Opt-in, best-effort lead enrichment: for the top business domains in each SERP, scrape the result's OWN site for contact emails and people. Adds contactEmail + emailEnrichment to those organic results. Skips non-business domains (search/social/Wikipedia/marketplaces). Best on business-intent queries (e.g. 'plumbers chicago', 'B2B SaaS vendors').",
            "default": false
          },
          "qualifyByPayment": {
            "title": "Qualify by payment (flag businesses that take money online)",
            "type": "boolean",
            "description": "Requires 'Enrich with contact emails'. Scans each business's website — reusing the pages already fetched for email discovery, so no extra cost or time — for payment processors and e-commerce platforms (Stripe, Shopify, PayPal, Paddle, Lemon Squeezy, WooCommerce, Square, Chargebee and more). Adds takesPayments, paymentProcessors, stripeLiveKey and paymentConfidence. Turn raw contacts into monetization-qualified leads. No extra charge — included with each enriched company.",
            "default": false
          },
          "maxEnrichedDomainsPerPage": {
            "title": "Max enriched domains per page",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Cap how many unique business domains to enrich per SERP page (bounds cost/time). Only applies when 'Enrich results with contact emails' is on.",
            "default": 3
          },
          "perplexitySearch": {
            "title": "Add a Perplexity AI answer",
            "type": "boolean",
            "description": "Also fetch a Perplexity (Sonar) AI answer per query, attached to the page-1 row as perplexity. Bring your own Perplexity API key below — you are billed by Perplexity per request.",
            "default": false
          },
          "perplexityApiKey": {
            "title": "Perplexity API key",
            "type": "string",
            "description": "Your Perplexity API key (from docs.perplexity.ai). Required for the Perplexity answer; runs are billed to YOUR Perplexity account. Leave blank to disable."
          },
          "perplexitySearchRecency": {
            "title": "Perplexity recency filter",
            "enum": [
              "day",
              "week",
              "month",
              "year"
            ],
            "type": "string",
            "description": "Restrict Perplexity's web grounding to recent content."
          },
          "perplexityRelatedQuestions": {
            "title": "Perplexity related questions",
            "type": "boolean",
            "description": "Ask Perplexity to also return follow-up questions.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}