---
title: "Deep research into real-time news, archive news, and Google."
method: POST
path: "/v1/chat/deepnews"
tags: ["chat"]
---

# Deep research into real-time news, archive news, and Google.

`POST /v1/chat/deepnews`

## Request body

- CreateDeepNewsRequest
  - `messages` CreateDeepNewsRequestMessage[], required — The messages to send to DeepNews. Each message should have 'role' and 'content' keys. Use this to specify what research/monitoring task DeepNews should perform. The 'content' for the final 'user' message should be your Alert query.
    - `role` string, required
    - `content` string, required
    - `name` string, nullable
    - `function_call` object, nullable
  - `model` 'o1-mini' | 'o1' | 'o3-mini' | 'o3' | 'gpt-4o-mini' | 'gpt-4o' | 'gpt-4.1-2025-04-14' | 'gpt-5-mini' | 'gpt-5' | 'command-nightly' | 'claude-3-5-sonnet-20240620' | 'claude-3-5-sonnet-latest' | 'claude-3-7-sonnet-latest' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-nothinking' | 'claude-sonnet-4-20250514' | 'claude-opus-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-6' | 'claude-sonnet-5' | 'claude-opus-4-8' | 'claude-opus-5' | 'claude-opus-4-6' | 'claude-fable-5' | 'gpt-5.6-terra' | 'gpt-5.6-sol' | 'deepseek' | 'deepseek-basic' | 'deepseek-r1-0528' | 'meta-llama/Meta-Llama-3-8B-Instruct' | 'meta-llama/Meta-Llama-3.1-405B-Instruct' | 'meta-llama/Meta-Llama-3.3-70B-Instruct' | 'meta-llama/Llama-4-Maverick-17B-128E-Instruct' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'gemini-2.5-pro-preview-03-25' | 'gemini-3-pro' | 'gemini-3.1-pro' | 'gemini-3-flash' | 'gemini-3.5-flash' | 'gemini-3.6-flash' | 'open-source-best' | 'kimi-k2p5'
  - `filter_params` object, nullable — Filter parameters to apply to the AskNews search within DeepNews.
  - `search_depth` integer — The search depth for deep research. Higher values mean more thorough research.
  - `max_depth` integer — The maximum research depth allowed.
  - `sources` union — Which data sources DeepNews should use. Can be a single source or a list. Available sources are: asknews, google, graph, wiki, x, reddit, charts, email, full_text_discovery, podcasts
    - 'asknews' | 'google' | 'graph' | 'wiki' | 'x' | 'reddit' | 'charts' | 'email' | 'full_text_discovery' | 'podcasts'
    - string[]
  - `inline_citations` 'markdown_link' | 'numbered' | 'none' — How to format inline citations in the response. Defaults to: markdown_link. Available options: markdown_link, numbered, none
  - `start_citation_number` integer — Starting number for inline citations. Offsets fetched source citation keys. Useful if you are providing the agent outside sources with numbered citation keys.
  - `return_sources` boolean — Whether return a list of sources used by the agent.
  - `only_cited_sources` boolean — Whether to return only of sources that are cited/referenced in the generated response content.
  - `append_references` boolean — Whether to append a 'Cited Articles' section at the end of the response.
  - `journalist_mode` boolean — Whether to use journalist mode for more factual reporting.
  - `conversational_awareness` boolean — Whether to use conversational awareness.
  - `include_entities` boolean — Whether to provide extracted entities to the agent.
  - `include_graphs` boolean — Whether to provide knowledge graphs to the agent
  - `include_coordinates` boolean — Whether to provide geo coordinates to the agent.
  - `asknews_watermark` boolean — Append 'Generated by AskNews AI' watermark
  - `stream` boolean — Whether to stream the response as server-sent events.
  - `stop` union — Sequence(s) where the model will stop generating further tokens.
    - string
    - string[]
  - `temperature` number — The temperature of the DeepNews agent model. Controls randomness in the output. Higher values (e.g., 1.0) make output more random, lower values (e.g., 0.1) make it more deterministic.
  - `top_p` number — Nucleus sampling parameter. Only tokens with cumulative probability up to top_p are considered.
  - `n` integer — Number of completions to generate.
  - `max_tokens` integer — Maximum number of tokens to generate in the response.
  - `presence_penalty` integer — Penalizes new tokens based on whether they appear in the text so far, encouraging new topics.
  - `frequency_penalty` integer — Penalizes new tokens based on their frequency in the text so far, reducing repetition.
  - `user` string, nullable — A unique identifier for the end-user, useful for tracking and abuse detection.
  - `thread_id` string, uuid, nullable — ID of an existing thread to continue the conversation.
  - `max_parallel_tool_calls` integer — Maximum number of parallel tool calls (e.g., searches) the agent can make during generation. Higher values may speed up responses, but may reduce on-the-fly adaptivity.
  - `engine` 'v1' | 'v1.5' | 'v2.0' — The engine to use for the DeepNews agent. 'v1' is deprecated while 'v1.5' is our next-generation research agent with access to more tools, better contextual understanding, and improved reasoning capabilities.'v1.5' streams thinking and tool use using tags <think> </think>, <tool_a> </tool_a> Meanwhile, 'v2.0' is the same underlying agent as 'v1.5', but the thinking and tool use chunks are typed content_block_delta's streamed between content_block_start and content_block_stop events, mimicking Anthropic's approach to streaming tool use/thinking events.
  - `enable_source_pruning` boolean — Whether to enable source pruning, which removes sources that are deemed irrelevant to the final response. This can help reduce noise in the sources and improve the quality of the response, but may also remove some relevant sources if not used carefully.
  - `cutoff_datetime` string, date-time, nullable — The knowledge cutoff datetime for the agent prompt and all tool calls.

