Gameshot Hot Topics API
The Hot Topics API from Gameshot — 1 operation(s) for hot topics.
The Hot Topics API from Gameshot — 1 operation(s) for hot topics.
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/gameshot-games:gameshot-games-hot-topics-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: Gameshot Games Hot Topics API
version: 3.0.0
termsOfService: https://gameshot.games/terms
description: 'Operations tagged Hot Topics 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: Hot Topics
paths:
/api/v1/hot-topics:
get:
operationId: hotTopics
summary: List current multi-source hot topics
description: 'The current Gameshot Top 10, ranked by multi-source coverage and discussion heat. Each item includes a one-based rank; internal and display heat values are not returned. Uses the latest successfully published ranking, normally refreshed every five minutes. Shared caches use a 60s freshness window; poll no faster than s-maxage and use If-None-Match. If an item includes links.story, it is a human-facing HTML URL: extract its final publicId path segment and call /api/v1/stories/{publicId} for timeline JSON. Never request links.story as an API. When absent, do not construct a story id.'
responses:
'200':
description: OK
headers:
ETag:
schema:
type: string
Cache-Control:
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/HotTopicsResponse'
'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'
parameters:
- $ref: '#/components/parameters/ActorUserAgent'
- $ref: '#/components/parameters/IfNoneMatch'
tags:
- Hot Topics
servers:
- url: https://gameshot.games
components:
schemas:
HotTopic:
type: object
required:
- rank
- id
- title
- source
- links
- sourceCount
- signalCount
- sourceNames
- latestAt
properties:
rank:
type: integer
minimum: 1
maximum: 10
description: One-based position in the current Gameshot Top 10 response.
id:
type: string
title:
type: string
source:
type: object
required:
- name
properties:
name:
type: string
links:
type: object
required:
- aihot
- original
properties:
aihot:
type: string
format: uri
original:
type: string
format: uri
story:
type: string
format: uri
description: Optional human-facing HTML URL. Extract its final publicId path segment and call /api/v1/stories/{publicId} for JSON; never request this URL as an API. Do not construct story ids when absent.
sourceCount:
type: integer
minimum: 0
signalCount:
type: integer
minimum: 0
participantCount:
type: integer
minimum: 0
description: Distinct observed actors, unioned across editorial and signal sources; not a platform-wide population estimate.
sourceNames:
type: array
items:
type: string
latestAt:
type: string
format: date-time
HotTopicsResponse:
type: object
required:
- schemaVersion
- count
- items
properties:
schemaVersion:
const: 1
count:
type: integer
minimum: 0
items:
type: array
items:
$ref: '#/components/schemas/HotTopic'
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
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
externalDocs:
description: Machine-readable OpenAPI document
url: https://gameshot.games/openapi-v1.json
x-refined-from:
- gameshot-games-openapi.json
- openapi-v1.json