Crafting Event Finder Platform API

The platform API from Crafting Event Finder — 4 operation(s) for platform.

Documentation GitHub OpenAPI

Operations 4

4 of 4 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file

GET /api/appearance This site's look: its theme and the season showing today conformant #

GET /api/location/guess A guess at the caller's town from their connection, shown as a suggestion only… conformant #

GET /api/health Service health conformant #

GET /api/tenant This site's name and which crafts it covers conformant #

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/craftingeventfinder-com:craftingeventfinder-com-platform-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

openapi: 3.2.0
info:
  title: Crafting Event Finder Platform API
  version: 1.0.0
  description: Everything the site does is available here, and as MCP tools at /api/mcp.
servers:
- url: https://craftingeventfinder.com
tags:
- name: Platform
paths:
  /api/appearance:
    get:
      summary: 'This site''s look: its theme and the season showing today'
      tags:
      - Platform
      security: []
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Appearance'
      operationId: getApiAppearance
      x-operation-id-source: derived
  /api/location/guess:
    get:
      summary: A guess at the caller's town from their connection, shown as a suggestion only…
      tags:
      - Platform
      security: []
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  label:
                    type:
                    - string
                    - 'null'
                    description: The caller's town as their connection suggests ("Seattle, WA"), or null outside the US or when unknown
                required:
                - label
      operationId: getApiLocationGuess
      x-operation-id-source: derived
  /api/health:
    get:
      summary: Service health
      tags:
      - Platform
      security: []
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    enum:
                    - true
                  service:
                    type: string
                  supabaseConfigured:
                    type: boolean
                  time:
                    type: string
                required:
                - ok
                - service
                - supabaseConfigured
                - time
      operationId: getApiHealth
      x-operation-id-source: derived
  /api/tenant:
    get:
      summary: This site's name and which crafts it covers
      tags:
      - Platform
      security: []
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SiteInfo'
      operationId: getApiTenant
      x-operation-id-source: derived
components:
  schemas:
    PaletteSummary:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        swatch:
          type: array
          items:
            type: string
      required:
      - id
      - name
      - swatch
    Appearance:
      type: object
      properties:
        theme:
          type: string
          enum:
          - county-fair
          - craft-paper
          - quilt-show
          - gallery-linen
          - sunny-fair
        themeLabel:
          type: string
        seasonMode:
          type: string
          enum:
          - auto
          - fixed
          - 'off'
        seasonFixed:
          type:
          - string
          - 'null'
          enum:
          - fall
          - holiday
          - winter
          - spring
          - summer
          - null
        season:
          type:
          - object
          - 'null'
          properties:
            id:
              type: string
              enum:
              - fall
              - holiday
              - winter
              - spring
              - summer
            label:
              type: string
            tagline:
              type: string
          required:
          - id
          - label
          - tagline
          description: The season showing right now, or null when seasons are off or the theme has none
        seasons:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                enum:
                - fall
                - holiday
                - winter
                - spring
                - summer
              label:
                type: string
              startsMonthDay:
                type: string
                description: MM-DD, Pacific time
            required:
            - id
            - label
            - startsMonthDay
          description: The theme's seasons; empty for a theme without seasons
        palette:
          type:
          - string
          - 'null'
          description: 'The color palette showing: the chosen one, else the theme''s default; null for a theme without palettes'
        palettes:
          type: array
          items:
            $ref: '#/components/schemas/PaletteSummary'
          description: The theme's color palettes, its default first; empty for a theme without palettes
      required:
      - theme
      - themeLabel
      - seasonMode
      - seasonFixed
      - season
      - seasons
      - palette
      - palettes
    SiteInfo:
      type: object
      properties:
        slug:
          type: string
        name:
          type: string
        tagline:
          type:
          - string
          - 'null'
        accentHex:
          type: string
        allowAll:
          type: boolean
        allowedCraftTypes:
          type: array
          items:
            type: string
      required:
      - slug
      - name
      - tagline
      - accentHex
      - allowAll
      - allowedCraftTypes
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key from /admin/api-keys: Authorization: Bearer cef_<scope>_...'
    cookieAuth:
      type: apiKey
      in: cookie
      name: cef_session