# News By Keyword API

[Tools](/tools) / [Other](/tools/category/other) / [News By Keyword](/tools/gloria/news-by-keyword)

Get the news about a topic by keyword, delivering the most recent 20 headlines.

Category: [Other](/tools/category/other)

## Price

$0.07425 per successful call ≈ 13 calls with the $1 signup credit.

Input schema is not available in the local snapshot. Call inspect first; fill body and queryParams as required and replace any pathParams placeholders before running.

## Discover

```sh
curl https://keepbal.com/apis/v1/discover -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' -H 'Content-Type: application/json' -d '{"query":"News By Keyword"}'
```

## Inspect

```sh
curl https://keepbal.com/apis/v1/inspect -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' -H 'Content-Type: application/json' -d '{"publicId":"gloria/news-by-keyword"}'
```

## curl

```sh
curl https://keepbal.com/apis/v1/gloria/news-by-keyword \
  -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

## MCP run_tool

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run_tool",
    "arguments": {
      "tool": "gloria/news-by-keyword",
      "input": {}
    }
  }
}
```

## Python

```python
import json, os, requests

# Inspect first and replace input_data with the required parameters.
input_data = json.loads("{}")
response = requests.post(
    "https://keepbal.com/apis/v1/gloria/news-by-keyword",
    headers={"Authorization": "Bearer " + os.environ["KEEPBAL_API_KEY"]},
    json=input_data,
)
response.raise_for_status()
print(response.json())
```

## Errors and billing

Failed provider calls are not charged. HTTP 400 invalid_request means invalid JSON or parameters, including missing pathParams. HTTP 401 missing_api_key or invalid_api_key means authentication is required. HTTP 402 insufficient_credits means insufficient balance; top up before retrying. HTTP 503 provider_unavailable means the provider is unavailable. A pending run can settle later; poll GET /apis/v1/runs/{id} instead of starting another execution.

## How much does this API cost?

$0.07425 per successful call

## How do I start?

Create a KeepBal account with $1 free credit, obtain an API key, and inspect this tool before running it.

## Related tools

- [News Ticker Summary](/tools/gloria/news-ticker-summary) — Get a 24-hour news summary for a specific token/ticker, combining internal news data with web search results. Returns decision-grade bullet points for fund managers and trading agents. — $0.046035 per successful call
- [Pm Scorings](/tools/gloria/pm-scorings) — Latest direction+magnitude scorings for Polymarket events. Each row scores one \(headline, market\) pair with a direction \(up/down/none\), confidence \(0-1\), signed magnitude in points, composite tier \(SKIP/WATCH/TRADE\), and current market price. — $0.1485 per successful call
- [G2 Get Categories](/tools/g2/get-categories) — Get Categories through KeepBal. Data from G2. Category: Other. Pricing: fixed per successful call. Public operation: g2/get-categories. Inspect this operation for required inputs before running. — $0.0675 per successful call
- [G2 Get Category Products](/tools/g2/get-category-products) — Get Category Products through KeepBal. Data from G2. Category: Other. Pricing: fixed per successful call. Public operation: g2/get-category-products. Inspect this operation for required inputs before running. — $0.0675 per successful call
- [G2 Get Product Overview](/tools/g2/get-product-overview) — Get Product Overview through KeepBal. Data from G2. Category: Other. Pricing: fixed per successful call. Public operation: g2/get-product-overview. Inspect this operation for required inputs before running. — $0.0135 per successful call
- [G2 Get Product Pricing](/tools/g2/get-product-pricing) — Get Product Pricing through KeepBal. Data from G2. Category: Other. Pricing: fixed per successful call. Public operation: g2/get-product-pricing. Inspect this operation for required inputs before running. — $0.027 per successful call



[Start with $1 free credit](/sign-up)

[Tools](/tools) · [MCP documentation](/docs/mcp)