@emergentmethods/asknews-cli 0.1.0

package/skills/asknews-cli/references/commands/api-charts.md

@@ -0,0 +1,28 @@
+# api charts
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api charts create-charts-endpoint`
+
+Create charts.
+
+- Request: `POST /v1/chat/charts`
+- Operation ID: `create_charts_endpoint`
+- Safety: `high-cost`
+
+**Request body fields:**
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--query` | string | yes | The chart query to create |
+
+Use direct kebab-case body options, `--body '{...}'`, or `--body @request.json`.
+Direct body options override values supplied through `--body`.
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-chat.md

@@ -0,0 +1,108 @@
+# api chat
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api chat deep-news`
+
+Deep research into real-time news, archive news, and Google.
+
+- Request: `POST /v1/chat/deepnews`
+- Operation ID: `deep_news`
+- Safety: `high-cost`
+
+**Request body fields:**
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--messages` | array<object> | yes | 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. |
+| `--model` | string or null | no | The model to use for DeepNews research. Defaults to claude-sonnet-4-6. Default: `"claude-sonnet-4-6"`. |
+| `--filter-params` | object or null | no | Filter parameters to apply to the AskNews search within DeepNews. |
+| `--search-depth` | integer | no | The search depth for deep research. Higher values mean more thorough research. Default: `2`. |
+| `--max-depth` | integer | no | The maximum research depth allowed. Default: `6`. |
+| `--sources` | string or array | no | 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 Default: `"asknews"`. |
+| `--inline-citations` | string | no | How to format inline citations in the response. Defaults to: markdown_link. Available options: markdown_link, numbered, none Choices: markdown_link, numbered, none. Default: `"markdown_link"`. |
+| `--start-citation-number` | integer | no | Starting number for inline citations. Offsets fetched source citation keys. Useful if you are providing the agent outside sources with numbered citation keys. Default: `1`. |
+| `--return-sources` | boolean | no | Whether return a list of sources used by the agent. Default: `true`. |
+| `--only-cited-sources` | boolean | no | Whether to return only of sources that are cited/referenced in the generated response content. Default: `true`. |
+| `--append-references` | boolean | no | Whether to append a 'Cited Articles' section at the end of the response. Default: `true`. |
+| `--journalist-mode` | boolean | no | Whether to use journalist mode for more factual reporting. Default: `true`. |
+| `--conversational-awareness` | boolean | no | Whether to use conversational awareness. Default: `true`. |
+| `--include-entities` | boolean | no | Whether to provide extracted entities to the agent. Default: `true`. |
+| `--include-graphs` | boolean | no | Whether to provide knowledge graphs to the agent Default: `false`. |
+| `--include-coordinates` | boolean | no | Whether to provide geo coordinates to the agent. Default: `false`. |
+| `--asknews-watermark` | boolean | no | Append 'Generated by AskNews AI' watermark Default: `true`. |
+| `--stream` | boolean | no | Whether to stream the response as server-sent events. Default: `false`. |
+| `--stop` | string or array or null | no | Sequence(s) where the model will stop generating further tokens. |
+| `--temperature` | number | no | 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. Default: `0.9`. |
+| `--top-p` | number | no | Nucleus sampling parameter. Only tokens with cumulative probability up to top_p are considered. Default: `1`. |
+| `--n` | integer | no | Number of completions to generate. Default: `1`. |
+| `--max-tokens` | integer | no | Maximum number of tokens to generate in the response. Default: `9999`. |
+| `--presence-penalty` | integer | no | Penalizes new tokens based on whether they appear in the text so far, encouraging new topics. Default: `0`. |
+| `--frequency-penalty` | integer | no | Penalizes new tokens based on their frequency in the text so far, reducing repetition. Default: `0`. |
+| `--user` | string or null | no | A unique identifier for the end-user, useful for tracking and abuse detection. |
+| `--thread-id` | string or null | no | ID of an existing thread to continue the conversation. |
+| `--max-parallel-tool-calls` | integer | no | 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. Default: `1`. |
+| `--engine` | string | no | 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. Choices: v1, v1.5, v2.0. Default: `"v1.5"`. |
+| `--enable-source-pruning` | boolean | no | 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. Default: `false`. |
+| `--cutoff-datetime` | string or null | no | The knowledge cutoff datetime for the agent prompt and all tool calls. |
+
+Use direct kebab-case body options, `--body '{...}'`, or `--body @request.json`.
+Direct body options override values supplied through `--body`.
+
+### `asknews api chat get-chat-completions`
+
+Get the chat completions for a given user message. This endpoint follows the
+OpenAI API spec. It includes a couple extra params, which include:
+
+- **journalist_mode**: Whether to activate an auto prompt that is more keen on AP styling,
+citations, and fair reporting. Setting to false, you get a vanilla LLM with the news pre
+added to the system prompt. No other prompting.
+- **inline_citations**: Decides how you want the bot to cite sources. It can use brackets,
+or it can also include the markdown with URL automatically.
+- **asknews_watermark**: Whether to include the AskNews watermark in the response.
+
+- Request: `POST /v1/openai/chat/completions`
+- Operation ID: `get_chat_completions`
+- Safety: `high-cost`
+
+**Request body fields:**
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--model` | string | no | Default: `"gpt-4o-mini"`. |
+| `--messages` | array<object> | yes |  |
+| `--temperature` | number | no | Default: `0.9`. |
+| `--top-p` | number | no | Default: `1`. |
+| `--n` | integer | no | Default: `1`. |
+| `--stream` | boolean | no | Default: `false`. |
+| `--stop` | string or array or null | no |  |
+| `--max-tokens` | integer | no | Default: `9999`. |
+| `--presence-penalty` | integer | no | Default: `0`. |
+| `--frequency-penalty` | integer | no | Default: `0`. |
+| `--thread-id` | string or null | no |  |
+| `--user` | string or null | no |  |
+| `--inline-citations` | string | no | Choices: numbered, markdown_link, none. Default: `"markdown_link"`. |
+| `--append-references` | boolean | no | Default: `true`. |
+| `--journalist-mode` | boolean | no | Default: `true`. |
+| `--asknews-watermark` | boolean | no | Default: `true`. |
+| `--conversational-awareness` | boolean | no | Default: `true`. |
+| `--filter-params` | object or null | no |  |
+
+Use direct kebab-case body options, `--body '{...}'`, or `--body @request.json`.
+Direct body options override values supplied through `--body`.
+
+### `asknews api chat list-deepnews-models`
+
+List the available DeepNews models with their public type (standard/lite/advanced).
+
+- Request: `GET /v1/chat/deepnews-models`
+- Operation ID: `list_deepnews_models`
+- Safety: `read-only`
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-distribution.md

@@ -0,0 +1,46 @@
+# api distribution
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api distribution find-domains`
+
+Find domains with optional filters.
+
+- Request: `GET /v1/distribution/domains`
+- Operation ID: `find_domains`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--page` | Page number for pagination Location: query. Type: integer. Optional. Default: `1`. Minimum: 1. |
+| `--per-page` | Number of items per page Location: query. Type: integer. Optional. Default: `10`. Minimum: 1. Maximum: 100. |
+| `--names` | List of domain names to filter by Location: query. Type: string. Optional. |
+| `--is-tollbit` | Filter by tollbit status Location: query. Type: string. Optional. |
+| `--publisher` | Filter by publisher status Location: query. Type: string. Optional. |
+
+### `asknews api distribution top-n-domains-by-hits`
+
+Get the top N domains by hits.
+
+- Request: `GET /v1/distribution/domains/top_n`
+- Operation ID: `top_n_domains_by_hits`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--limit` | Number of top domains to return Location: query. Type: integer. Optional. Default: `10`. Minimum: 1. Maximum: 100. |
+| `--start-date` | Start date to filter by (timestamp in seconds since epoch) Location: query. Type: string. Optional. |
+| `--end-date` | End date to filter by (timestamp in seconds since epoch) Location: query. Type: string. Optional. |
+| `--names` | List of domain names to filter by Location: query. Type: string. Optional. |
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-forecast.md

