#

DeepNews

The DeepNews endpoint is our state-of-the-art AskNews agent, capable of self-reflection, on-the-fly learning, and deep tangential iterative research into the AskNews news knowledge graph, Google, Wikipedia, X (Twitter), Reddit, and more. This agent is good for tasks that require complex analysis and high-level strategic planning. For example, monitoring geopolitical risk, investigative journalism, making event forecasts for prediction markets, fact-checking, and much more.

You can use most of the latest models with DeepNews, including Anthropic models, Google models, OpenAI models, and open source models. The full list of available models for DeepNews is available at the updated API reference.

This endpoint is also available as a tool on the MCP server.

Wanna test it out or request a new model? You can come to our Discord server to talk directly to the bot, or ask us to integrate new models

Detailed and updated response structures are always available in the API reference

#

Querying the DeepNews endpoint

The DeepNews endpoint can be used with the typical OpenAI SDK. That means, you can change your base_url to https://api.asknews.app and follow the instructions here. However, if you want fully structured source objects in addition to your response, you will need to use one of the AskNews SDKs as shown here:

#

AskNews SDK

#

Controlling the output

The following parameters allow you to make decisions about how deep the agent is allowed to search, and how the response is returned to you:

• sources The sources to search in. You can choose from asknews, google, wiki, x, reddit, charts, graph. By adding these, DeepNews will intelligently decide which tool is best for various parts of each research project. The ordering of these sources is the prioritization that you want DeepNews to consider when choosing tools.
• search_depth The number of levels deep you want to force the agent to search. Beyond which, the agent can choose if it wants to continue searching or if it is done (up to max_depth)
• max_depth The maximum number of levels deep the agent is allowed to search.
• return_sources Whether to return structured source objects with the response (for stream=True, the source objects are returned at the end of the stream one by one).
• stream Whether to stream the response or not. If stream=True, the response will be a generator that yields each message as it is received. If stream=False, the response will be a list of all messages.
• model The model to use for the response. See the list at the top of this page for the available models. If you want another model, please reach out with your request at contact@asknews.app.
• filter_params (Optional) The AskNews filter parameters (which can be manually controlled or automatically populated as shown in the AutoFilter documentation). This allows you to filter the sources that are returned in the response based on various criteria such as date, source type, country, sentiment, etc.

Detailed and updated response structures are always available in the API reference