Bing

Check a site's Bing rank

Check where a site ranks in Bing's web results for a keyword, up to 100 results deep.

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

API key (`sfk_...`)

Parameters
6
querystringrequiredquery

The search to rank in, e.g. `marathon training plan`.

min 1 chars · max 500 chars

domainstringrequiredquery

The site to find, e.g. `halhigdon.com`. A URL is accepted and reduced to its host; `www.` and subdomains match too.

max 253 chars · pattern: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$

depthintegeroptionalquery

How many results to check, 10 to 100. Default: 50.

≥ 10 · ≤ 100

timestringoptionalquery

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

one of: day, week, month

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
26

Endpoint-specific response payload.

datalookupStatus
string

`found` when the site ranks within the depth checked; `not_found` when it does not.

one of: found, not_found

dataquery
string

The query that was searched.

datadomain
string

The site that was looked for.

datamarket
string

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

dataposition
integernullable

The site's best position, from 1; null when it was not found.

The site's best-ranked result; null when it was not found.

dataresultposition
integer

Rank in the web results, from 1.

dataresulttitle
string

Result title.

dataresulturl
string

The page the result links to.

dataresultdisplayUrl
stringnullable

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

dataresultsnippet
stringnullable

Text under the title.

dataresultdate
stringnullable

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

Every position of the site on the pages checked.

datapositions[]
integeroptional
datacheckedResults
integer

Results checked before the answer was settled.

datapagesChecked
integer

Result pages read.

dataexhausted
boolean

Whether Bing ran out of results before the depth.

datafeatured
boolean

Whether the site is linked from Bing's other blocks on the pages checked (an entity card, an answer, the summary's sources, the side panel). Those links are not ranked results, so they never set `position`.

datapartial
boolean

True when a results page could not be read in time, so fewer results than the depth were checked; `checkedResults` says how many were.

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/rank?query=marathon%20training%20plan&domain=halhigdon.com" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Where a site ranks for a query on Bing.