canonical: https://jentic.com/apis/api.bing.microsoft.com/bing # Microsoft Azure Bing News Search API Jentic publishes the only available OpenAPI specification for Bing News Search API, keeping it validated and agent-ready. The Bing News Search API v7 returns headline news articles, news grouped by category, and trending news topics from across the web in a structured JSON response. Each article includes the title, description, publisher, image, URL, and publication date, with optional filters for market, freshness window, safe search, and language. Agents typically use this API to ground LLM responses with current news, monitor coverage of a topic, or build trending-news widgets. ## For AI agents Search the web for news articles by keyword, category, or trending topic and retrieve titles, descriptions, publishers, images, and publication dates as structured JSON. ## Scope Does not handle web search, image search, video search, or news publishing - use for retrieving and searching news articles only. ## Capabilities - Search news articles across the web by keyword with filters for market, freshness, and safe search - Retrieve top headline news segmented by category such as Business, Sports, Technology, or Entertainment - List currently trending news topics with their representative images and click-through URLs - Filter news results by language and country market to localise the news feed for an end user - Ground LLM answers with current news context by passing structured article snippets back to the model ## Use cases ### News-Grounded LLM Responses Augment a language model with fresh news context by calling Bing News Search before generating an answer. The agent issues a query against /news/search, parses the returned articles for title, description, and publisher, and feeds those snippets into the prompt as grounding context. This pattern reduces hallucination on time-sensitive questions and gives the model citation-ready sources within a single API call. Example prompt: Call GET /news/search with q='OpenAI funding round' and freshness='Day', then summarise the top five articles with their publisher names cited. ### Trending Topic Monitoring Track what is trending in the news to inform editorial planning, social posts, or research dashboards. The /news/trendingtopics endpoint returns the topics surfacing across Bing News, each with a representative image and a webSearchUrl. Refresh hourly to keep a live feed of what stories are breaking without manually scraping front pages. Example prompt: Call GET /news/trendingtopics for the en-US market and post the top ten trending topic names plus images to a Slack channel. ### Categorised News Briefings Build a daily news briefing segmented by category for a team or end user. Calling GET /news with the category parameter returns curated headlines for verticals such as Business, Sports, Technology, Politics, Entertainment, Health, Science, and World. Combine multiple category calls into a single email or chat message to deliver a structured morning brief. Example prompt: Call GET /news with category='Technology' and category='Business', then format the top three articles from each into a markdown email. ### Agent-Driven News Research via Jentic Connect Bing News Search to an AI agent through Jentic so the agent can pull current articles into any workflow. The agent searches Jentic for 'search news articles', loads the structured input schema, and executes the call with scoped credentials. The Azure subscription key never enters the agent's context, so the same agent can safely run news lookups alongside other API calls. Example prompt: Use the Jentic Python SDK to search for 'find news articles about a topic', load the operation, and execute with q='climate policy' and count=10. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | /news | Get top news articles by category | | GET | /news/search | Search news articles by query | | GET | /news/trendingtopics | Get trending news topics | ## Key resources - **News** — Top news articles by category, search across the web, and trending topics. ## Why Jentic - **Setup:** Wiring the Bing News Search API by hand means handling its Ocp-Apim-Subscription-Key header, targeting the v7.0 host, and mapping the news, search, and trending routes with their query parameters yourself. Through Jentic you install once, import Bing News Search from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** Bing News Search selects results through query parameters rather than resource ids in the URL path, so you limit the agent to the operations it needs, such as retrieving news or searching articles. The trending-topics operation is separate and is only available if you include it in the allowed set. - **Credential handling:** Your Azure Ocp-Apim-Subscription-Key is stored once, encrypted, by your own Jentic One instance and injected as the header at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'search news articles' or 'get trending topics', and Jentic returns the matching Bing News Search operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **NewsAPI** — Independent news search API covering 80,000+ sources with similar keyword and category filtering. - **GNews** — Search and headlines API backed by Google News content with country and language filters. - **OpenAI** — Pair Bing News results with GPT-class models to summarise or classify the returned articles. - **Currents API** — Multi-language news search API with category and country filtering. ## FAQ ### Why is there no official OpenAPI spec for Bing News Search API? Microsoft does not publish an OpenAPI specification for the Bing News Search API. Jentic generates and maintains this spec so that AI agents and developers can call Bing News Search API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer. ### What authentication does the Bing News Search API use? The API uses an Azure Cognitive Services subscription key passed in the Ocp-Apim-Subscription-Key header on every request. Through Jentic, that key is stored in the encrypted vault and only scoped tokens reach the agent's context, so the raw subscription key is never exposed to model prompts or logs. ### Can I get trending news topics with the Bing News Search API? Yes. Call GET /news/trendingtopics to retrieve the topics currently trending across Bing News. Each topic includes a name, query, image, and webSearchUrl. The endpoint accepts market and count parameters to localise and limit results. ### What are the rate limits for the Bing News Search API? Limits are tied to your Azure pricing tier. The free F1 tier allows up to 3 calls per second and 1,000 transactions per month; paid S1-S9 tiers raise the per-second limit and remove the monthly cap. Check the limit headers on each response when running through Jentic to back off cleanly. ### How do I search for news articles by keyword through Jentic? Search Jentic for 'search news articles' and the matching Bing News Search operation (GET /news/search) is returned with its input schema. Load the operation, then execute it with parameters such as q, freshness, mkt, and count. The full quickstart pattern is pip install jentic, search, load, execute. ### Is the Bing News Search API free? There is a free Azure tier (F1) that allows 1,000 transactions per month for evaluation. Production use requires a paid Azure subscription priced per 1,000 transactions, with rates depending on the S-tier you select in the Azure portal. ### Can I limit what my agent is allowed to do with the Bing News Search API? Yes. Because you run Jentic One yourself, your own rules decide which Bing News Search operations the agent may call, so you can allow only what it needs, such as GET /news for category headlines or GET /news/search for keyword queries. The trending-topics operation (GET /news/trendingtopics) is separate and reaches the agent only if you add it to the allowed set. Since Bing News selects results through query parameters rather than resource ids in the path, scoping at the operation level is enough to control what the agent can reach, and your Azure subscription key stays out of the agent's context.