# Ai Bot — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and retrieve the latest artificial intelligence news articles by date and keyword to stay updated on industry developments and trends. Access daily curated content from ai-bot.cn to find relevant stories that match your specific interests.

**Category:** News & Media | **Website:** [ai-bot.cn/daily-ai-news/](https://ai-bot.cn/daily-ai-news/) | **Docs:** [parse.bot/marketplace/020bb999-5fb0-4c7d-8aea-860def4e71c3/ai-bot-cn-api](https://parse.bot/marketplace/020bb999-5fb0-4c7d-8aea-860def4e71c3/ai-bot-cn-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/ai-bot/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Search articles

Search daily AI news articles by keyword and/or date. Fetches the latest news page (covering approximately the last 3-4 months of workday updates) and filters articles whose title or content contains the keyword. Returns articles sorted by date descending (newest first). Each request fetches the full page from the source (~450 articles); filtering is applied locally.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Filter articles to a specific date in ISO format YYYY-MM-DD (e.g. 2026-08-13). When omitted, articles from all available dates are returned. |
| `keyword` | string | No | Search keyword matched case-insensitively against article title and content. When omitted, no keyword filter is applied. |
| `limit` | integer | No | Maximum number of articles to return. Clamped to 1-100. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/ai-bot/search-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","keyword":"<string>","limit":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.