@@ -0,0 +1,44 @@
+# api forecast
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api forecast get-forecast`
+
+Make an expert forecast for a news event.
+
+This endpoint reaches into the news archive, looking back `lookback` days to
+extract the most relevant news articles, building a timeline of events, and
+then making an expert forecast.
+
+This endpoint is more expensive than the search endpoint, it is calling
+gpt-4o or claude 3-5 on approx 15k tokens to build the forecast.
+This endpoint counts toward "deep" calls in the billing system.
+
+It returns the forecast, the reasoning, and the sources.
+
+- Request: `GET /v1/chat/forecast`
+- Operation ID: `get_forecast`
+- Safety: `high-cost`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--query` | The requested forecast. Location: query. Type: string. Required. |
+| `--lookback` | The number of days to look back for the forecast. Location: query. Type: integer. Optional. Default: `14`. |
+| `--articles-to-use` | The total number of relevant articles to be extracted from the news archive and used for the forecast. Location: query. Type: integer. Optional. Default: `15`. |
+| `--method` | Method to use for the context search Currently only 'kw' is supported. Location: query. Type: string. Optional. Default: `"kw"`. |
+| `--model` | The model to use for the forecast. Location: query. Type: string. Optional. Choices: gpt-4o, gpt-4o-mini, gpt-4.1-2025-04-14, claude-3-5-sonnet-latest, claude-3-5-sonnet-20240620, claude-sonnet-4-20250514, claude-opus-4-20250514, claude-sonnet-4-5-20250929, claude-opus-4-6, claude-sonnet-4-6, o1-mini, o3-mini, o3. Default: `"gpt-4.1-2025-04-14"`. |
+| `--cutoff-date` | The cutoff date for the forecast. String format is 'YYYY-MM-DD-HH:MM'. This is useful for backtesting forecasts. Location: query. Type: string. Optional. |
+| `--use-reddit` | Whether to use Reddit data for the forecast.enterprise customers only. Location: query. Type: boolean. Optional. Default: `false`. |
+| `--additional-context` | Additional context to use for the forecast. Location: query. Type: string. Optional. |
+| `--web-search` | Whether to run a live web search and include results in the forecast. enterprise customers only. Location: query. Type: boolean. Optional. Default: `false`. |
+| `--expert` | The type of expert to use for the forecast. Location: query. Type: string. Optional. Choices: general, sports. Default: `"general"`. |
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-graph.md

