Skip to content
Interface language
AGENT ACCESS

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.

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

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.

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

CategoryRequest parameters
Education watchcategory=education-policy
Technology & educationcategory=education-technology
Research frontierscategory=education-research
Evidence & practicecategory=evidence-practice

Save bandwidth and time

  1. 01
    Enable compression

    Use --compressed; enable gzip or br in other clients. Compressed JSON is typically one-quarter to one-eighth of its original size.

  2. 02
    Send 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.

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

PathPurposeSuggested frequency
Updates
/api/v1/itemsFeatured items or all updates from the past 7 days; filter by category, time window, or keywordAt most once per minute
Trending & events
/api/v1/hot-topicsThe current top 10 trending topicsAt most once per minute
/api/v1/stories/{publicId}An event's coverage timeline, AI overview, and related storiesWhen needed
Daily
/api/v1/dailies/latestThe latest daily briefingAfter a new issue is reviewed and published
/api/v1/dailies/{date}A daily briefing for a given date; withdrawn stories are removedValidate the ETag before use after the cache expires
/api/v1/dailiesDaily briefing date indexAs needed
Weekly & monthly briefings
/api/v1/weeklies/latestThe latest weekly briefing: lead stories, overview, and weekly highlights grouped by sectionAfter a new issue is reviewed and published
/api/v1/weeklies/{week}A specific ISO week, such as 2026-W39; withdrawn stories are removedValidate the ETag before use after the cache expires
/api/v1/weekliesWeekly briefing indexAs needed
/api/v1/monthlies/latestThe latest monthly briefingAfter a new issue is reviewed and published
/api/v1/monthlies/{month}A specific month, such as 2026-09Validate the ETag before use after the cache expires
/api/v1/monthliesMonthly briefing indexAs needed
For AI assistants
/api/v1/agentAgent guide; the listed endpoints currently return Chinese MarkdownWhen needed
Full featured sync
/api/v1/selected/snapshotThe current full set of featured items, fetched page by pageOnce, on initial sync
/api/v1/selected/changesAdditions, edits, and removals after the initial syncEvery few minutes

Common patterns

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