# Bing API: Search the web

> Searches Bing and returns web results in the order shown, with snippets, answer-box text when available, and related searches.

Unofficial. Not affiliated with or endorsed by Bing.

- Page: https://fous.com/methods/bing.com/search-web
- Method: `bing.com/search_web`, version 1
- Website: bing.com
- Returns: results (position, title, website, link, snippet), answer box text, related searches
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `query` | string | yes | `"project management software for nonprofits"` | Question or search words, for example project management software for nonprofits. |
| `country` | string | no |  | Country name or two-letter code for search results, for example Canada or CA. Default "United States". |
| `freshness` | string | no |  | How recent results should be, for example past_week. One of "any", "past_day", "past_week", "past_month". Default "any". |
| `max_results` | integer | no |  | Maximum number of regular results to return, for example 20. Default 10. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

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

Its output:

```json
{
  "results": [
    {
      "link": "https://support.microsoft.com/en-us/project/install-project",
      "snippet": "The steps below are for the subscription versions of Project desktop, and the non-subscription versions of Project Server …",
      "position": 1,
      "page_title": "Install Project | Microsoft Support",
      "website_name": "microsoft.com"
    },
    {
      "link": "https://project.microsoft.com/msal-redirect2",
      "snippet": "project.microsoft.com",
      "position": 2,
      "page_title": "project .microsoft.com",
      "website_name": "microsoft.com"
    },
    {
      "link": "https://www.microsoft.com/en-us/microsoft-365/project/microsoft-project-enterprise-plans-and-pricing?msockid=0682199fcc84665f27ab0e64cd19670f",
      "snippet": "Compare Microsoft Project plans and pricing. Explore tools to manage projects, track resources, and deliver results with solutions …",
      "position": 3,
      "page_title": "Microsoft 365 Project : Compare Plans and Pricing",
      "website_name": "microsoft.com"
    }
  ],
  "answer_box_text": null,
  "related_searches": []
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"bing.com/search_web","input":{"query":"project management software for nonprofits"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find the top 15 web results for best budgeting apps for freelancers, limited to the past week, using United States results
- Search Bing for how to repot a monstera plant, UK results, and include any answer box text and related searches
- Look up recent news about electric vehicle battery recycling from the past month, results for Canada, up to 20 hits
- What does the web say about learning Japanese with spaced repetition? Give me 8 results with snippets, any freshness
- Run a search on Bing for remote team onboarding checklist in Australia, returning up to 25 results

## 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."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code for search results, for example Canada or CA."
    },
    "freshness": {
      "enum": [
        "any",
        "past_day",
        "past_week",
        "past_month"
      ],
      "type": "string",
      "default": "any",
      "description": "How recent results should be, for example past_week."
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of regular results to return, for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "results",
    "answer_box_text",
    "related_searches"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "position",
          "page_title",
          "website_name",
          "link",
          "snippet"
        ],
        "properties": {
          "link": {
            "type": "string"
          },
          "snippet": {
            "type": [
              "string",
              "null"
            ]
          },
          "position": {
            "type": "integer"
          },
          "page_title": {
            "type": "string"
          },
          "website_name": {
            "type": "string"
          }
        }
      }
    },
    "answer_box_text": {
      "type": [
        "string",
        "null"
      ]
    },
    "related_searches": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}
```

## See more

- [Bing API: Search Bing News](https://fous.com/methods/bing.com/search-news.md): Finds recent Bing News articles about a topic in Bing's displayed order, optionally localized to a country and limited to the past hour, day or week. Relative publication times are approximate; date-only labels are shown at midnight UTC.
- [DuckDuckGo API: Search the web](https://fous.com/methods/duckduckgo.com/search-web.md): Searches the web privately with DuckDuckGo in a chosen region and returns the ordered organic results without ads, plus DuckDuckGo's instant answer when it shows one.
- [Britannica API: Search articles](https://fous.com/methods/britannica.com/search-articles.md): Searches Britannica for encyclopedia articles and returns their titles, short descriptions, article links and images when shown. Excludes other search formats such as videos, questions and stories.
- [Microsoft API: Search Microsoft Store apps](https://fous.com/methods/apps.microsoft.com/search-apps.md): Searches Microsoft Store apps and games by keywords in a chosen country and returns them in Store order. Subscription-included items can show a price of 0.
- [Apple API: Search apps](https://fous.com/methods/apps.apple.com/search-apps.md): Finds iPhone and iPad apps by keyword in a chosen country's App Store, with ratings, prices, categories and App Store links.
- [Pinterest API: Search pins](https://fous.com/methods/pinterest.com/search-pins.md): Finds Pinterest pins for an idea in search order, with image, creator, board, saves and linked website. Limited to the first public search page.
- [Spotify API: Search music](https://fous.com/methods/spotify.com/search-music.md): Searches Spotify for songs, artists, albums, playlists or podcasts by keywords and returns them in Spotify's result order. Songs and albums include a release date when Spotify gives a full date.
- [Google API: Search Google Play apps](https://fous.com/methods/play.google.com/search-apps.md): Finds Android apps on Google Play by keywords, in Play search order, with each listing's developer, star rating, price and currency for the chosen country, download range and link. Results are limited to apps shown on the public search page.
- [All Bing methods](https://fous.com/methods/bing.com.md)