@@ -0,0 +1,41 @@
+# api graph
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api graph build-graph`
+
+Explore our mega-news-knowledge-graph at which ever level of resolution you need.
+
+Fully disambiguated and ready to be used in any downstream application.
+
+Pass a natural language query to get a graph of the latest news. Add parameters
+to build a graph from our archive, filter your graph by language, country, reporting voice,
+sentiment, provocative levels, and much more.
+
+- Request: `POST /v1/news/graph`
+- Operation ID: `build_graph`
+- Safety: `high-cost`
+
+**Request body fields:**
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--query` | string | no | Query string that can be any phrase, keyword, question, or paragraph. If method='nl', then this will be used as a natural language query. If method='kw', then this will be used as a direct keyword query. Default: `""`. |
+| `--return-articles` | boolean | no | Whether to return articles or not. Default: `false`. |
+| `--min-cluster-probability` | number | no | Minimum cluster probability to use for disambiguation Default: `0.9`. |
+| `--geo-disambiguation` | boolean | no | Whether to use geo disambiguation or not. Default: `false`. |
+| `--filter-params` | object or null | no | All parameters available on the search_news endpoint located here: https://docs.asknews.app/en/reference#get-/v1/news/search |
+| `--constrained-disambiguations` | array or null | no | Disambiguation correction parameters. |
+| `--docs-upload` | array or null | no | Document upload parameters. |
+| `--visualize-with` | string or null | no | Request a visualization graph returned in the response. |
+
+Use direct kebab-case body options, `--body '{...}'`, or `--body @request.json`.
+Direct body options override values supplied through `--body`.
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-index-urls.md

@@ -0,0 +1,32 @@
+# api index-urls
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api index-urls index-urls`
+
+Index a list of news article URLs.
+
+- Request: `POST /v1/news/index_urls`
+- Operation ID: `index_urls`
+- Safety: `mutating`
+
+**Request body fields:**
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--start-time` | string | yes | Format: date-time. |
+| `--end-time` | string | yes | Format: date-time. |
+| `--urls` | array<object> | yes |  |
+
+Use direct kebab-case body options, `--body '{...}'`, or `--body @request.json`.
+Direct body options override values supplied through `--body`.
+
+This operation requires confirmation and `--yes` in non-interactive use.
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.

package/skills/asknews-cli/references/commands/api-news.md

