Skip to content
Live
AGENT ACCESS

Connect StarHOT to your tools

Skill, MCP, RSS and API all give you the same stories: featured picks, trending, and the daily, weekly and monthly briefs. Pick whichever fits your tools — no sign-up and no API key.

All systems normalVersion 4.0.0Read-only · no key
EasiestAgent SkillSend one sentence, then just askMCPAdd one URL, get 10 toolsRSSCopy a URL into your feed readerREST APIAnonymous GET for your own code
REST API · 4.0.0

Anonymous GET, ready to use

No token needed; browsers, curl and any HTTP client can call it directly. The base path is /api/v1; fields and error codes are defined in the OpenAPI .

First request
curl --compressed 'https://www.starhot.space/api/v1/items?mode=selected&window=24h&limit=20'

Lighter and faster

  1. 01
    Turn on compression

    Add --compressed to curl, or enable gzip/br in your client. Compressed JSON is 1/4 to 1/8 the size.

  2. 02
    Send the ETag

    Save the ETag and send it back as If-None-Match; unchanged content returns a 304 with no body.

  3. 03
    Poll at the right pace

    Stories and trending at most once a minute; briefs once after each issue; stop paging back when you reach an item you already have.

New stories arrive all day; featured picks change several to dozens of times a day; the daily, weekly and monthly briefs come out on their schedule.

Endpoints

PathWhat it’s forHow often
Stories
/api/v1/itemsFeatured or all updates from the last 7 days, filterable by category, window and keywordAt most once a minute
Trending and stories
/api/v1/hot-topicsThe current trending top 10At most once a minute
/api/v1/stories/{publicId}A story’s report timeline, AI overview and related storiesAs needed
Daily brief
/api/v1/dailies/latestThe latest daily briefOnce after each issue
/api/v1/dailies/{date}A given day’s brief; withdrawn items are removedRevalidate with the ETag once your cache expires
/api/v1/dailiesDaily indexOnce a day
Weekly and monthly
/api/v1/weeklies/latestThe latest weekly round-up, by sectionOnce after each issue
/api/v1/weeklies/{week}A given ISO week, e.g. 2026-W39; withdrawn items are removedRevalidate with the ETag once your cache expires
/api/v1/weekliesWeekly indexOnce a week
/api/v1/monthlies/latestThe latest monthly round-upOnce after each issue
/api/v1/monthlies/{month}A given month, e.g. 2026-09Revalidate with the ETag once your cache expires
/api/v1/monthliesMonthly indexOnce a month
For AI assistants
/api/v1/agentInstructions for agents, with ready-to-read MarkdownAs needed
Full featured sync
/api/v1/selected/snapshotAll current featured stories, paged in one passFirst time only
/api/v1/selected/changesAdditions, edits and removals since thenEvery few minutes

Common recipes

bash
# First call: save the ETag header
curl --compressed -i 'https://www.starhot.space/api/v1/items?mode=selected&window=24h&limit=20'
# Then at most once a minute, send the ETag; 304 means nothing changed
curl --compressed -i -H 'If-None-Match: <last ETag>' 'https://www.starhot.space/api/v1/items?mode=selected&window=24h&limit=20'

To page back, pass page.nextCursor back as the cursor, and stop when you reach an item you already have — don’t re-read all 7 days each time.

When something goes wrong

400
Bad parameters: fix them using the OpenAPI spec and the returned code — don’t silently widen the query. An invalid or expired cursor returns invalid_cursor; start again from page one.
409
snapshot_required: changes can’t safely continue — fetch a full snapshot again.
429
Too many requests: wait for Retry-After and don’t retry in parallel.
5xx
Back off exponentially and use your last good result; the public service has no SLA.

Anonymous access doesn’t grant every use — see the Terms of use.