Connect AI Gazz to your agent
All 3 connection methods (MCP, RSS, API) read the same selections, trending stories and daily, weekly and monthly editions. Choose one for your tools. Anonymous, read-only, no account or API key required.
Anonymous GET, ready to use
No token required. Use browser cross-origin requests, curl or any HTTP client. The base path is /api/v1; fields and errors are defined in OpenAPI.
curl --compressed 'https://aigazz.com/api/v1/items?mode=selected&window=24h&limit=20'Filter by category
Add categoryto news requests to filter a category; omit it for all categories. Returned items use categorywith the values below.
| Category | Request parameters |
|---|---|
| Models | category=ai-models |
| Products | category=ai-products |
| Industry | category=industry |
| China AI Watch | category=china-ai |
| Research | category=paper |
| How-to | category=tip |
| Opinion | category=opinion |
Efficient access
- 01Enable compression
Add to curl:
--compressed; enable gzip or br in other clients. Compressed JSON is typically 1/4 to 1/8 of its original size. - 02Send ETag
Save the response ETag and send
If-None-Matchnext time. Unchanged content returns 304 without a body. - 03Poll sensibly
Poll news and trending at most once per minute; fetch the daily after Daily at 07:30 Beijing time, and weekly/monthly after publication. Stop paging at an item you already have.
News arrives throughout the day and selections update several times daily. Editions: daily Daily at 07:30 Beijing time, weekly Mondays at 09:00 Beijing time, monthly On the first of each month at 09:30 Beijing time.
Endpoints
| Path | Purpose | Frequency |
|---|---|---|
| news | ||
/api/v1/items | Selected items or all news from the past 7 days, filtered by category, time or keywords | At most once per minute |
| Trending and stories | ||
/api/v1/hot-topics | Top 10 trending stories | At most once per minute |
/api/v1/stories/{publicId} | Story timeline, AI digest and related stories | As needed |
| Daily | ||
/api/v1/dailies/latest | Latest daily edition | Once after Daily at 07:30 Beijing time |
/api/v1/dailies/{date} | Daily edition by date; withdrawn references are removed | Validate ETag before use after cache expiry |
/api/v1/dailies | Daily date index | Once daily |
| Weekly and monthly editions | ||
/api/v1/weeklies/latest | Latest weekly: lead, overview and weekly highlights by section | Once after Mondays at 09:00 Beijing time |
/api/v1/weeklies/{week} | Specific ISO week, e.g. 2026-W39; withdrawn references are removed | Validate ETag before use after cache expiry |
/api/v1/weeklies | Weekly index | Once weekly |
/api/v1/monthlies/latest | Latest monthly edition | Once after On the first of each month at 09:30 Beijing time |
/api/v1/monthlies/{month} | Specific month, e.g. 2026-09 | Validate ETag before use after cache expiry |
/api/v1/monthlies | Monthly index | Once monthly |
| For AI assistants | ||
/api/v1/agent | Agent instructions with endpoints returning structured Chinese Markdown | As needed |
| Complete selection sync | ||
/api/v1/selected/snapshot | All current selections, retrieved through pagination | First time only |
/api/v1/selected/changes | Subsequent additions, changes and removals | Every few minutes |
Common workflows
# First request: save the ETag response header
curl --compressed -i 'https://aigazz.com/api/v1/items?mode=selected&window=24h&limit=20'
# Then at most once per minute; 304 means unchanged
curl --compressed -i -H 'If-None-Match: <previous ETag>' 'https://aigazz.com/api/v1/items?mode=selected&window=24h&limit=20'To page backwards, send page.nextCursoras the cursor. Stop at an item you already have rather than downloading all 7 days again.
Handling errors
- 400
- Correct parameters using OpenAPI and the returned code. Do not silently broaden queries. An invalid or out-of-window cursor returns invalid_cursor; restart at the first page.
- 409
- snapshot_required: incremental sync cannot safely resume. Fetch a new full snapshot.
- 429
- Rate limited: respect Retry-After and avoid concurrent retries.
- 5xx
- Use exponential backoff and the last successful result. The public service has no SLA.
Anonymous access does not authorize all uses; seeTerms of use。