Read Bing’s results for a query as JSON, check where your site ranks for the queries you care about, then widen the research with suggestions, news and videos.

1. Get your API key

Create an account and generate a FetchLayer API key from your dashboard. There is no Microsoft account, Azure subscription or Bing API key involved.

Create free account →

2. Search

Every organic result comes back with its position, title, URL, site name, snippet, date and sitelinks, with what Bing showed alongside: the answer box or AI overview with its sources, the knowledge panel, People also ask questions, related searches, top stories and videos. Ads come back separately and never take a position.

bash

curl -X POST https://api.fetchlayer.dev/bing/search \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"open source crm","limit":10}'

Going deeper

A limit above 10 reads more result pages — up to 200 results — and each page read counts as one request (pagesScraped). To continue later, send nextCursor back as cursor with the same query and filters.

3. Check where your site ranks

For SEO rank tracking, don’t page through search yourself. /rank-check scans up to 200 positions for a domain or a URL prefix and returns whether it was found, its best position, and every match with the page it was on.

bash

curl -X POST https://api.fetchlayer.dev/bing/rank-check \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"reddit api","target":"fetchlayer.dev","depth":200}'

One credit at any depth

A rank check costs 1 credit regardless of depth: scanning 200 positions across 10 or more result pages is billed as one request. serpPagesFetched reports how many result pages were read and is never billed. A 200-position check typically takes around 30 seconds.

Rankings depend on the searcher

Results reflect an en-US searcher (market: "en-US") on desktop unless you set a market or device, and the same query ranks differently in en-GB or de-DE. Bing’s positions also move noticeably between regions and even between two checks minutes apart, so track a query over time rather than reading one check as fixed.

By default the scan stops after the first result page that contains a match. Set allMatches to scan the full depth and see every page of yours that ranks. found: false always means the whole depth was examined.

4. Expand the research

/suggestions returns what Bing’s search box offers for a partial query — the queries worth tracking next. /news searches Bing News with a time range down to the past hour, and /videos searches Bing Videos (without a time filter).

bash

curl -X POST https://api.fetchlayer.dev/bing/news \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"openai","limit":10,"timeRange":"day"}'

Tip

Already have a Bing link? Send it to /resolve-url — it returns the query, market, safe search, time range and offset the URL carries, or where a result link leads, without contacting Bing, and it does not consume a credit.

Errors and retries

A 400 names the field to fix. Unrecognised fields are rejected rather than ignored — and /suggestions takes a market but nothing else, while /videos takes no time range. A 503 means Bing could not be read within the time allowed; it is always worth retrying, and a rank check never reports “not found” in its place. A search that matches nothing is a 200 with an empty list. Read notes on every successful response too.

Next steps

On this page