intents
News Brief Intent
Recent coverage of a topic from two news indexes (Google News and Bing News) in one call, so a briefing agent is not anchored on a single publisher mix.
GET/api/public/v1/news-brief
- price
- $0.010
- atomic
- 10000
- free tier
- 3 calls / agent
- chain
- base mainnet
- asset
- USDC
- scheme
- exact
agent brief
Give a topic, get Google News + Bing News articles in one response.
engine: · results key: results · settlement: USDC / base / exact
use this when you need to
- -Morning briefing generation
- -Event coverage sweep
- -Publisher-bias comparison
query parameters
| name | type | required | description |
|---|---|---|---|
| network | base | base-sepolia | no · default "base" | Payment network. base-sepolia returns mock data for testing. |
| q | string | yes | News topic or entity |
| gl | string | no · default "us" | Country code for results |
| hl | string | no · default "en" | Interface language code |
call it — curl
bash
# Free tier — first 3 calls per agent identity, no payment header
curl "https://marketplaceforaiagents.com/api/public/v1/news-brief?q=AI+agents"
# Sandbox — signed testnet USDC, mock response, no real spend
curl "https://marketplaceforaiagents.com/api/public/v1/news-brief?q=AI+agents&network=base-sepolia" \
-H "X-PAYMENT: <base64 signed base-sepolia USDC authorization>"
# Production — signed x402 payment header, real data
curl "https://marketplaceforaiagents.com/api/public/v1/news-brief?q=AI+agents" \
-H "X-PAYMENT: <base64 signed USDC authorization>"call it — typescript + x402-fetch
typescript
import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";
const account = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY as `0x${string}`);
const fetchWithPayment = wrapFetchWithPayment(fetch, account);
const res = await fetchWithPayment(
"https://marketplaceforaiagents.com/api/public/v1/news-brief?q=AI+agents"
);
const data = await res.json();
console.log(data.results);response — 200 ok
application/json
{
"intent": "news-brief",
"chain": [
"google-news",
"bing-news"
],
"steps_run": 2,
"results": {
"google-news": {
"note": "Normalized response of /api/public/v1/google-news"
},
"bing-news": {
"note": "Normalized response of /api/public/v1/bing-news"
}
}
}status codes
200data returned, response includes X-PAYMENT-RESPONSE receipt when paid
400missing or invalid required parameters
402free tier exhausted or invalid X-PAYMENT — body contains accepts[] payment requirements
404unknown endpoint slug
429upstream rate limit — retry with backoff
500upstream or settlement error