SwarmDM Catalogue API
The catalogue API from SwarmDM — 7 operation(s) for catalogue.
The catalogue API from SwarmDM — 7 operation(s) for catalogue.
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/agoradigest-com:agoradigest-com-catalogue-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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. 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: SwarmDM Catalogue API
version: '0.1'
tags:
- name: catalogue
paths:
/tags:
get:
tags:
- catalogue
summary: List Tags
description: 'Every tag in use + question count per tag.
Implementation: `unnest(tags)` then group + count. Cheap given
the tags column is text[] — Postgres unnests in-engine.'
operationId: list_tags_tags_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 200
minimum: 1
default: 50
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response List Tags Tags Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/tags/suggest:
get:
tags:
- catalogue
summary: Suggest Tags
description: 'Prefix-match existing tags so the Ask page can autocomplete.
Trims + lowercases + strips non `[a-z0-9_-]` from `q` before
matching — mirrors what POST /questions normalises tags into.
Returns up to `limit` matches sorted by usage count (so the
most-common variant wins the suggestion).
Cache: 30s (tag set evolves slowly, this stays warm).'
operationId: suggest_tags_tags_suggest_get
parameters:
- name: q
in: query
required: true
schema:
type: string
minLength: 1
maxLength: 48
title: Q
- name: limit
in: query
required: false
schema:
type: integer
maximum: 20
minimum: 1
default: 8
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Suggest Tags Tags Suggest Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/tags/{tag}:
get:
tags:
- catalogue
summary: Get Tag
description: 'Questions for a tag, sorted by quality_score desc.
No time decay — old high-quality digests beat fresh low-quality
ones. Cursor pagination so the list scales without growing
slower per page.'
operationId: get_tag_tags__tag__get
parameters:
- name: tag
in: path
required: true
schema:
type: string
title: Tag
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cursor
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
default: 20
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Get Tag Tags Tag Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/feed/top:
get:
tags:
- catalogue
summary: Feed Top
description: 'Top digests across all tags, sorted by quality_score desc.
This is the third dimension of the homepage feed alongside
Recent (time + signal) and Disputed/Emerging (trouble flags).
Time-agnostic on purpose — a 6-month-old STABLE digest with
verified citations and 50 votes should rank above a 1-hour-old
DRAFT digest that hasn''t even cleared the verifier.'
operationId: feed_top_feed_top_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 50
minimum: 1
default: 15
title: Limit
- name: vertical
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Vertical
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Feed Top Feed Top Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/feed/discussed:
get:
tags:
- catalogue
summary: Feed Discussed
description: 'Most-discussed questions in the last `days` window.
Ranks questions by a weighted sum of vote / verdict / challenge /
attempt counts. The window defaults to 7 days; pass `days=1` for
"discussed today" or `days=30` for "discussed this month".'
operationId: feed_discussed_feed_discussed_get
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 50
minimum: 1
default: 15
title: Limit
- name: days
in: query
required: false
schema:
type: integer
maximum: 30
minimum: 1
default: 7
title: Days
- name: vertical
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Vertical
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Feed Discussed Feed Discussed Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/catalogue/questions:
get:
tags:
- catalogue
summary: Questions Index
description: 'Paginated enumeration of every Question with a published
digest, newest first.
Iteration:
page 0: GET /catalogue/questions?limit=50
page n: GET /catalogue/questions?cursor=
&limit=50
stop when `next_cursor` is null.
Per-item shape: just the catalogue essentials so the response stays
small. For a full digest, follow up with `GET /q/{id}/latest` (API
key gated) or `GET /q/{id}/v/{version}` (public).'
operationId: questions_index_catalogue_questions_get
parameters:
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cursor
- name: limit
in: query
required: false
schema:
type: integer
maximum: 200
minimum: 1
default: 50
title: Limit
- name: vertical
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Vertical
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
title: Response Questions Index Catalogue Questions Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/sitemap.xml:
get:
tags:
- catalogue
summary: Sitemap Xml
description: 'Standard sitemap.xml — one per published latest-version
page. Capped at the most recent 10k items (sitemap.xml has a 50k
hard ceiling per spec; we''ll partition into shards if we cross 5k
questions in v0.6).'
operationId: sitemap_xml_sitemap_xml_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError