For Agents
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Bing News Search API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fapi.bing.microsoft.com%2Fbing" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fapi.bing.microsoft.com%2Fbing" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Bing News Search API.
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
GET STARTED
Search the web for news articles by keyword, category, or trending topic and retrieve titles, descriptions, publishers, images, and publication dates as structured JSON.
Use for: Search for news articles about a specific company or product, Get the top business headlines for the United States market, Find all trending news topics on the web right now, Retrieve news articles about artificial intelligence published in the last 24 hours
Not supported: Does not handle web search, image search, video search, or news publishing - use for retrieving and searching news articles only.
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.
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
Patterns agents use Bing News Search API for, with concrete tasks.
★ 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.
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.
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.
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.
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.
3 endpoints — jentic publishes the only available openapi specification for bing news search api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/news
Get top news articles by category
/news/search
Search news articles by query
/news/trendingtopics
Get trending news topics
/news
Get top news articles by category
/news/search
Search news articles by query
/news/trendingtopics
Get trending news topics
What agents get from Jentic-routed access to this vendor.
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 isolation
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.
Intent-based discovery
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.
Alternatives and complements available in the Jentic catalogue.
Specific to using Bing News Search API through Jentic.
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.