Skip to main content
GET
/
bing
/
search
Bing Search
curl --request GET \
  --url https://api.example.com/bing/search

​
Overview

The /bing/search endpoint executes a Bing search query and returns structured, parsed results. This API handles anti-bot measures and provides clean data extraction from Bing’s search results.

​
Parameters

​
Query Parameters

​
q
string
required
The search query
​
mkt
string
default:"en-US"
Market code in language-country format (e.g., en-US, en-GB, de-DE, fr-FR)
​
cc
string
Country code to limit results (e.g., US, GB, DE)
​
setLang
string
default:"en"
UI language code (e.g., en, es, fr, de)
​
count
number
default:"10"
Number of results to return (1-50)
​
offset
number
default:"0"
Offset for pagination (e.g., 0 for first page, 10 for second)
​
device
string
default:"desktop"
Device type to emulate. Options: desktop, mobile, tablet
​
location
string
Location for geo-targeted results (e.g., New York, USA)
​
safeSearch
string
default:"Moderate"
Safe search mode. Options: Off, Moderate, Strict
​
freshness
string
Time filter for results. Options: Day, Week, Month
​
responseFilter
string
Filter response type. Options: Webpages, Images, Videos, News
​
textDecorations
boolean
default:"false"
Add bold markers around search terms in snippets
​
textFormat
string
default:"Raw"
Text format for snippets. Options: Raw, HTML
​
rawHtml
boolean
default:"false"
Return raw HTML instead of parsed results
​
async
boolean
default:"false"
Async mode - returns job ID immediately for later retrieval

​
Example Requests

curl -X GET "https://api.scrapengine.io/api/v1/bing/search?q=artificial%20intelligence&count=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
News Search with Freshness Filter

curl -X GET "https://api.scrapengine.io/api/v1/bing/search?q=technology&responseFilter=News&freshness=Day" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.scrapengine.io/api/v1/bing/search?q=restaurants&mkt=de-DE&cc=DE&location=Berlin" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
Success Response (200)

Returns parsed search results: 
{
  "searchInformation": {
    "totalEstimatedMatches": 25400000,
    "searchTime": 0.32
  },
  "webPages": [
    {
      "position": 1,
      "title": "What is Artificial Intelligence (AI)? | IBM",
      "url": "https://www.ibm.com/topics/artificial-intelligence",
      "displayUrl": "www.ibm.com › topics › artificial-intelligence",
      "snippet": "Artificial intelligence (AI) is technology that enables computers and machines to simulate human intelligence...",
      "datePublished": "2024-01-15"
    },
    {
      "position": 2,
      "title": "Artificial Intelligence - MIT Technology Review",
      "url": "https://www.technologyreview.com/artificial-intelligence/",
      "displayUrl": "www.technologyreview.com › artificial-intelligence",
      "snippet": "Coverage of artificial intelligence and machine learning from MIT Technology Review..."
    }
  ],
  "relatedSearches": [
    {
      "text": "artificial intelligence examples",
      "displayText": "AI examples"
    },
    {
      "text": "artificial intelligence jobs",
      "displayText": "AI jobs"
    }
  ],
  "pagination": {
    "currentOffset": 0,
    "nextOffset": 10,
    "totalEstimatedMatches": 25400000
  }
}

​
Response Headers

HeaderDescription
x-remaining-creditsNumber of API credits remaining
x-trace-idUnique identifier for the request

​
Error Responses

StatusDescription
400Bad Request - Invalid query parameters
401Unauthorized - Invalid or missing API key
429Too Many Requests - Rate limit exceeded
500Internal Server Error

​
Use Cases

  • Alternative search data: Get search results from Bing as an alternative to Google
  • SEO research: Compare rankings across different search engines
  • Market research: Analyze search trends on Bing’s platform
  • News aggregation: Collect news articles from Bing News
  • Image search: Find images using Bing’s image search
  • Video discovery: Search for videos across the web