@@ -0,0 +1,164 @@
+# api news
+
+Generated from AskNews API 0.24.95.
+
+## Operations
+
+### `asknews api news get-article`
+
+Get a single article given a UUID.
+
+- Request: `GET /v1/news/{article_id}`
+- Operation ID: `get_article`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--article-id` | Article ID to retrieve Location: path. Type: string. Required. |
+
+### `asknews api news get-articles`
+
+Get articles given a list of UUIDs.
+
+- Request: `GET /v1/news`
+- Operation ID: `get_articles`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--article-ids` | Article UUIDs to fetch. Location: query. Type: array<string>. Required. |
+| `--full-text` | Whether to return the full text of the articles. Location: query. Type: boolean. Optional. Default: `false`. |
+
+### `asknews api news get-index-counts`
+
+This endpoint is primarly used for the publisher dashboard, to
+show the number of articles indexed per source.
+
+- Request: `GET /v1/index_counts`
+- Operation ID: `get_index_counts`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--start-datetime` | Start timestamp to filter by Location: query. Type: string. Optional. |
+| `--end-datetime` | End timestamp to filter by Location: query. Type: string. Optional. |
+| `--domains` | Domain or list of domains to get indexing counts for Location: query. Type: string. Optional. |
+| `--sampling` | Sampling to use Location: query. Type: string. Optional. Choices: 5m, 1h, 12h, 1d, 1w, 1m. Default: `"1d"`. |
+| `--time-filter` | Control which date type to filter on. 'crawl_date' is the date the article was crawled, 'pub_date' is the date the article was published. Location: query. Type: string. Optional. Choices: crawl_date, pub_date. Default: `"pub_date"`. |
+| `--categories` | Categories of news to filter on Location: query. Type: string. Optional. |
+| `--provocative` | Filter articles based on how provocative they are deemed based on the use of provocative language and emotional vocabulary. Location: query. Type: string. Optional. |
+| `--reporting-voice` | Type of reporting voice to filer by. Location: query. Type: string. Optional. |
+| `--bad-domain-url` | blacklist of domains that must be excluded from resultsThis can be a single domain url or a list of domain urls. Location: query. Type: string. Optional. |
+| `--page-rank` | maximum allowed pagerank for returned articles Location: query. Type: string. Optional. |
+| `--string-guarantee` | If defined, the search will only occur on articles that contain this string. Location: query. Type: string. Optional. |
+| `--string-guarantee-op` | Operator to use for string guarantee. Location: query. Type: string. Optional. Choices: AND, OR. Default: `"AND"`. |
+| `--reverse-string-guarantee` | If defined, the search will only occur on articles that do not contain this string. Location: query. Type: string. Optional. |
+| `--entity-guarantee` | Entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John'] Location: query. Type: string. Optional. |
+| `--entity-guarantee-op` | Operator to use for entity guarantee. Location: query. Type: string. Optional. Choices: AND, OR. Default: `"OR"`. |
+| `--languages` | Languages to filter by. This is the two-letter 'set 1' of the ISO 639-1 standard. For example: English is 'en'. Location: query. Type: string. Optional. |
+| `--countries` | Source countries to filter by (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'. Location: query. Type: string. Optional. |
+| `--countries-blacklist` | Source countries to blacklist from search (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to reverse_entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'. Location: query. Type: string. Optional. |
+| `--continents` | Continents to filter by Location: query. Type: string. Optional. |
+| `--sentiment` | Sentiment to filter news articles by. Location: query. Type: string. Optional. |
+
+### `asknews api news get-sources-report`
+
+This endpoint is primarly used for transparency and monitoring the
+diversity of the data.
+
+Visualized at `https://asknews.app/transparency`.
+
+Get the distribution of sources/languages/countries underlying AskNews content.
+
+- Request: `GET /v1/sources`
+- Operation ID: `get_sources_report`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--n-points` | Number of points to return Location: query. Type: integer. Optional. Default: `100`. |
+| `--start-timestamp` | Start timestamp to filter by Location: query. Type: string. Optional. |
+| `--end-timestamp` | End timestamp to filter by Location: query. Type: string. Optional. |
+| `--metric` | Metric to filter by Location: query. Type: string. Optional. Choices: duplication, countries_diversity, languages_diversity, sources_diversity, bucket_loss. Default: `"countries_diversity"`. |
+| `--sampling` | Sampling to use Location: query. Type: string. Optional. Choices: 5m, 1h, 4h, 1d. Default: `"1h"`. |
+
+### `asknews api news search-news`
+
+Search for any news, up to the last 5 minutes or in our extensive historical archive
+filled with 100s of millions of articles.
+
+Geared toward low-latency applications, where time is of the essence. For example, this
+endpoint is commonly used for quickly getting news context for an LLM.
+
+This endpoint is also commonly used for synthetic data curation. For example, say you
+are fine-tuning a model for sports. You could filter  with `classification="Sports"`
+and build a dataset of sports articles.
+
+News articles come with an abundance of valuable metadata, including full summaries, sentiment,
+entities, reporting voice, page rank, language, and much much more.
+
+An example of this data in action can be found and interacted with at `https://asknews.app/chat`
+
+- Request: `GET /v1/news/search`
+- Operation ID: `search_news`
+- Safety: `read-only`
+
+**Options:**
+
+| Option | Description |
+| --- | --- |
+| `--query` | Query string that can be any phrase, keyword, question, or paragraph. If method='nl', then this will be used as a natural language query. If method='kw', then this will be used as a direct keyword query. This is not required, if it is not passed, then the search is based on the remaining filters only. Location: query. Type: string. Optional. Default: `""`. |
+| `--n-articles` | Number of articles to return Location: query. Type: integer. Optional. Default: `10`. Maximum: 101. |
+| `--start-timestamp` | Timestamp to start search from Location: query. Type: string. Optional. |
+| `--end-timestamp` | Timestamp to end search at Location: query. Type: string. Optional. |
+| `--time-filter` | Control which date type to filter on. 'crawl_date' is the date the article was crawled, 'pub_date' is the date the article was published. Location: query. Type: string. Optional. Choices: crawl_date, pub_date. Default: `"crawl_date"`. |
+| `--return-type` | Type of return value. 'string' means that the return is prompt-optimized and ready to be immediately injected into any prompt. 'dicts' means that the return is a structured dictionary, containing additional metadata (like a classic news api). Can be 'string' or 'dicts', or 'both'. 'string' guarantees the lowest-latency response 'dicts' requires more I/O, therefore increases latency (very slightly, depending on your network connection). Location: query. Type: string. Optional. Choices: string, dicts, both. Default: `"dicts"`. |
+| `--historical` | Search on archive of historical news. Defaults to False, meaning that the search will only look through the most recent news (48 hours) Location: query. Type: boolean. Optional. Default: `false`. |
+| `--method` | Method to use for searching. 'nl' means Natural Language, which is a string that can be any phrase, keyword, question, or paragraph that will be used for semantic search on the news. 'kw' means Keyword, which can also be any keyword(s), phrase, or paragraph, however the search is a direct keyword search on the database. 'both' means both methods will be used and results will be ranked according to IRR. 'both' may reduce latency by 10 pct in exchange for improved accuracy. Location: query. Type: string. Optional. Choices: nl, kw, both. Default: `"kw"`. |
+| `--similarity-score-threshold` | Similarity score threshold to determine which articles to return. Lower means less similar results are allowed. Location: query. Type: number. Optional. Default: `0.5`. |
+| `--offset` | Offset for pagination. The n_articles is your page size, while your offset is the number of articles to skip to get to your page of interest. For example, if you want to get page 3 for n_article page size of 10, you would set offset to 20. Location: query. Type: string. Optional. Default: `0`. |
+| `--categories` | Categories of news to filter on Location: query. Type: array<string>. Optional. |
+| `--doc-start-delimiter` | Document start delimiter for string return. Location: query. Type: string. Optional. Default: `"<doc>"`. |
+| `--doc-end-delimiter` | Document end delimiter for string return. Location: query. Type: string. Optional. Default: `"</doc>"`. |
+| `--provocative` | Filter articles based on how provocative they are deemed based on the use of provocative language and emotional vocabulary. Location: query. Type: string. Optional. Choices: unknown, low, medium, high, all. |
+| `--reporting-voice` | Type of reporting voice to filer by. Location: query. Type: string. Optional. |
+| `--domain-url` | filter by domain url of interest. This can be a single domain or a list of domains. For example, 'npr.org' or ['nature.com', 'npr.org'] Location: query. Type: string. Optional. |
+| `--bad-domain-url` | blacklist of domains that must be excluded from resultsThis can be a single domain url or a list of domain urls. Location: query. Type: string. Optional. |
+| `--page-rank` | Maximum allowed page rank for returned articles. Location: query. Type: string. Optional. |
+| `--diversify-sources` | Ensure that the return set of articles are selected from diverse sources. This adds latency to the search, but attempts to balance the representation of sources by country and source origins. In summary, a net is cast around your search, then the diversity of sources is analyzed, and your final result matches the large net diversity distribution. This means that your search accuracy is reduced, but you gain more diverse perspectives. Location: query. Type: boolean. Optional. Default: `false`. |
+| `--strategy` | Strategy to use for searching. 'latest news' automatically setsmethod='nl', historical=False, and looks within the past 24 hours. 'news knowledge' automatically sets method='kw', historical=True, and looks within the past 60 days. 'news knowledge' will increase latency due to the larger search space in the archive. Use 'default' if you want to control start_timestamp, end_timestamp, historical, and method. Location: query. Type: string. Optional. Choices: latest news, news knowledge, default. Default: `"default"`. |
+| `--hours-back` | Can be set to easily control the look back on the search. This is the same as controlling the 'start_timestamp' parameter. The difference is that this is not a timestamp, it is the number of hours back to look from the current time. Defaults to 24 hours. Location: query. Type: integer. Optional. Default: `24`. |
+| `--string-guarantee` | If defined, the search will only occur on articles that contain strings in this list. Location: query. Type: string. Optional. |
+| `--string-guarantee-op` | Operator to use for string guarantee list. Location: query. Type: string. Optional. Choices: AND, OR. Default: `"AND"`. |
+| `--reverse-string-guarantee` | If defined, the search will only occur on articles that do not contain strings in this list. Location: query. Type: string. Optional. |
+| `--entity-guarantee` | Entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John'] Location: query. Type: string. Optional. |
+| `--reverse-entity-guarantee` | Reverse entity guarantee to filter by. This is a list of strings, where each string includes entity type and entity value separated by a colon. The first element is the entity type and the second element is the entity value. For example ['Location:Paris', 'Person:John'] Location: query. Type: string. Optional. |
+| `--entity-guarantee-op` | Operator to use for entity guarantee list. Location: query. Type: string. Optional. Choices: AND, OR. Default: `"OR"`. |
+| `--return-graphs` | Return graphs for the articles. Only available to Analyst tier and above. Location: query. Type: boolean. Optional. Default: `false`. |
+| `--return-geo` | Return GeoCoordinates associated with locations discussed inside the articles. Only available to Analyst tier and above. Location: query. Type: boolean. Optional. Default: `false`. |
+| `--languages` | Languages to filter by. This is the two-letter 'set 1' of the ISO 639-1 standard. For example: English is 'en'. Location: query. Type: string. Optional. |
+| `--countries` | Source countries to filter by (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'. Location: query. Type: string. Optional. |
+| `--countries-blacklist` | Source countries to blacklist from search (this is only for the publisher location, not the locations mentioned in articles. For Locations mentioned in articles, refer to reverse_entity_guarantee), countries must be the two-letter ISO country codeFor example: United States is 'US', France is 'FR', Sweden is 'SE'. Location: query. Type: string. Optional. |
+| `--continents` | Continents to filter by. Location: query. Type: string. Optional. |
+| `--sentiment` | Sentiment to filter articles by. Location: query. Type: string. Optional. |
+| `--premium` | Include premium sources. Location: query. Type: boolean. Optional. Default: `false`. |
+| `--authors` | Authors to filter articles by. Location: query. Type: string. Optional. |
+| `--try-cache` | Enable response caching with the specified TTL. When a cached response is returned, usage is charged at 0.25x the normal rate. Valid values: '1h' (1 hour), '6h' (6 hours), '12h' (12 hours), '24h' (24 hours), '3d' (3 days), '7d' (7 days). Location: query. Type: string. Optional. |
+| `--geo-lat` | Latitude for geo-radius filter. Must be provided together with geo_lon and geo_radius. Filters articles whose coordinates fall within the specified circle. Location: query. Type: string. Optional. |
+| `--geo-lon` | Longitude for geo-radius filter. Must be provided together with geo_lat and geo_radius. Location: query. Type: string. Optional. |
+| `--geo-radius` | Radius in meters for geo-radius filter. Must be provided together with geo_lat and geo_lon. Location: query. Type: string. Optional. |
+| `--geo-polygon` | JSON string defining a polygon for geo filtering. Must contain an 'exterior' key with a list of {lon, lat} points. The first and last point must be the same. Optionally include 'interiors' as a list of rings (each a list of {lon, lat} points) to exclude areas. Example: {"exterior": [{"lon": -70, "lat": -70}, {"lon": 60, "lat": -70}, {"lon": 60, "lat": 60}, {"lon": -70, "lat": 60}, {"lon": -70, "lat": -70}]} Location: query. Type: string. Optional. |
+
+## Global options
+
+All commands support `--output human|table|json|jsonl|yaml`, `--json`, API/auth URL
+overrides, request timeout, and color control. Result data is written to stdout; diagnostics
+are written to stderr.