Connect Education Frontier Observer to your agent
Use one of 3 ways to access the same data: featured stories, trends, and daily, weekly, and monthly briefings. Anonymous and read-only; no account or API key required.
This guide is in English. Public Agent Markdown and API responses are currently in Chinese.
Anonymous GET requests, ready to use
No token is required. Call the API from browsers, curl, or standard HTTP clients. The base path is /api/v1; see the OpenAPI specification for fields and error codes. Public API responses and Agent instructions are currently in Chinese.
curl --compressed 'https://edufrontwatch.org/api/v1/items?mode=selected&window=24h&limit=20'Filter by category
Add category to an updates request to select a category; omit it to include all categories. Returned items use the same category values shown below.
| Category | Request parameters |
|---|---|
| Education watch | category=education-policy |
| Technology & education | category=education-technology |
| Research frontiers | category=education-research |
| Evidence & practice | category=evidence-practice |
Save bandwidth and time
- 01Enable compression
Use
--compressed; enable gzip or br in other clients. Compressed JSON is typically one-quarter to one-eighth of its original size. - 02Send the ETag
Save the response's ETag and send it next time with
If-None-Match. If nothing has changed, the server returns 304 without a response body. - 03Poll at a sensible pace
Updates and trending can be checked once per minute at most. Briefings have no fixed publication schedule; check the latest endpoints or feeds for new issues. When paging back, stop once you reach an item you already have.
Collection continues to run. Public briefings are available through their API endpoints and RSS feeds after editorial review and publication; there is no fixed publication schedule.
API reference
| Path | Purpose | Suggested frequency |
|---|---|---|
| Updates | ||
/api/v1/items | Featured items or all updates from the past 7 days; filter by category, time window, or keyword | At most once per minute |
| Trending & events | ||
/api/v1/hot-topics | The current top 10 trending topics | At most once per minute |
/api/v1/stories/{publicId} | An event's coverage timeline, AI overview, and related stories | When needed |
| Daily | ||
/api/v1/dailies/latest | The latest daily briefing | After a new issue is reviewed and published |
/api/v1/dailies/{date} | A daily briefing for a given date; withdrawn stories are removed | Validate the ETag before use after the cache expires |
/api/v1/dailies | Daily briefing date index | As needed |
| Weekly & monthly briefings | ||
/api/v1/weeklies/latest | The latest weekly briefing: lead stories, overview, and weekly highlights grouped by section | After a new issue is reviewed and published |
/api/v1/weeklies/{week} | A specific ISO week, such as 2026-W39; withdrawn stories are removed | Validate the ETag before use after the cache expires |
/api/v1/weeklies | Weekly briefing index | As needed |
/api/v1/monthlies/latest | The latest monthly briefing | After a new issue is reviewed and published |
/api/v1/monthlies/{month} | A specific month, such as 2026-09 | Validate the ETag before use after the cache expires |
/api/v1/monthlies | Monthly briefing index | As needed |
| For AI assistants | ||
/api/v1/agent | Agent guide; the listed endpoints currently return Chinese Markdown | When needed |
| Full featured sync | ||
/api/v1/selected/snapshot | The current full set of featured items, fetched page by page | Once, on initial sync |
/api/v1/selected/changes | Additions, edits, and removals after the initial sync | Every few minutes |
Common patterns
# First request: save the ETag response header
curl --compressed -i 'https://edufrontwatch.org/api/v1/items?mode=selected&window=24h&limit=20'
# Then poll at most once per minute with the ETag; 304 means unchanged
curl --compressed -i -H 'If-None-Match: <previous ETag>' 'https://edufrontwatch.org/api/v1/items?mode=selected&window=24h&limit=20'For older pages, send page.nextCursor back as cursor and stop when you reach an item you already have. Do not re-fetch the same seven-day window each time.
Troubleshooting
- 400
- Invalid parameters: check OpenAPI and the returned error code. Do not silently broaden the query. If cursor is invalid or outside the time window, restart from the first page.
- 409
- snapshot_required: the incremental sync cannot continue safely. Fetch a new full snapshot.
- 429
- Too many requests: wait for Retry-After and do not retry concurrently.
- 5xx
- Use exponential backoff and keep the last successful result. The public service has no SLA.
Anonymous access does not grant permission for every use; see the Terms of use.