CreateMod.com

CreateMod.com Analytics API

The Analytics API from CreateMod.com — 2 operation(s) for analytics.

GitHub OpenAPI

Operations 2

GET /api/schematics/{name}/stats Get schematic analytics #
GET /api/user/stats Get user analytics #

Documentation

📖
Documentation
https://createmod.com/api

Specifications

⚙
OpenAPI
https://artifacts.apis.io/createmod-com/openapi/createmod-com-analytics-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/createmod-com/json-schema/createmod-com-schematic-stats-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/createmod-com/json-schema/createmod-com-user-stats-response-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/createmod-com/apis.yml

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/createmod-com:createmod-com-analytics-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.

GitHub Google LinkedIn

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

OpenAPI Specification

createmod-com-analytics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Createmod Com Analytics API
  version: 1.0.0
  contact:
    email: hello@createmod.com
  termsOfService: https://createmod.com/terms-of-service
  description: 'Operations tagged Analytics across 2 of this provider''s published API definitions: createmod-com-openapi.json, createmod-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://createmod.com
  description: Production
security:
- ApiKeyHeader: []
tags:
- name: Analytics
paths:
  /api/schematics/{name}/stats:
    get:
      operationId: getSchematicStats
      summary: Get schematic analytics
      description: Returns hourly analytics for the last 30 days. Only the schematic author can access this endpoint. API key authentication only (HMAC not supported).
      tags:
      - Analytics
      security:
      - ApiKeyHeader: []
      - ApiKeyQuery: []
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
        description: The URL slug of the schematic
      responses:
        '200':
          description: Schematic analytics data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SchematicStatsResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          description: Not the schematic owner
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
    servers:
    - url: https://createmod.com
      description: Production
  /api/user/stats:
    get:
      operationId: getUserStats
      summary: Get user analytics
      description: Returns aggregate hourly analytics across all schematics owned by the API key holder, plus a paginated schematic list with per-schematic totals. API key authentication only (HMAC not supported).
      tags:
      - Analytics
      security:
      - ApiKeyHeader: []
      - ApiKeyQuery: []
      parameters:
      - name: page
        in: query
        schema:
          type: integer
          default: 1
          minimum: 1
        description: Page number for the schematic list
      responses:
        '200':
          description: User analytics data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserStatsResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
    servers:
    - url: https://createmod.com
      description: Production
components:
  responses:
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing or invalid authentication
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Rate limit exceeded
      headers:
        Retry-After:
          schema:
            type: integer
          description: Seconds to wait before retrying
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    UserStatsResponse:
      type: object
      properties:
        total_views:
          type: integer
        total_downloads:
          type: integer
        vd_ratio:
          type: number
          format: float
        site_avg_vd_ratio:
          type: number
          format: float
        views:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
        downloads:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
        video_plays:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
        yt_clicks:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
        time_on_page:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
        layer_views:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
        schematics:
          type: array
          items:
            $ref: '#/components/schemas/UserStatsSchematic'
        total_schematics:
          type: integer
        page:
          type: integer
        page_size:
          type: integer
        has_next:
          type: boolean
        has_prev:
          type: boolean
      required:
      - total_views
      - total_downloads
      - vd_ratio
      - site_avg_vd_ratio
      - views
      - downloads
      - video_plays
      - yt_clicks
      - time_on_page
      - layer_views
      - schematics
      - total_schematics
      - page
      - page_size
      - has_next
      - has_prev
    HourlyStat:
      type: object
      properties:
        hour:
          type: string
          example: 2026-04-29 14
          description: Hour bucket in YYYY-MM-DD HH format (UTC)
        count:
          type: integer
          format: int64
          description: Value for this hour
      required:
      - hour
      - count
    SchematicStatsResponse:
      type: object
      properties:
        name:
          type: string
        title:
          type: string
        total_views:
          type: integer
        total_downloads:
          type: integer
        comments:
          type: integer
          format: int64
        vd_ratio:
          type: number
          format: float
          description: Downloads / views ratio (0 to 1)
        site_avg_vd_ratio:
          type: number
          format: float
          description: Site-wide average downloads/views ratio
        has_video:
          type: boolean
        views:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
          description: Hourly view counts for the last 30 days
        downloads:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
          description: Hourly download counts
        video_plays:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
          description: Hourly video play counts (only present if has_video is true)
        yt_clicks:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
          description: Hourly YouTube click counts (only present if has_video is true)
        time_on_page:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
          description: Average time on page per hour (seconds)
        layer_views:
          type: array
          items:
            $ref: '#/components/schemas/HourlyStat'
          description: Hourly layer viewer usage counts
      required:
      - name
      - title
      - total_views
      - total_downloads
      - comments
      - vd_ratio
      - site_avg_vd_ratio
      - has_video
      - views
      - downloads
      - time_on_page
      - layer_views
    Error:
      type: object
      properties:
        error:
          type: string
      required:
      - error
    UserStatsSchematic:
      type: object
      properties:
        name:
          type: string
        title:
          type: string
        featured_image:
          type: string
        views:
          type: integer
        downloads:
          type: integer
        vd_ratio:
          type: number
          format: float
        created:
          type: string
          format: date-time
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key passed via X-API-Key header. Generate at /settings/api-keys.
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api_key
      description: API key passed as a query parameter (less secure, use header when possible).
    HMACSignature:
      type: http
      scheme: bearer
      description: 'HMAC-SHA256 authentication via X-Mod-Message and X-Mod-Signature headers. Message format: timestamp:modversion:mcusername:identifier. The signature is HMAC-SHA256(message, shared_secret) hex-encoded. Timestamps must be within 5 minutes.'
x-refined-from:
- createmod-com-openapi.json
- createmod-com-openapi.yml