Bing

Search Bing

Search Bing's web results by keyword, market and time, with ads, the summary Bing shows and related searches apart, and cursor paging.

GET/v1/bing/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
querystringrequiredquery

What to search for, e.g. `marathon training plan`. Bing often answers a search with operators such as `site:` only in a reduced layout that ignores them; such a search fails with `query_unreadable` and is not charged.

min 1 chars · max 500 chars

timestringoptionalquery

Only results from the past `day`, `week` or `month`. Default: any time.

one of: day, week, month

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page.

min 1 chars · max 4096 chars

countrystringoptionalquery

Two-letter country code of the results' market, e.g. `GB` or `DE`. Default: `US`.

pattern: ^[A-Z]{2}$

languagestringoptionalquery

Two-letter language code for a country with several, e.g. `fr` with `CH`. Default: the market's first language.

pattern: ^[a-z]{2}$

Response fields
35

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no match is an empty list.

one of: found, not_found

dataquery
string

The query that was searched.

datamarket
string

Bing's market the results are for, e.g. `en-US`.

datapageNumber
integer

This page's number, from 1.

datatotalResults
integernullable

Bing's estimate of how many results there are, where shown.

Web results. Bing gives part of its first page to answers, news and videos, so page 1 often has fewer than 10. A result already returned on an earlier page is left out.

dataresults[]position
integer

Rank in the web results, from 1.

dataresults[]title
string

Result title.

dataresults[]url
string

The page the result links to.

dataresults[]displayUrl
stringnullable

The address as Bing shows it, e.g. `https://www.rei.com › learn`.

dataresults[]snippet
stringnullable

Text under the title.

dataresults[]date
stringnullable

The date Bing shows before the snippet, e.g. `Oct 31, 2026`.

Sponsored results shown with this page.

dataads[]title
string

Ad title.

dataads[]domain
stringnullable

The advertiser's domain.

dataads[]displayUrl
stringnullable

The address the ad shows.

dataads[]snippet
stringnullable

Ad text.

The generated summary above the results, when Bing shows one.

datasummarytext
string

The summary as Bing shows it, as plain text.

The pages the summary cites.

datasummarysources[]title
string

The source's name, e.g. `GearLab`.

datasummarysources[]url
stringnullable

The source page.

Related searches Bing suggests on this page.

datarelatedSearches[]text
string

A related search.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

datapagetruncated
boolean

True when the list stops here before Bing's own end: the deepest page we read, or a later page Bing kept answering empty.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/bing/search?query=best%20hiking%20boots" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A page of Bing web results, sponsored results, the summary Bing shows and related searches.