> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/bing>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/bing.mdx>

---

# Bing API. Search results as JSON.

Web and video results, where a site ranks and search suggestions, in any Bing market. One consistent shape and one credit per request.

- 4 endpoints
- 38 markets
- 1 credit per request

Social Fetch exposes 4 routes under `/v1/bing`. `GET /v1/bing/search` returns a page of web results with titles, links, shown addresses, snippets and dates, with sponsored results kept apart in `ads`, Bing's generated summary when it shows one, related searches, and a cursor for the next page. `GET /v1/bing/rank` checks where a site ranks for a query, reading up to 100 results deep and stopping at the first match. `GET /v1/bing/videos` searches Bing Videos, and `GET /v1/bing/search/suggest` completes a partial query.

A market is a country plus a language: `country=GB`, or `country=CH&language=fr`. Without a country the results are Bing's US English market (`en-US`). `time` limits web results, rank checks and videos to the past day, week or month.

Every response uses the `{ data, meta }` envelope. Web and video search page with `cursor`: pass `page.nextCursor` to get the next page. Web results go up to page 20, and `page.truncated` is true when a list stops before Bing's own end. A rank check that does not find the site answers `lookupStatus: not_found`, with how many results it checked.

## What you can get

- Web results with `position`, `title`, `url`, `displayUrl`, `snippet` and `date`, positions counting across pages, repeats dropped.
- Sponsored results apart in `ads`, with the advertiser's domain.
- Bing's generated summary, when it shows one, with the pages it cites, plus related searches and the estimated result count.
- Rank checks up to 100 results deep: the site's best `position`, the matching result and every position it holds.
- Videos with duration, views, publication date, publisher, uploader and thumbnail.
- Search suggestions for the start of a query, in any of 38 markets.

## Bing endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Web search | GET /v1/bing/search | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/bing/search/get) |
| Rank check | GET /v1/bing/rank | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/bing/rank/get) |
| Video search | GET /v1/bing/videos | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/bing/videos/get) |
| Search suggestions | GET /v1/bing/search/suggest | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/bing/search/suggest/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_...`). New accounts get 100 free credits, enough to try every Bing route.
2. **Pick the route and the market.** Use `GET /v1/bing/search?query=marathon%20training%20plan&country=GB` for web results, or `GET /v1/bing/rank?query=marathon%20training%20plan&domain=halhigdon.com` for a rank check. Send `x-api-key` on every request.
3. **Page and bill.** Follow `page.nextCursor` while `page.hasMore` is true (`page.truncated` says the list stopped before Bing's end), and read `meta.creditsCharged` for the charge.

## Pricing

Every Bing route charges one credit per completed request, shown on each endpoint page. A rank check is one request however deep it reads. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Social Fetch reads what Bing shows every visitor and returns it as one JSON shape, with markets, time windows and paging handled the same way on every route.

## FAQ

### Is there a Bing search API?

Yes. GET /v1/bing/search returns Bing's web results for a query as JSON: position, title, URL, shown address, snippet and date for each result, sponsored results apart, Bing's summary when it shows one, and a cursor for the next page. Authenticate with your Social Fetch API key in x-api-key.

### How does the rank check work?

GET /v1/bing/rank reads Bing's results for the query page by page until the site appears, the depth is reached (up to 100 results) or the results end. It returns the site's best position and result, and lookupStatus not_found with checkedResults when the site is not there. It costs one credit however many pages it reads.

### Which markets can I search?

Any of Bing's 38 markets, picked with country and, where a country has several, language: country=GB is the UK, country=CH&language=fr is Switzerland in French. A country Bing has no market for answers 400 and is not charged.

### Are ads mixed into the results?

No. Sponsored results are returned in ads with their title, the advertiser's domain, the address shown and the ad text. results holds only the web results, and positions count only those.

### Does it include Bing's generated summary?

Yes. When Bing shows a generated summary above the results, summary holds its text and the pages it cites. It is null when Bing shows none.

### Can I page through videos?

Yes. Each page holds about 90 videos, a few more on the first; pass page.nextCursor as cursor for the next one.

### How much does the Bing API cost?

Every Bing route charges one credit per completed request, and each page of results is billed separately. Read meta.creditsCharged on every response. New accounts start with 100 free credits.

### Can I use the Bing routes from agents or MCP?

Yes. Every Bing route is a typed MCP tool and is reachable through Ask (POST /v1/ask) in plain English. Use the typed routes for production jobs.

## Related

- [Bing Search API](https://www.socialfetch.dev/platforms/bing/search): Web results with paging, ads apart and Bing's summary (`GET /v1/bing/search`).
- [Bing Rank Checker API](https://www.socialfetch.dev/platforms/bing/rank): Where a site ranks, up to 100 deep (`GET /v1/bing/rank`).
- [Bing Videos API](https://www.socialfetch.dev/platforms/bing/videos): Video results for a query (`GET /v1/bing/videos`).
- [Bing Search Suggestions API](https://www.socialfetch.dev/platforms/bing/search-suggest): Suggestions for a partial query (`GET /v1/bing/search/suggest`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language Bing question to the matching operation.
