AIHOT Dailies API
The Dailies API from AIHOT — 3 operation(s) for dailies.
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-dailies-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 Dailies 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: Dailies
paths:
/api/v1/dailies:
get:
operationId: dailies
summary: List daily-report archive entries
description: Date index of past daily reports, newest first. Reports are published once a day at {{dailyTime}} Asia/Shanghai, so checking this more than a few times a day is wasted work.
parameters:
- $ref: '#/components/parameters/ActorUserAgent'
- $ref: '#/components/parameters/IfNoneMatch'
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 180
default: 30
responses:
'200':
description: OK
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DailiesResponse'
'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:
- Dailies
/api/v1/dailies/latest:
get:
operationId: latestDaily
summary: Get the latest daily report
description: The most recent daily report, published once a day at {{dailyTime}} Asia/Shanghai. A client that only wants the daily digest should wake up shortly after {{dailyTime}} rather than poll around the clock. Agent or tool runtimes that cache a stable URL beyond HTTP cache headers should first request /api/v1/dailies?limit=1 and then fetch /api/v1/dailies/{returned-date}; never guess a date.
responses:
'200':
description: OK
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DailyResponse'
'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:
- Dailies
/api/v1/dailies/{date}:
get:
operationId: dailyByDate
summary: Get a daily report by Shanghai calendar date
description: A single past daily report by Asia/Shanghai calendar date (YYYY-MM-DD). Each date identifies a fixed edition, but corrections and withdrawn citations can change its public content. 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: date
in: path
required: true
schema:
type: string
format: date
responses:
'200':
description: OK
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/DailyResponse'
'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:
- Dailies
components:
schemas:
DailiesResponse:
type: object
required:
- schemaVersion
- count
- items
properties:
schemaVersion:
const: 1
count:
type: integer
minimum: 0
items:
type: array
items:
$ref: '#/components/schemas/DailyEntry'
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).
DailyReport:
type: object
required:
- date
- generatedAt
- windowStart
- windowEnd
- links
- lead
- sections
- flashes
properties:
date:
type: string
format: date
generatedAt:
type: string
format: date-time
windowStart:
type: string
format: date-time
windowEnd:
type: string
format: date-time
links:
type: object
required:
- aihot
properties:
aihot:
type: string
format: uri
attribution:
$ref: '#/components/schemas/Attribution'
lead:
anyOf:
- type: object
required:
- title
- leadParagraph
properties:
title:
type: string
leadParagraph:
type: string
- type: 'null'
sections:
type: array
items:
type: object
required:
- label
- items
properties:
label:
type: string
items:
type: array
items:
type: object
required:
- title
- summary
- source
- links
properties:
title:
type: string
summary:
type: string
source:
type: object
required:
- name
properties:
name:
type: string
links:
$ref: '#/components/schemas/DailyContentLinks'
attribution:
$ref: '#/components/schemas/Attribution'
flashes:
type: array
items:
type: object
required:
- title
- source
- links
- publishedAt
properties:
title:
type: string
source:
type: object
required:
- name
properties:
name:
type: string
links:
$ref: '#/components/schemas/DailyContentLinks'
publishedAt:
type: string
format: date-time
description: When the original was published; if the original carries no reliable publication date, when it was collected instead.
attribution:
$ref: '#/components/schemas/Attribution'
DailyResponse:
type: object
required:
- schemaVersion
- report
properties:
schemaVersion:
const: 1
report:
$ref: '#/components/schemas/DailyReport'
DailyContentLinks:
type: object
required:
- aihot
- original
properties:
aihot:
type:
- string
- 'null'
format: uri
original:
type: string
format: uri
DailyEntry:
type: object
required:
- date
- generatedAt
- leadTitle
- leadParagraph
- links
properties:
date:
type: string
format: date
generatedAt:
type: string
format: date-time
leadTitle:
type:
- string
- 'null'
leadParagraph:
type:
- string
- 'null'
links:
type: object
required:
- aihot
properties:
aihot:
type: string
format: uri
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'