## Response `200`

Deep news research.

- object
  - `id` string, required
  - `created` integer, required
  - `object` string
  - `model` string
  - `usage` object, required
    - `prompt_tokens` integer, required
    - `completion_tokens` integer, required
    - `total_tokens` integer, required
    - `tool_usage` object
  - `choices` object[], required
    - `index` integer, required
    - `message` object, required
      - `role` string, required
      - `content` string, required
      - `name` string
      - `function_call` object
    - `finish_reason` string
  - `sources` object, required
    - `news` object[]
      - `article_url` string, uri, required
      - `article_id` string, uuid, required
      - `classification` union, required
        - string[]
        - string
      - `country` string, required
      - `source_id` string, required
      - `page_rank` integer, required
      - `domain_url` string, required
      - `eng_title` string, required
      - `entities` object, required
        - `Person` string[]
        - `Organization` string[]
        - `Location` string[]
        - `Nationality` string[]
        - `Date` string[]
        - `Event` string[]
        - `Money` string[]
        - `Law` string[]
        - `Quantity` string[]
        - `Time` string[]
        - `Sports` string[]
        - `Politics` string[]
        - `Title` string[]
        - `Number` string[]
        - `Arms` string[]
        - `Product` string[]
        - `Media` string[]
        - `Transportation` string[]
        - `Religion` string[]
        - `Technology` string[]
        - `Space` string[]
        - `Medicine` string[]
        - `Language` string[]
        - `Science` string[]
      - `image_url` string
      - `keywords` string[], required
      - `language` string, required
      - `pub_date` string, date-time, required
      - `summary` string, required
      - `key_points` string[]
      - `title` string, required
      - `sentiment` integer, required
      - `centroid_distance` number, required
      - `cluster_probability` number, required
      - `markdown_citation` string
      - `provocative` 'unknown' | 'low' | 'medium' | 'high'
      - `reporting_voice` union
        - 'Objective' | 'Subjective' | 'Investigative' | 'Narrative' | 'Analytical' | 'Advocacy' | 'Conversational' | 'Satirical' | 'Emotive' | 'Explanatory' | 'UnknownPersuasive' | 'Sensational'
        - 'Objective' | 'Subjective' | 'Investigative' | 'Narrative' | 'Analytical' | 'Advocacy' | 'Conversational' | 'Satirical' | 'Emotive' | 'Explanatory' | 'UnknownPersuasive' | 'Sensational'
        - 'Objective' | 'Subjective' | 'Investigative' | 'Narrative' | 'Analytical' | 'Advocacy' | 'Conversational' | 'Satirical' | 'Emotive' | 'Explanatory' | 'UnknownPersuasive' | 'Sensational'
        - string
      - `entity_relation_graph` object
        - `nodes` object[]
        - `edges` object[]
      - `geo_coordinates` object
      - `continent` 'Africa' | 'Asia' | 'Europe' | 'Middle East' | 'North America' | 'South America' | 'Oceania'
      - `assets` object
        - `images` string[]
        - `videos` string[]
      - `social_embeds` string[]
      - `bias` 'Political' | 'Gender' | 'Cultural' | 'Age' | 'Religious' | 'Statement' | 'Illogical Claims' | 'Slant' | 'Source Selection' | 'Omission of Source Attribution' | 'Spin' | 'Sensationalism' | 'Negativity' | 'Subjective Adjectives' | 'Ad Hominem' | 'Mind Reading' | 'Opinion-as-Fact' | 'None' | 'Unknown'
      - `authors` object[]
        - `email` string
        - `name` string
        - `url` string
      - `full_text` string
      - `original_language_summary` string
      - `image_description` string
      - `crawl_date` string, date-time
      - `content_type` 'news' | 'opinion' | 'analysis' | 'review' | 'listicle' | 'guide' | 'interview' | 'profile' | 'forum' | 'liveblog' | 'fact-check' | 'press_release' | 'obituary' | 'data_journalism'
      - `as_string_key` string, required
    - `web` object[]
      - `title` string, required
      - `url` string, uri, required
      - `source` string, required
      - `published` string, required
      - `key_points` string[], required
      - `raw_text` string
      - `as_string_key` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `405` — Method Not Allowed
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/asknews/apis/asknews-api.md) · [All operations](https://skmtc.dev/asknews/apis/asknews-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/asknews/asknews-api/revisions/dd4286769887/schema)