# Microsoft Web IQ

> Microsoft Web IQ provides real-time web grounding for LLMs and AI agents — web search, news, videos, images, and direct URL content extraction (Browse). Available via REST API at `https://api.microsoft.ai/v3/` and as an MCP server at `https://api.microsoft.ai/v3/mcp`. Authenticate with an API key (`x-apikey`) or Entra ID OAuth 2.0 Bearer token.

## Docs

- [Overview](https://webiq.microsoft.ai/documentation/overview/): Product overview, service scope, and documentation entry points.
- [Quick Start](https://webiq.microsoft.ai/documentation/quick-start/?view=md): First successful API call, endpoint summary, and sample responses.
- [Authentication](https://webiq.microsoft.ai/documentation/authentication/?view=md): API key and Entra ID OAuth 2.0 authentication setup.
- [MCP Server](https://webiq.microsoft.ai/documentation/mcp/?view=md): Configure the Streamable HTTP MCP endpoint for VS Code Copilot or any MCP-compatible client; lists available tools (`web`, `videos`, `browse`, `news`, `images`).
- [Error Handling](https://webiq.microsoft.ai/documentation/error-handling/?view=md): Standardized error schema, full HTTP status code table, common scenarios (auth/rate-limit/202 Browse retry), and retry best practices.
- [Supported Languages and Regions](https://webiq.microsoft.ai/documentation/supported-languages-and-regions/?view=md): Full ISO 639-1 language list and 2-letter country/region codes accepted by `language` and `region` parameters.
- [Instrumentation](https://webiq.microsoft.ai/documentation/instrumentation/?view=md): Implement telemetry to log which search results an LLM references and which citations users click.
- [SDKs and Libraries](https://webiq.microsoft.ai/documentation/sdk/?view=md): Official SDK package links and usage guidance.
- [Frequently Asked Questions](https://webiq.microsoft.ai/documentation/faq/?view=md): Customer guidance for service deployment, authentication, networking, quotas, privacy, content safety, result quality, and usage.
- [Changelog](https://webiq.microsoft.ai/documentation/changelog/?view=md): Version and release-note history.
- [OpenAPI JSON](https://webiq.microsoft.ai/documentation/openapi.json): Machine-readable OpenAPI spec.

## API Reference

- [Web Search](https://webiq.microsoft.ai/documentation/api-reference/web/?view=md): `POST https://api.microsoft.ai/v3/search/web` — public web grounding content; supports `passage`/`text`/`html`/`markdown` content formats, `site:`/`-site:` operators.
- [Videos Search](https://webiq.microsoft.ai/documentation/api-reference/videos/?view=md): `POST https://api.microsoft.ai/v3/search/videos` — video results with moments, embedding URLs, freshness/resolution/duration filters, and optional playlists.
- [Browse](https://webiq.microsoft.ai/documentation/api-reference/browse/?view=md): `POST https://api.microsoft.ai/v3/browse` — extract content from a specific URL; `liveCrawl=fallback` enables on-demand crawl with a 202/`retryAfter` response.
- [News Search](https://webiq.microsoft.ai/documentation/api-reference/news/?view=md): `POST https://api.microsoft.ai/v3/search/news` — trusted news results; returns articles from the **last 14 days only**.
- [Images Search](https://webiq.microsoft.ai/documentation/api-reference/images/?view=md): `POST https://api.microsoft.ai/v3/search/images` — image results with aspect-ratio, color, size, and watermark filters.

## Portal

- [Profile Management](https://webiq.microsoft.ai/profiles/): View profile quota and allowed services; create and manage API keys and Application (Client) IDs for authentication.
- [Playground](https://webiq.microsoft.ai/playground/): Build and run sample requests interactively; copy generated code in cURL, Python, JavaScript, C#, Java, Go, or Ruby.

## Optional

- [llms-full.txt](https://webiq.microsoft.ai/llms-full.txt): Full documentation inlined in a single file for one-pass LLM consumption.
- [Get an API Key](https://webiq.microsoft.ai/profiles/)
- [Support](https://aka.ms/microsoft-webiq-support)