Skip to content
AGENT ACCESS

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.

Service onlineVersion 4.0.0Anonymous read-only · No key required
REST API · 4.0.0

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.

Your first request
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.

CategoryRequest parameters
Modelscategory=ai-models
Productscategory=ai-products
Industrycategory=industry
China AI Watchcategory=china-ai
Researchcategory=paper
How-tocategory=tip
Opinioncategory=opinion

Efficient access

  1. 01
    Enable 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.

  2. 02
    Send ETag

    Save the response ETag and send If-None-Matchnext time. Unchanged content returns 304 without a body.

  3. 03
    Poll 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

PathPurposeFrequency
news
/api/v1/itemsSelected items or all news from the past 7 days, filtered by category, time or keywordsAt most once per minute
Trending and stories
/api/v1/hot-topicsTop 10 trending storiesAt most once per minute
/api/v1/stories/{publicId}Story timeline, AI digest and related storiesAs needed
Daily
/api/v1/dailies/latestLatest daily editionOnce after Daily at 07:30 Beijing time
/api/v1/dailies/{date}Daily edition by date; withdrawn references are removedValidate ETag before use after cache expiry
/api/v1/dailiesDaily date indexOnce daily
Weekly and monthly editions
/api/v1/weeklies/latestLatest weekly: lead, overview and weekly highlights by sectionOnce after Mondays at 09:00 Beijing time
/api/v1/weeklies/{week}Specific ISO week, e.g. 2026-W39; withdrawn references are removedValidate ETag before use after cache expiry
/api/v1/weekliesWeekly indexOnce weekly
/api/v1/monthlies/latestLatest monthly editionOnce after On the first of each month at 09:30 Beijing time
/api/v1/monthlies/{month}Specific month, e.g. 2026-09Validate ETag before use after cache expiry
/api/v1/monthliesMonthly indexOnce monthly
For AI assistants
/api/v1/agentAgent instructions with endpoints returning structured Chinese MarkdownAs needed
Complete selection sync
/api/v1/selected/snapshotAll current selections, retrieved through paginationFirst time only
/api/v1/selected/changesSubsequent additions, changes and removalsEvery few minutes

Common workflows

bash
# 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。