Stories and lists of stories.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/hangingcontext-com:hangingcontext-com-stories-api"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.
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: 3.2.0
info:
title: Hanging Context public read Stories API
version: 1.0.0
summary: Free, keyless JSON, Markdown and feeds for Hanging Context stories.
description: 'Hanging Context publishes fresh context for agents. Stories are rebuilt every 12 hours. Each claim cites a Synorb Manifest. Every endpoint here is a read. No key is necessary. The same stories are also available through the MCP server at https://hangingcontext.com/mcp. Version policy: Breaking changes ship as a new version. We announce them at least 90 days ahead with Deprecation and Sunset response headers on the old version, and on the /developers page. Paging uses a cursor. Each REST list holds every story of its window, so the REST files have no cursor. To get only the stories that are new since your last call, call the MCP tool hc_since. It returns next_cursor and has_more, and you send next_cursor in your next call. Rate limit: 60 calls per 60 seconds per IP address for /ask and MCP tool calls.'
termsOfService: https://hangingcontext.com/terms/reuse/
contact:
name: Hanging Context
email: team@synorb.com
url: https://hangingcontext.com/contact/
license:
name: Hanging Context reuse terms
url: https://hangingcontext.com/terms/reuse/
x-api-version: '1'
x-sdks:
- ecosystem: npm
language: JavaScript
package: hanging-context
version: 0.1.0
url: https://www.npmjs.com/package/hanging-context
install: npm install hanging-context
cli: hanging-context
- ecosystem: pypi
language: Python
package: hanging-context
version: 0.1.0
url: https://pypi.org/project/hanging-context/
install: pip install hanging-context
cli: hanging-context
x-pagination:
style: cursor
tool: hc_since
cursor_field: next_cursor
more_field: has_more
note: Paging uses a cursor. Each REST list holds every story of its window, so the REST files have no cursor. To get only the stories that are new since your last call, call the MCP tool hc_since. It returns next_cursor and has_more, and you send next_cursor in your next call.
servers:
- url: https://hangingcontext.com
description: Production
security: []
tags:
- name: Stories
description: Stories and lists of stories.
paths:
/editions/latest.json:
get:
operationId: getLatestStories
tags:
- Stories
summary: Get the latest stories
description: Get the stories from the last 12 hours and the last 24 hours. The reply also lists the topics and the feed URLs.
responses:
'200':
description: The latest stories.
content:
application/json:
schema:
$ref: '#/components/schemas/LatestStories'
headers:
HC-API-Version:
$ref: '#/components/headers/HC-API-Version'
'404':
description: No such file. The body is JSON, Markdown or HTML, chosen by the Accept header.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
text/markdown:
schema:
type: string
text/html:
schema:
type: string
parameters:
- $ref: '#/components/parameters/ApiVersion'
/n/{topic}/index.json:
get:
operationId: getTopicStories
tags:
- Stories
summary: Get the stories of one topic
description: Get the recent stories of one topic, newest first.
parameters:
- $ref: '#/components/parameters/ApiVersion'
- name: topic
in: path
required: true
description: Topic slug. Get the slugs from the id of each topic in /editions/latest.json.
schema:
type: string
pattern: ^[a-z0-9-]+$
example: artificial-intelligence
responses:
'200':
description: Stories in the topic.
content:
application/json:
schema:
$ref: '#/components/schemas/StoryList'
headers:
HC-API-Version:
$ref: '#/components/headers/HC-API-Version'
'404':
description: No such file. The body is JSON, Markdown or HTML, chosen by the Accept header.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
text/markdown:
schema:
type: string
text/html:
schema:
type: string
/stories/{date}/{slug}/index.json:
get:
operationId: getStory
tags:
- Stories
summary: Get one story as JSON
description: Get one story with its sections, key facts and cited Manifests.
parameters:
- $ref: '#/components/parameters/ApiVersion'
- name: date
in: path
required: true
description: Story date in UTC, as YYYY-MM-DD.
schema:
type: string
format: date
example: '2026-10-15'
- name: slug
in: path
required: true
description: Story slug, from the url field of a story list.
schema:
type: string
pattern: ^[a-z0-9-]{3,80}$
responses:
'200':
description: The story.
content:
application/json:
schema:
$ref: '#/components/schemas/Story'
headers:
HC-API-Version:
$ref: '#/components/headers/HC-API-Version'
'404':
description: No such file. The body is JSON, Markdown or HTML, chosen by the Accept header.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
text/markdown:
schema:
type: string
text/html:
schema:
type: string
/stories/{date}/{slug}/index.md:
get:
operationId: getStoryMarkdown
tags:
- Stories
summary: Get one story as Markdown
description: Get one story as Markdown. Each paragraph cites Manifest ids.
parameters:
- $ref: '#/components/parameters/ApiVersion'
- name: date
in: path
required: true
description: Story date in UTC, as YYYY-MM-DD.
schema:
type: string
format: date
example: '2026-10-15'
- name: slug
in: path
required: true
description: Story slug, from the url field of a story list.
schema:
type: string
pattern: ^[a-z0-9-]{3,80}$
responses:
'200':
description: The story as Markdown.
content:
text/markdown:
schema:
type: string
headers:
HC-API-Version:
$ref: '#/components/headers/HC-API-Version'
'404':
description: No such file. The body is JSON, Markdown or HTML, chosen by the Accept header.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
text/markdown:
schema:
type: string
text/html:
schema:
type: string
/roundups/index.json:
get:
operationId: listRoundups
tags:
- Stories
summary: List the roundups
description: List the recent roundups. A roundup groups related stories.
responses:
'200':
description: The recent roundups.
content:
application/json:
schema:
$ref: '#/components/schemas/RoundupList'
headers:
HC-API-Version:
$ref: '#/components/headers/HC-API-Version'
'404':
description: No such file. The body is JSON, Markdown or HTML, chosen by the Accept header.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
text/markdown:
schema:
type: string
text/html:
schema:
type: string
parameters:
- $ref: '#/components/parameters/ApiVersion'
components:
schemas:
LatestStories:
type: object
description: The latest stories, the topics and the feeds.
required:
- stories
- generated_at
properties:
description:
type: string
generated_at:
type: string
format: date-time
stories:
type: array
items:
$ref: '#/components/schemas/StorySummary'
published_last_24h:
type: array
items:
$ref: '#/components/schemas/StorySummary'
newsrooms:
type: array
description: The topics. Use id as the topic slug.
items:
type: object
properties:
id:
type: string
title:
type: string
url:
type: string
format: uri
json:
type: string
format: uri
description:
type: string
additionalProperties: true
feeds:
type: object
additionalProperties:
type: string
format: uri
additionalProperties: true
RoundupList:
type: object
description: The recent roundups. A roundup groups related stories.
required:
- roundups
properties:
schema:
type: string
type:
type: string
generated_at:
type: string
format: date-time
roundups:
type: array
items:
type: object
required:
- title
- url
- scope
- published_at
properties:
title:
type: string
dek:
type: string
url:
type: string
format: uri
json:
type: string
format: uri
scope:
type: object
description: What the roundup covers. The type is topic, beat or topics.
properties:
type:
type: string
label:
type: string
additionalProperties: true
edition:
type: string
published_at:
type: string
format: date-time
story_count:
type: integer
additionalProperties: true
additionalProperties: true
StorySummary:
type: object
description: A story in a list.
required:
- slug
- url
- headline
- published_at
properties:
slug:
type: string
url:
type: string
format: uri
json:
type: string
format: uri
markdown:
type: string
format: uri
headline:
type: string
dek:
type: string
beat:
type:
- string
- 'null'
published_at:
type: string
format: date-time
trust:
type: string
source_count:
type: integer
cited_manifest_ids:
type: array
items:
type: string
additionalProperties: true
ReuseTerms:
type: object
description: The reuse terms for stories.
properties:
version:
type: string
summary:
type: string
attribution:
type: string
link_rule:
type: string
keep_ids_rule:
type: string
no_endorsement:
type: string
license_url:
type: string
format: uri
machine_url:
type: string
format: uri
additionalProperties: true
Story:
type: object
description: One story with the Manifests it cites.
required:
- slug
- url
- headline
- published_at
- sections
- cited_manifest_ids
properties:
slug:
type: string
url:
type: string
format: uri
headline:
type: string
dek:
type: string
published_at:
type: string
format: date-time
key_facts:
type: array
items:
type: object
properties:
text:
type: string
manifest_ids:
type: array
items:
type: string
additionalProperties: true
sections:
type: array
items:
type: object
additionalProperties: true
unresolved:
type: array
items:
type: string
cited_manifest_ids:
type: array
items:
type: string
manifests:
type: array
items:
type: object
additionalProperties: true
reuse:
$ref: '#/components/schemas/ReuseTerms'
additionalProperties: true
Error:
type: object
description: The JSON error body.
required:
- error
- message
properties:
error:
type: string
description: A short error code.
example: empty_question
message:
type: string
description: What is wrong.
next_step:
type: string
description: What to do next.
retry_after:
type: integer
description: Seconds to wait. Only for code 429.
StoryList:
type: object
description: A list of stories.
required:
- stories
properties:
schema:
type: string
type:
type: string
id:
type:
- string
- 'null'
title:
type:
- string
- 'null'
generated_at:
type: string
format: date-time
story_count:
type: integer
stories:
type: array
items:
$ref: '#/components/schemas/StorySummary'
additionalProperties: true
parameters:
ApiVersion:
name: HC-API-Version
in: header
required: false
description: The API version you expect. Version 1 is the only version today. Every response carries the HC-API-Version header.
schema:
type: string
enum:
- '1'
default: '1'
headers:
HC-API-Version:
description: The API version of this response.
schema:
type: string
example: '1'
externalDocs:
description: 'Hanging Context developers: the MCP server, the SDKs and the CLI, rate limits and errors.'
url: https://hangingcontext.com/developers/