# 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/workflows/bing
- Handle: `@bing`
- Category: [Search](https://fous.com/workflows/category/search)
- Source website: https://bing.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with Bing.

## Methods

### Get copilot answer

Operation `get_copilot_answer`, version 1. 1 credit per call.

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 call.

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 | `"In a statement emailed to NPR, Dan Becker, director of the Safe Climate Transport Campaign at the Center for Biological` | Article preview. |
| `articles[].headline` | string | `"The Trump administration weakens car fuel efficiency standards : NPR"` | Article headline. |
| `articles[].publisher` | string or null | `"europesays"` | Publisher name. |
| `articles[].image_link` | string or null | `"https://th.bing.com/th?id=ONUT.6Ps42epWqI8tn2xtqYo4GA&pid=News&w=234&h=132&c=14&rs=2&qlt=90"` | News image link. |
| `articles[].article_link` | string | `"https://www.europesays.com/3278117/"` | Article page link. |
| `articles[].published_at` | string or null | `"2026-09-28T23:59:28+00:00"` | Publication time converted from Bing’s displayed date, in ISO 8601 with offset. |

**Example input**

```json
{
  "query": "electric vehicle tariffs",
  "country": "Canada",
  "freshness": "past_hour",
  "max_results": 20
}
```

**Example output**

```json
{
  "articles": [
    {
      "snippet": "In a statement emailed to NPR, Dan Becker, director of the Safe Climate Transport Campaign at the Center for Biological ...",
      "headline": "The Trump administration weakens car fuel efficiency standards : NPR",
      "publisher": "europesays",
      "image_link": "https://th.bing.com/th?id=ONUT.6Ps42epWqI8tn2xtqYo4GA&pid=News&w=234&h=132&c=14&rs=2&qlt=90",
      "article_link": "https://www.europesays.com/3278117/",
      "published_at": "2026-09-28T23:59:28+00:00"
    },
    {
      "snippet": "And of course, since he is a McConnell Republican, Fragoso wants Trump to lie: Declare victory in his trade wars and in his ...",
      "headline": "GOP strategist says Trump should hide until midterms are over",
      "publisher": "Daily Kos",
      "image_link": "https://th.bing.com/th?id=ONUT.Q60S1aSten24jJ2ceDA-eQ&pid=News&w=234&h=132&c=14&rs=2&qlt=90",
      "article_link": "https://www.dailykos.com/stories/2026/9/28/800104762/elections/gop-strategist-trump-hide-until-midterms-over/",
      "published_at": "2026-09-29T00:01:28+00:00"
    },
    {
      "snippet": "Australian finance professional Sonali Rodrigo has been recognised with the prestigious AFG Women on the Move Scholarship, presented by Australian Finance Group (AFG), in recognition of her leadership…",
      "headline": "Sonali Rodrigo earns national recognition from Australia’s finance industry",
      "publisher": "The Island",
      "image_link": null,
      "article_link": "https://island.lk/sonali-rodrigo-earns-national-recognition-from-australias-finance-industry/",
      "published_at": "2026-09-28T23:59:28+00:00"
    }
  ]
}
```

### Search web

Operation `search_web`, version 1. 1 credit per call.

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

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@bing","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## 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

### Is Fous affiliated with Bing?

No. Fous is not affiliated with Bing. This workflow reads the public bing.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/duckduckgo.md): Private web search and instant answers.
- [Fox News API](https://fous.com/workflows/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/workflows/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/workflows/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 workflows](https://fous.com/workflows/category/search)