AIHOT Weeklies API
The Weeklies API from AIHOT — 3 operation(s) for weeklies.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/aihot-news:aihot-news-weeklies-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: '{{siteName}} Public Weeklies API'
version: '{{version}}'
description: 'Anonymous, read-only API for clients and Agents. No API key is required.
Picking an endpoint: answer a person''s question inside an AI agent -> read /api/v1/agent, which lists Markdown addresses made for agents. Show recent or today''s items -> /api/v1/items. Show what is trending right now -> /api/v1/hot-topics. Show the daily digest -> /api/v1/dailies/latest; the weekly and monthly reports -> /api/v1/weeklies/latest and /api/v1/monthlies/latest. Keep a complete local copy of the selected set -> /api/v1/selected/snapshot once, then /api/v1/selected/changes forever.
How often to poll: use each response''s Cache-Control s-maxage as the minimum interval, and always send If-None-Match: an unchanged resource answers 304 with an empty body. On 429 or 503, honour Retry-After. There is no push channel (no SSE, webhooks or streaming): poll on an interval.
Keep responses small: send Accept-Encoding: gzip or br (curl --compressed). To follow new items, page back only until you reach an id you already have instead of re-reading the whole 7-day window on every poll; to keep every selected item, read /api/v1/selected/snapshot once and then only /api/v1/selected/changes.
Report dates, weeks and months identify fixed editions, but corrections and withdrawn citations can change their public content. Revalidate retained copies with If-None-Match after Cache-Control expires; do not treat a dated report as immutable.
Titles and summaries are generated from third-party sources; the original is always linked in links.original.'
termsOfService: '{{siteUrl}}/terms'
servers:
- url: '{{siteUrl}}'
tags:
- name: Weeklies
paths:
/api/v1/weeklies:
get:
operationId: weeklies
summary: List weekly reports
description: 'Index of published weekly reports, newest first: ISO week, its Monday-to-Sunday days, headline and {{siteName}} link. A weekly is published each Monday at {{weeklyTime}} Asia/Shanghai, compiled from the dailies dated in that week, so checking more than once a day is wasted work.'
parameters:
- $ref: '#/components/parameters/ActorUserAgent'
- $ref: '#/components/parameters/IfNoneMatch'
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 60
default: 12
responses:
'200':
description: OK
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/WeekliesResponse'
'304':
description: Not Modified
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
'400':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'403':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'405':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'429':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
Retry-After:
description: Minimum number of seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'503':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
Retry-After:
description: Minimum number of seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
tags:
- Weeklies
/api/v1/weeklies/latest:
get:
operationId: latestWeekly
summary: Get the latest weekly report
description: 'The most recent weekly report: its headline, overview and the week''s most important items grouped by section, chosen from that week''s dailies. Published each Monday at {{weeklyTime}} Asia/Shanghai; a client that wants the weekly digest should fetch it shortly after that rather than poll. Agent or tool runtimes that cache a stable URL beyond HTTP cache headers should first request /api/v1/weeklies?limit=1 and then /api/v1/weeklies/{returned-week}; never guess a week.'
responses:
'200':
description: OK
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/WeeklyResponse'
'304':
description: Not Modified
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
'400':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'403':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'404':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'405':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'429':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
Retry-After:
description: Minimum number of seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'503':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
Retry-After:
description: Minimum number of seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
parameters:
- $ref: '#/components/parameters/ActorUserAgent'
- $ref: '#/components/parameters/IfNoneMatch'
tags:
- Weeklies
/api/v1/weeklies/{week}:
get:
operationId: weeklyByWeek
summary: Get a weekly report by ISO week
description: A single weekly report by ISO week label (YYYY-Www, for example 2026-W39). Corrections and withdrawn citations can change the public content of this edition. Respect Cache-Control and revalidate with If-None-Match before reusing an expired copy; do not cache a report indefinitely.
parameters:
- $ref: '#/components/parameters/ActorUserAgent'
- $ref: '#/components/parameters/IfNoneMatch'
- name: week
in: path
required: true
schema:
type: string
pattern: ^\d{4}-W\d{2}$
description: ISO week label, e.g. 2026-W39.
responses:
'200':
description: OK
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/WeeklyResponse'
'304':
description: Not Modified
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
'400':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'403':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'404':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'405':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'429':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
Retry-After:
description: Minimum number of seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
'503':
description: Machine-readable problem response.
headers:
X-Request-Id:
description: Support correlation identifier for this failed request.
schema:
type: string
Retry-After:
description: Minimum number of seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
tags:
- Weeklies
components:
schemas:
WeeklyReport:
allOf:
- $ref: '#/components/schemas/PeriodReport'
- type: object
required:
- week
properties:
week:
type: string
pattern: ^\d{4}-W\d{2}$
Problem:
type: object
required:
- type
- title
- status
- detail
- code
- requestId
properties:
type:
type: string
title:
type: string
status:
type: integer
detail:
type: string
code:
type: string
requestId:
type: string
retryAfter:
type: integer
minimum: 1
description: Minimum number of seconds to wait before retrying (present on 429 and 503 responses).
WeeklyResponse:
type: object
required:
- schemaVersion
- report
properties:
schemaVersion:
const: 1
report:
$ref: '#/components/schemas/WeeklyReport'
WeeklyEntry:
allOf:
- $ref: '#/components/schemas/PeriodEntry'
- type: object
required:
- week
properties:
week:
type: string
pattern: ^\d{4}-W\d{2}$
description: ISO week label, e.g. 2026-W39.
PeriodEntry:
type: object
required:
- periodStart
- periodEnd
- generatedAt
- headline
- links
properties:
periodStart:
type:
- string
- 'null'
format: date
description: First calendar day the issue covers (Asia/Shanghai).
periodEnd:
type:
- string
- 'null'
format: date
description: Last calendar day the issue covers (Asia/Shanghai).
generatedAt:
type: string
format: date-time
headline:
type:
- string
- 'null'
description: 'The issue''s lead: its most important item''s title, or once that item is withdrawn the next one still public (older issues may carry their own headline).'
links:
type: object
required:
- aihot
properties:
aihot:
type: string
format: uri
attribution:
$ref: '#/components/schemas/Attribution'
DailyContentLinks:
type: object
required:
- aihot
- original
properties:
aihot:
type:
- string
- 'null'
format: uri
original:
type: string
format: uri
WeekliesResponse:
type: object
required:
- schemaVersion
- count
- items
properties:
schemaVersion:
const: 1
count:
type: integer
minimum: 0
items:
type: array
items:
$ref: '#/components/schemas/WeeklyEntry'
PeriodReport:
type: object
required:
- periodStart
- periodEnd
- generatedAt
- windowStart
- windowEnd
- links
- headline
- overview
- sections
properties:
periodStart:
type:
- string
- 'null'
format: date
periodEnd:
type:
- string
- 'null'
format: date
generatedAt:
type: string
format: date-time
windowStart:
type: string
format: date-time
description: Start of the dailies' windows the issue was compiled from.
windowEnd:
type: string
format: date-time
links:
type: object
required:
- aihot
properties:
aihot:
type: string
format: uri
attribution:
$ref: '#/components/schemas/Attribution'
headline:
type:
- string
- 'null'
description: The most important item's title, or once that item is withdrawn the next one still public (older issues may carry their own headline).
overview:
type:
- string
- 'null'
description: A short overview of the period's main threads, written only from the items listed.
sections:
type: array
description: Sections in reading order, each with its items in order of importance. Withdrawn items are left out.
items:
type: object
required:
- label
- summary
- items
properties:
label:
type: string
summary:
type:
- string
- 'null'
description: One or two sentences introducing the section, when there is one.
items:
type: array
items:
type: object
required:
- title
- summary
- source
- links
- publishedAt
properties:
title:
type: string
summary:
type: string
source:
type: object
required:
- name
properties:
name:
type: string
links:
$ref: '#/components/schemas/DailyContentLinks'
publishedAt:
type:
- string
- 'null'
format: date-time
attribution:
$ref: '#/components/schemas/Attribution'
Attribution:
type: object
description: Machine-readable {{siteName}} provenance for traceability. Retain it where technically feasible. Attribution alone is not authorization; see the public terms.
required:
- name
- url
properties:
name:
type: string
url:
type: string
format: uri
parameters:
IfNoneMatch:
name: If-None-Match
in: header
required: false
description: Previously received ETag for this exact URL. A match returns 304 without a response body.
schema:
type: string
ActorUserAgent:
name: User-Agent
in: header
required: false
description: The client's normal User-Agent (optional; any value works).
schema:
type: string
maxLength: 2048
example: my-reader/1.0
externalDocs:
description: Machine-readable OpenAPI document
url: '{{siteUrl}}/openapi-v1.json'