# Bing API

> Bing returns web results, news articles, and Copilot answers as a workflow and API.

Bing returns web pages, snippets, answer-box text, and related searches through Search web; it needs a query. Search news returns article details and publication times; it needs a query. Get copilot answer returns an AI-written answer when available and cited sources; it needs a question.

- Page: https://fous.com/tools/bing
- Handle: `@bing`
- Category: [Search](https://fous.com/tools/category/search)
- Source website: https://bing.com
- Last verified: Sep 29, 2026

## Methods

### Get copilot answer

Operation `get_copilot_answer`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get Bing Copilot Search's AI-written answer and cited sources for a question. Some questions may not receive an AI answer.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `country` | string | no | `"United Kingdom"` | Country name or two-letter code, for example: United States or US. |
| `question` | string | yes | `"How do plants turn sunlight into sugar?"` | Question to ask, for example: What changed in the 2026 US tax brackets? |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "question"
  ],
  "properties": {
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code, for example: United States or US.",
      "examples": [
        "United Kingdom",
        "US"
      ]
    },
    "question": {
      "type": "string",
      "description": "Question to ask, for example: What changed in the 2026 US tax brackets?",
      "examples": [
        "How do plants turn sunlight into sugar?",
        "What changed in the 2026 US tax brackets?",
        "What is the capital of France?"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "country": "United Kingdom",
      "question": "How do plants turn sunlight into sugar?"
    },
    {
      "country": "US",
      "question": "What changed in the 2026 US tax brackets?"
    },
    {
      "question": "What is the capital of France?"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `sources` | array |  | Cited sources in displayed order. |
| `sources[].link` | string | `"https://scienceinsights.org/how-plant-photosynthesis-works-from-sunlight-to-sugar/"` |  |
| `sources[].title` | string or null | `"How Plant Photosynthesis Works: From Sunlight to Sugar"` |  |
| `sources[].website_name` | string or null | `"scienceinsights.org"` |  |
| `has_answer` | string | `"yes"` | Whether an AI-written answer appeared. |
| `answer_text` | string or null |  | AI-written answer as paragraphs and bullet lines, or null. |

**Example input**

```json
{
  "country": "United Kingdom",
  "question": "How do plants turn sunlight into sugar?"
}
```

**Example output**

```json
{
  "sources": [
    {
      "link": "https://scienceinsights.org/how-plant-photosynthesis-works-from-sunlight-to-sugar/",
      "title": "How Plant Photosynthesis Works: From Sunlight to Sugar",
      "website_name": "scienceinsights.org"
    },
    {
      "link": "https://shuncy.com/article/how-plants-use-sunlight-to-make-sugar",
      "title": "How Plants Turn Sunlight Into Sugar Through Photosynthesis",
      "website_name": "ShunCy"
    },
    {
      "link": "https://scienceinsights.org/how-photosynthesis-works-from-sunlight-to-sugar/",
      "title": "How Photosynthesis Works: From Sunlight to Sugar",
      "website_name": "scienceinsights.org"
    }
  ],
  "has_answer": "yes",
  "answer_text": "Plants convert sunlight into sugar through the process of photosynthesis, where light energy is used to produce glucose from carbon dioxide and water.\nOverview of Photosynthesis\nPhotosynthesis is the …"
}
```

### Search news

Operation `search_news`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find recent Bing News articles about a topic in Bing’s displayed order. Relative publication times are approximate; date-only labels are shown at midnight UTC. Images may be missing.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `query` | string | yes | `"climate change"` | News topic to search for, such as electric vehicle tariffs. |
| `country` | string | no | `"GB"` | Country name or two-letter code for localized results, such as United States or GB. |
| `freshness` | string | no | `"past_week"` | How recent articles should be, such as past_day. |
| `max_results` | integer | no | `30` | Maximum number of articles to return, such as 20 (up to 100). |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "News topic to search for, such as electric vehicle tariffs.",
      "examples": [
        "climate change",
        "Tesla",
        "electric vehicle tariffs"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code for localized results, such as United States or GB.",
      "examples": [
        "GB",
        "United States",
        "Canada"
      ]
    },
    "freshness": {
      "enum": [
        "any",
        "past_hour",
        "past_day",
        "past_week"
      ],
      "type": "string",
      "default": "any",
      "description": "How recent articles should be, such as past_day.",
      "examples": [
        "past_week",
        "past_day",
        "past_hour"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of articles to return, such as 20 (up to 100).",
      "x-fous-developer": true,
      "examples": [
        30,
        20,
        50
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "climate change",
      "country": "GB",
      "freshness": "past_week",
      "max_results": 30
    },
    {
      "query": "Tesla",
      "country": "United States",
      "freshness": "past_day",
      "max_results": 20
    },
    {
      "query": "electric vehicle tariffs",
      "country": "Canada",
      "freshness": "past_hour",
      "max_results": 20
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `articles` | array |  |  |
| `articles[].snippet` | string or null | `"Justice Samuel A. Alito Jr. had faced pressure to recuse himself from the climate case because he owns stock in oil com` | Article preview. |
| `articles[].headline` | string | `"Justice Alito Recuses Himself Days Before Major Climate-Change Case"` | Article headline. |
| `articles[].publisher` | string or null | `"The New York Times"` | Publisher name. |
| `articles[].image_link` | string or null | `"https://th.bing.com/th?id=ONUT.wrSHGT5kS9bfp5bpBPy9-g&pid=News&w=234&h=132&c=14&rs=2&qlt=90"` | News image link. |
| `articles[].article_link` | string | `"https://www.nytimes.com/2026/09/28/us/politics/alito-suncor-supreme-court-recuse.html"` | Article page link. |
| `articles[].published_at` | string or null | `"2026-09-28T22:22:26+00:00"` | Publication time converted from Bing’s displayed date, in ISO 8601 with offset. |

**Example input**

```json
{
  "query": "climate change",
  "country": "GB",
  "freshness": "past_week",
  "max_results": 30
}
```

**Example output**

```json
{
  "articles": [
    {
      "snippet": "Justice Samuel A. Alito Jr. had faced pressure to recuse himself from the climate case because he owns stock in oil companies ...",
      "headline": "Justice Alito Recuses Himself Days Before Major Climate-Change Case",
      "publisher": "The New York Times",
      "image_link": "https://th.bing.com/th?id=ONUT.wrSHGT5kS9bfp5bpBPy9-g&pid=News&w=234&h=132&c=14&rs=2&qlt=90",
      "article_link": "https://www.nytimes.com/2026/09/28/us/politics/alito-suncor-supreme-court-recuse.html",
      "published_at": "2026-09-28T22:22:26+00:00"
    },
    {
      "snippet": "In a short letter, the court said Alito will not participate in consideration of Suncor v. Boulder County Commissioners, a case that could determine whether states and local governments across the ...",
      "headline": "Alito will not participate in pivotal climate change case",
      "publisher": "Yahoo",
      "image_link": null,
      "article_link": "https://www.yahoo.com/news/politics/articles/alito-not-participate-pivotal-climate-200900829.html",
      "published_at": "2026-09-28T20:22:26+00:00"
    },
    {
      "snippet": "The Supreme Court will soon hear arguments in the major climate change lawsuit between two energy companies and the city and ...",
      "headline": "Alito recuses from major climate change case to be decided by the Supreme Court",
      "publisher": "CBS News on MSN",
      "image_link": "https://th.bing.com/th?id=ORMS.4750bf944cbade3bc8a9bd453beab340&pid=News&w=234&h=132&c=14&rs=2&qlt=90",
      "article_link": "https://www.msn.com/en-us/news/other/alito-recuses-from-major-climate-change-case-to-be-decided-by-the-supreme-court/ar-AA2d8BFY?ocid=BingNewsVerp",
      "published_at": "2026-09-28T20:22:26+00:00"
    }
  ]
}
```

### Search web

Operation `search_web`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Search Bing for web pages in the order shown, with snippets, answer-box text when available, and related searches. Bing may repeat or omit later pages.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `query` | string | yes | `"project management software for nonprofits"` | Question or search words, for example project management software for nonprofits. |
| `country` | string | no | `"Canada"` | Country name or two-letter code for search results, for example Canada or CA. |
| `freshness` | string | no | `"past_week"` | How recent results should be, for example past_week. |
| `max_results` | integer | no | `15` | Maximum number of regular results to return, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Question or search words, for example project management software for nonprofits.",
      "examples": [
        "project management software for nonprofits",
        "coffee brewing methods",
        "NASA Artemis news"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code for search results, for example Canada or CA.",
      "examples": [
        "Canada"
      ]
    },
    "freshness": {
      "enum": [
        "any",
        "past_day",
        "past_week",
        "past_month"
      ],
      "type": "string",
      "default": "any",
      "description": "How recent results should be, for example past_week.",
      "examples": [
        "past_week"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of regular results to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        15,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "project management software for nonprofits"
    },
    {
      "query": "coffee brewing methods",
      "max_results": 15
    },
    {
      "query": "NASA Artemis news",
      "country": "Canada",
      "freshness": "past_week",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `results` | array |  | Regular web results in displayed order, excluding ads. |
| `results[].link` | string | `"https://support.microsoft.com/en-us/project/install-project"` | Page link. |
| `results[].snippet` | string or null | `"Project Online Professional or Project Online Premium: If you have a subscription to one of the cloud-based solutions o` | Short description from Bing. |
| `results[].position` | integer | `1` | Position in the search results. |
| `results[].page_title` | string | `"Install Project \| Microsoft Support"` | Page title. |
| `results[].website_name` | string | `"microsoft.com"` | Website name. |
| `answer_box_text` | string or null |  | Answer-box text, or null if none appears. |
| `related_searches` | array |  | Related searches shown by Bing. |

**Example input**

```json
{
  "query": "project management software for nonprofits"
}
```

**Example output**

```json
{
  "results": [
    {
      "link": "https://support.microsoft.com/en-us/project/install-project",
      "snippet": "Project Online Professional or Project Online Premium: If you have a subscription to one of the cloud-based solutions of Project you …",
      "position": 1,
      "page_title": "Install Project | Microsoft Support",
      "website_name": "microsoft.com"
    },
    {
      "link": "https://support.microsoft.com/es-es/project/install-project",
      "snippet": "Project Online Professional o Project Online Premium: Si tiene una suscripción a una de las soluciones basadas en la nube de …",
      "position": 2,
      "page_title": "Instalación de Project | Microsoft Support",
      "website_name": "microsoft.com"
    },
    {
      "link": "https://support.microsoft.com/en-us/project/project-for-the-web-and-project-online",
      "snippet": "Note Microsoft Project for the web will soon become Microsoft Planner. You can continue using most of the Project for the web …",
      "position": 3,
      "page_title": "Project for the web and Project Online | Microsoft Support",
      "website_name": "microsoft.com"
    }
  ],
  "answer_box_text": null,
  "related_searches": []
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@bing",
  "visibility": "public",
  "operation": "get_copilot_answer",
  "version": 1,
  "input": {
    "country": "United Kingdom",
    "question": "How do plants turn sunlight into sugar?"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@bing\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_copilot_answer\",\n  \"version\": 1,\n  \"input\": {\n    \"country\": \"United Kingdom\",\n    \"question\": \"How do plants turn sunlight into sugar?\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@bing",
  "visibility": "public",
  "operation": "get_copilot_answer",
  "version": 1,
  "input": {
    "country": "United Kingdom",
    "question": "How do plants turn sunlight into sugar?"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/bing`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_copilot_answer`: Get copilot answer. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_news`: Search news. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_web`: Search web. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-bing https://api.fous.com/mcp/tools/bing --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Research web pages about a business topic.
- Track news articles about an industry or company.
- Review cited sources for answers to business questions.
- Compare search results across countries or freshness settings.
- Find related searches for a research topic.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Bing tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Bing account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from bing.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What web pages appear for a search query?

Search web returns regular results in displayed order, with page titles, links, snippets, and positions.

### What recent news articles cover a topic?

Search news returns article headlines, previews, publishers, links, and publication times.

### What sources support a Copilot answer?

Get copilot answer returns cited sources and indicates whether an AI-written answer appeared.

## Related

- [Google News API](https://fous.com/tools/google-news.md): Google News returns recent publisher articles, up to 100 per search, current top stories by topic, country, and language, and local stories by city or region when available.
- [Google Search API](https://fous.com/tools/google-search.md): Google Search returns public web, image, job, event, related-question, and autocomplete results in Google’s order, with answers and details when available; results may be fewer, omit information, or be empty.
- [BBC News API](https://fous.com/tools/bbc-news.md): BBC News returns section-ordered headlines, searchable articles with dates, authors and sections (filters/newest sorting cover 180 matches), and article text with available latest live entries.
- [Yahoo News API](https://fous.com/tools/yahoo-news.md): Yahoo News provides section headlines and searchable articles, plus public article text and details; health has no public stories, and search covers a limited results window.
- [DuckDuckGo API](https://fous.com/tools/duckduckgo.md): Private web search and instant answers.
- [Fox News API](https://fous.com/tools/fox-news.md): Fox News returns section-page headlines, keyword-matched articles among up to 100 available results, and readable article text, including the latest live-blog updates.
- [AP News API](https://fous.com/tools/ap-news.md): AP News provides reporting, up to 50 public-page headlines, searchable articles visible in its search, and full text when accessible.
- [Reuters API](https://fous.com/tools/reuters.md): Reuters provides international news and reporting, with latest section headlines and keyword search; coverage and article details may be limited by access restrictions and news indexing.
- [All Search tools](https://fous.com/tools/category/search)