# Bing Rank API (https://www.socialcrawl.dev/platforms/bing/rank)

> Returns whether a domain or a URL path ranks on Bing for a search, its best position, and every matching result with its position, link, title and page, scanning up to 200 positions in one call.

TL;DR: `GET /v1/bing/rank` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | The search to check, for example best running shoes. |
| `url` | yes | The site to look for: a domain (example.com, matching its subdomains) or a URL with a path (example.com/blog, matching pages under it). |
| `market` | no | Bing market, for example en-US, en-GB, de-DE or ja-JP (38 in all). Default en-US. |
| `country` | no | Two-letter country, only when it should differ from the market's. |
| `language` | no | Language code such as en or de, only when it should differ from the market's. |
| `safe_search` | no | strict, moderate or off. (strict \| moderate \| off) |
| `time_range` | no | any, day, week, month or year: only pages published or updated within it. (any \| day \| week \| month \| year) |
| `device` | no | desktop or mobile: which results page to read. (desktop \| mobile) |
| `depth` | no | Organic positions to scan, 1 to 200. Default 100. One call at any depth. |
| `all_matches` | no | true to scan the whole depth and report every matching position. Default false (stop at the first results page with a match). |
| `include_subdomains` | no | false to count only the exact domain. Default true. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/bing/rank" \
  --data-urlencode "query=best running shoes" \
  --data-urlencode "url=runnersworld.com" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I check a ranking on Bing?

Call GET /v1/bing/rank with query set to the search and url set to a domain such as example.com or a URL path such as example.com/blog. It returns whether you rank, your best position, and every matching result with its position, link, title and page.

### How deep does the rank check scan?

Up to 200 positions in one call. depth sets how many organic positions to scan and defaults to 100, and one call costs the same at any depth.

### What do all_matches and include_subdomains change?

all_matches set to true scans the whole depth and reports every matching position, while the default stops at the first results page with a match. include_subdomains set to false counts only the exact domain, and it defaults to true.

### Which Bing market and filters can I set?

market takes a Bing market such as en-US, en-GB, de-DE or ja-JP (38 in all) and defaults to en-US. country and language apply only when they should differ from the market's, safe_search takes strict, moderate or off, and device takes desktop or mobile.

### How much does this Bing endpoint cost?

Each call costs 5 credits on the advanced tier. There is no subscription, and 100 free credits cover 20 calls.

See the full Bing API: https://www.socialcrawl.dev/platforms/bing

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I track my Bing ranking with an API?
- Can I check where a domain ranks on Bing for a keyword?