blumify-io API

openapi: 3.1.0
info:
  title: blumify-io API
  version: '2026-10-29'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-29: 4 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; blumify-io has published no machine-readable contract that the
    pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 4
    documentation: 0
    pages-with-code: 2
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-29'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://blumify.io/developers
  - https://blumify.io/AGENTS.md
paths:
  /api/media/v1/me/jobs/{jobid}:
    get:
      operationId: get_api_media_v1_me_jobs_jobid
      tags:
      - Api
      summary: GET /api/media/v1/me/jobs/{jobId}
      x-source: https://blumify.io/developers
      parameters:
      - name: jobid
        in: path
        required: true
        schema:
          type: string
      - name: wait
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://blumify.io/api/media/v1/me/jobs/JOB_ID?wait=50" -H "Authorization: Bearer $BLUMIFY_TOKEN"'
  /api/media/v1/me/transcripts:
    post:
      operationId: post_api_media_v1_me_transcripts
      tags:
      - Api
      summary: POST /api/media/v1/me/transcripts
      x-source: https://blumify.io/AGENTS.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiMediaV1MeTranscriptsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://blumify.io/api/media/v1/me/transcripts -H "Authorization: Bearer $BLUMIFY_TOKEN"  -H "Content-Type: application/json"
          -d ''{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'''
  /api/media/v1/me/transcripts/{key}/export:
    get:
      operationId: get_api_media_v1_me_transcripts_key_export
      tags:
      - Api
      summary: GET /api/media/v1/me/transcripts/{key}/export
      x-source: https://blumify.io/developers
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
      - name: format
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://blumify.io/api/media/v1/me/transcripts/KEY/export?format=md" -H "Authorization: Bearer $BLUMIFY_TOKEN" Every endpoint,
          limit and error code is in /AGENTS.md . Follow creators with POST /me/follows and read what is new with GET /me/feed , or skip polling:
          add a webhook in Connected apps and we call your URL when a transcript is ready or a creator you follow has a new one. 3. MCP serve'
  /api/media/v1/transcribe:
    post:
      operationId: post_api_media_v1_transcribe
      tags:
      - Api
      summary: POST /api/media/v1/transcribe
      x-source: https://blumify.io/developers
      parameters:
      - name: summarize
        in: query
        required: false
        schema:
          type: string
      - name: url
        in: query
        required: false
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiMediaV1TranscribeRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -N "https://blumify.io/api/media/v1/transcribe?url=https://youtu.be/dQw4w9WgXcQ&summarize=1"

          event: meta

          data: {"key": "youtube:dQw4w9WgXcQ", "cached": true, ...}

          event: done

          data: {"permalink": "...", "summary": "...", "chapters": [...], "segments": [...]} Every endpoint, field, error code and limit: /AGENTS.md
          (written for scripts and AI agents). A short summary of the site: /llms.txt . 2. '
components:
  schemas:
    PostApiMediaV1MeTranscriptsRequest:
      type: object
      properties:
        url:
          type: string
    PostApiMediaV1TranscribeRequest:
      type: object
      properties:
        url:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api