Gameshot Stories API
The Stories API from Gameshot — 1 operation(s) for stories.
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/gameshot-games:gameshot-games-stories-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: Gameshot Games Stories API
version: 3.0.0
termsOfService: https://gameshot.games/terms
description: 'Operations tagged Stories across 2 of this provider''s published API definitions: gameshot-games-openapi.json, openapi-v1.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://gameshot.games
tags:
- name: Stories
paths:
/api/v1/stories/{publicId}:
get:
operationId: storyByPublicId
summary: Get a story (event) with its coverage timeline and AI digest
description: 'One story = one real-world event aggregated from every covering source: a reverse-chronological coverage timeline, an AI digest that is rewritten incrementally as the event evolves (contradictions with earlier reporting are stated explicitly), and links to same-storyline and related stories. Extract ids from the final path segment of a hot-topics links.story HTML URL, or use ids from another story''s storyline/related refs; never request links.story as JSON. Merged stories answer with a 308 to the surviving id. Call this endpoint only with an id actually returned by the API; a 404 means the public story layer or that story is unavailable.'
parameters:
- $ref: '#/components/parameters/ActorUserAgent'
- $ref: '#/components/parameters/IfNoneMatch'
- name: publicId
in: path
required: true
schema:
type: string
maxLength: 128
responses:
'200':
description: OK
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/StoryResponse'
'304':
description: Not Modified
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
'308':
description: Story was merged into another; follow Location to the surviving story id.
'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:
- Stories
servers:
- url: https://gameshot.games
components:
parameters:
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
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
schemas:
StoryReport:
type: object
required:
- id
- title
- summary
- source
- publishedAt
- links
properties:
id:
type: string
title:
type: string
summary:
type:
- string
- 'null'
source:
type: object
required:
- name
- firstParty
properties:
name:
type: string
firstParty:
type: boolean
publishedAt:
type: string
format: date-time
links:
type: object
required:
- aihot
properties:
aihot:
type: string
format: uri
original:
type: string
format: uri
StoryNeighbor:
type: object
required:
- publicId
- title
- relation
- links
properties:
publicId:
type: string
title:
type: string
relation:
type: string
links:
type: object
required:
- aihot
- api
properties:
aihot:
type: string
format: uri
api:
type: string
format: uri
StoryResponse:
type: object
required:
- schemaVersion
- story
properties:
schemaVersion:
const: 1
story:
$ref: '#/components/schemas/Story'
Story:
type: object
required:
- publicId
- title
- status
- sourceCount
- reportCount
- firstReportAt
- latestAt
- latest
- digest
- digestUpdatedAt
- links
- reports
- storyline
- related
properties:
publicId:
type: string
title:
type: string
status:
enum:
- active
- settled
sourceCount:
type: integer
minimum: 0
reportCount:
type: integer
minimum: 0
firstReportAt:
type: string
format: date-time
latestAt:
type: string
format: date-time
latest:
type: string
digest:
type:
- string
- 'null'
digestUpdatedAt:
type:
- string
- 'null'
format: date-time
links:
type: object
required:
- aihot
properties:
aihot:
type: string
format: uri
reports:
type: array
items:
$ref: '#/components/schemas/StoryReport'
storyline:
type: array
items:
$ref: '#/components/schemas/StoryNeighbor'
related:
type: array
items:
$ref: '#/components/schemas/StoryNeighbor'
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
externalDocs:
description: Machine-readable OpenAPI document
url: https://gameshot.games/openapi-v1.json
x-refined-from:
- gameshot-games-openapi.json
- openapi-v1.json