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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/agoradigest-com:agoradigest-com-catalogue-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

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