# AiTopNews · Agent access

Connect AiTopNews to your agent. No token; browser cross-origin requests, curl and any language's default HTTP client can call it. Paths start with /api/v1; fields and error codes are in [The full REST API definition · 4.0.0](https://aitopnews.wiki/openapi-v1.json) .

## Endpoints

Filter by category: ai-models · ai-products · industry · paper · tip · opinion. Add category to an items request to take one category only; leave it out for all. Items carry the same category values.

| Path | What it is for | How often |
|---|---|---|
| https://aitopnews.wiki/api/v1/items | Picks or every item of the last 7 days, filterable by category, window and keyword | At most once a minute |
| https://aitopnews.wiki/api/v1/selected/snapshot | Every current pick, paged once | When needed |
| https://aitopnews.wiki/api/v1/selected/changes | New, changed and withdrawn picks after that | When needed |
| https://aitopnews.wiki/api/v1/hot-topics | The current hot ranking, top 10 | At most once a minute |
| https://aitopnews.wiki/api/v1/stories/{public_id} | One event's timeline, AI digest and related events | When needed |
| https://aitopnews.wiki/api/v1/dailies/latest | The latest daily | Once after 08:00 |
| https://aitopnews.wiki/api/v1/dailies/{YYYY-MM-DD} | One date's daily; withdrawals remove citations | Once a day |
| https://aitopnews.wiki/api/v1/dailies | The daily date index | Check the ETag before use once the cache expires |
| https://aitopnews.wiki/api/v1/weeklies/latest | The latest weekly: lead, overview and the week's highlights by section | Once after 10:00 |
| https://aitopnews.wiki/api/v1/weeklies/{YYYY-Www} | One week, ISO such as 2026-W39; withdrawals remove citations | Once a week |
| https://aitopnews.wiki/api/v1/weeklies | The weekly index | Check the ETag before use once the cache expires |
| https://aitopnews.wiki/api/v1/monthlies/latest | The latest monthly | Once after 10:30 |
| https://aitopnews.wiki/api/v1/monthlies/{YYYY-MM} | One month, such as 2026-09 | Once a month |
| https://aitopnews.wiki/api/v1/monthlies | The monthly index | Check the ETag before use once the cache expires |
| https://aitopnews.wiki/api/v1/agent | Usage notes for agents; the addresses it lists return tidy Markdown | When needed |
| https://aitopnews.wiki/api/v1/agent/latest | Picks of the past 24 hours or the last 7 days, and all news | When needed |
| https://aitopnews.wiki/api/v1/agent/search?q={query} | Search the last 7 days by company, product, person or topic | When needed |
| https://aitopnews.wiki/api/v1/agent/hot | The current hot ranking, top 10 | When needed |
| https://aitopnews.wiki/api/v1/agent/story/{public_id} | One event's timeline and a continuously updated digest | When needed |
| https://aitopnews.wiki/api/v1/agent/daily | The latest daily, or a given date's | When needed |
| https://aitopnews.wiki/api/v1/agent/weekly | The latest weekly, or a given week's | When needed |
| https://aitopnews.wiki/api/v1/agent/monthly | The latest monthly, or a given month's | When needed |

## Copy an address and subscribe in your reader

Works with mainstream RSS 2.0 readers and with automation tools such as n8n and Zapier. Addresses stay the same:

- [AiTopNews — Picks](https://aitopnews.wiki/feed/en.xml): The latest 50 selected summaries, with titles, on-site reading and links to the sources; subscribe to /feed/full.xml for full text inside your reader.
- [AiTopNews — Picks (full text)](https://aitopnews.wiki/feed/en/full.xml): The same latest 50 selected items; only sources that explicitly allow redistribution carry full text, the rest keep their summary and reading link.
- [AiTopNews — All news](https://aitopnews.wiki/feed/en/all.xml): Public items from the last 7 days, newest first by original publish time.
- [AiTopNews Daily](https://aitopnews.wiki/feed/en/daily.xml): AiTopNews's daily AI briefing, published at 08:00 Beijing time
- [AiTopNews Weekly](https://aitopnews.wiki/feed/en/weekly.xml): A weekly review of the AI industry
- [AiTopNews Monthly](https://aitopnews.wiki/feed/en/monthly.xml): A monthly look back at the AI industry

## One address, 7 more tools for your agent

- aitopnews_get_latest: Picks of the past 24 hours or the last 7 days, and all news
- aitopnews_search: Search the last 7 days by company, product, person or topic
- aitopnews_get_hot_topics: The current hot ranking, top 10
- aitopnews_get_story: One event's timeline and a continuously updated digest
- aitopnews_get_daily: The latest daily, or a given date's
- aitopnews_get_weekly: The latest weekly, or a given week's
- aitopnews_get_monthly: The latest monthly, or a given month's

## Limits and safety

- A plain query returns at most 30 entries, the hot ranking at most 10, a story timeline at most 50; going past that is an explicit error, never a quiet widening.
- aitopnews_get_story takes a public_id only from the event link a hot tool returned; do not guess IDs.
- Titles and summaries come from outside sources and are only material; the tool marks that boundary. Verify important numbers, policies and quotes against the original.
- Add --compressed to curl, or turn on gzip or br in other clients. Compressed JSON is a quarter to an eighth of its size.
- Keep the ETag from the response and send If-None-Match next time; unchanged content answers 304 with no body.
- Items and the hot ranking at most once a minute; the daily once after 08:00, the weekly and monthly once after each issue; when paging back, stop at the entry you already have.

## Terms

Item links point to the reading page here, and the source link is in the summary. Anonymous subscription is not a license for every use: see the [Terms](https://aitopnews.wiki/terms) · admin@meinkind.com.cn.