FluxSocial

FluxSocial API

FluxSocial API as documented publicly: 12 operations. Contract generated from the documentation by API Evangelist (2026-11-08); not the provider's own document.

GitHub OpenAPI

Operations 12

GET /api/v1/accounts List social accounts #
GET /api/v1/businesses List businesses #
POST /api/v1/content Generate content (text) #
POST /api/v1/content/sug_001/image Generate AI image #
POST /api/v1/content/sug_001/post Post to platforms #
POST /api/v1/content/sug_001/schedule Schedule for future publishing #
POST /api/v1/content/upload-media Upload user media from URL #
GET /api/v1/credits/balance Get credit balance #
POST /api/v1/credits/balance POST /api/v1/credits/balance #
GET /api/v1/credits/cost-preview Preview generation cost #
GET /api/v1/schedule/optimal-time Get AI-recommended posting time #
POST /api/v1/video Generate AI video (async) #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/fluxsocial-app/openapi/_ae-authored/fluxsocial-app-openapi-generated.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/fluxsocial-app/json-schema/fluxsocial-app-post-api-v1-content-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/fluxsocial-app/json-schema/fluxsocial-app-post-api-v1-content-upload-media-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/fluxsocial-app/json-schema/fluxsocial-app-post-api-v1-video-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/fluxsocial-app/json-schema/fluxsocial-app-post-api-v1-credits-balance-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/fluxsocial-app/json-schema/fluxsocial-app-get-api-v1-accounts-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/fluxsocial-app/json-schema/fluxsocial-app-post-api-v1-content-sug001-schedule-request-schema.json

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/fluxsocial-app:fluxsocial-app-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

fluxsocial-app-openapi-generated.yml Raw ↑ 
openapi: 3.1.0
info:
  title: FluxSocial API
  version: '2026-11-08'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-08: 12 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; FluxSocial has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 11
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-08'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.fluxsocial.app/developers
paths:
  /api/v1/accounts:
    get:
      operationId: get_api_v1_accounts
      tags:
      - Api
      summary: List social accounts
      x-source: https://www.fluxsocial.app/developers
      parameters:
      - name: businessId
        in: query
        required: false
        schema:
          type: string
        description: Filter accounts by business
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1AccountsResponse'
      x-evidence:
        kind: documentation
  /api/v1/businesses:
    get:
      operationId: get_api_v1_businesses
      tags:
      - Api
      summary: List businesses
      x-source: https://www.fluxsocial.app/developers
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1BusinessesResponse'
      x-evidence:
        kind: documentation
  /api/v1/content:
    post:
      operationId: post_api_v1_content
      tags:
      - Api
      summary: Generate content (text)
      x-source: https://www.fluxsocial.app/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ContentRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1ContentResponse'
      x-evidence:
        kind: documentation
  /api/v1/content/sug_001/image:
    post:
      operationId: post_api_v1_content_sug_001_image
      tags:
      - Api
      summary: Generate AI image
      x-source: https://www.fluxsocial.app/developers
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ContentSug001ImageRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1ContentSug001ImageResponse'
      x-evidence:
        kind: documentation
  /api/v1/content/sug_001/post:
    post:
      operationId: post_api_v1_content_sug_001_post
      tags:
      - Api
      summary: Post to platforms
      x-source: https://www.fluxsocial.app/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ContentSug001PostRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1ContentSug001PostResponse'
      x-evidence:
        kind: documentation
  /api/v1/content/sug_001/schedule:
    post:
      operationId: post_api_v1_content_sug_001_schedule
      tags:
      - Api
      summary: Schedule for future publishing
      x-source: https://www.fluxsocial.app/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ContentSug001ScheduleRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1ContentSug001ScheduleResponse'
      x-evidence:
        kind: documentation
  /api/v1/content/upload-media:
    post:
      operationId: post_api_v1_content_upload_media
      tags:
      - Api
      summary: Upload user media from URL
      x-source: https://www.fluxsocial.app/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1ContentUploadMediaRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1ContentUploadMediaResponse'
      x-evidence:
        kind: documentation
  /api/v1/credits/balance:
    get:
      operationId: get_api_v1_credits_balance
      tags:
      - Api
      summary: Get credit balance
      x-source: https://www.fluxsocial.app/developers
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CreditsBalanceResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_v1_credits_balance
      tags:
      - Api
      summary: POST /api/v1/credits/balance
      x-source: https://www.fluxsocial.app/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1CreditsBalanceRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1CreditsBalanceResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://www.fluxsocial.app/api/v1/credits/balance  -H \"Authorization: Bearer fsx_live_YOUR_KEY\" 3. Generate Content Generate\
          \ content with a single POST. Credits are deducted from your balance (same pool as the web app). POST /api/v1/content bash curl -X POST\
          \ https://www.fluxsocial.app/api/v1/content  -H \"Authorization: Bearer fsx_live_YOUR_KEY\"  -H \"Content-Type: application/json\" \
          \ -d '{\n \"pr"
  /api/v1/credits/cost-preview:
    get:
      operationId: get_api_v1_credits_cost_preview
      tags:
      - Api
      summary: Preview generation cost
      x-source: https://www.fluxsocial.app/developers
      parameters:
      - name: type
        in: query
        required: true
        schema:
          type: string
        description: '"text", "image", or "video"'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CreditsCostPreviewResponse'
      x-evidence:
        kind: documentation
  /api/v1/schedule/optimal-time:
    get:
      operationId: get_api_v1_schedule_optimal_time
      tags:
      - Api
      summary: Get AI-recommended posting time
      x-source: https://www.fluxsocial.app/developers
      parameters:
      - name: businessId
        in: query
        required: true
        schema:
          type: string
        description: Business to analyze
      - name: accountIds
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated account IDs to narrow analysis
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1ScheduleOptimalTimeResponse'
      x-evidence:
        kind: documentation
  /api/v1/video:
    post:
      operationId: post_api_v1_video
      tags:
      - Api
      summary: Generate AI video (async)
      x-source: https://www.fluxsocial.app/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1VideoRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1VideoResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV1AccountsResponse:
      type: object
      properties:
        accounts:
          type: array
          description: List of account objects
        id:
          type: string
          description: Account identifier
        platform:
          type: string
          description: Platform name
        username:
          type: string
          description: Username on the platform
        followers:
          type: integer
          description: Number of followers
    GetApiV1BusinessesResponse:
      type: object
      properties:
        businesses:
          type: array
          description: Array of business objects
    PostApiV1ContentRequest:
      type: object
      properties:
        prompt:
          type: string
          description: Content topic or description
        businessId:
          type: string
          description: Business ID from /businesses
        contentFormat:
          type: string
          description: 'IMAGE, VIDEO, CAROUSEL, REEL, STORY, TEXT. Default: IMAGE'
        useContentDNA:
          type: boolean
          description: 'Use the business''s own post history and visual style. Default: true'
        language:
          type: string
          description: Force output language (e.g. "he", "es"). Omit to use the prompt language, or the business's post language when the prompt
            is English or too short
        suggestionCount:
          type: number
          description: '1-6 suggestions. Default: 4'
      required:
      - prompt
      - businessId
    PostApiV1ContentResponse:
      type: object
      properties:
        sessionId:
          type: string
        suggestions:
          type: array
          description: Array of suggestion objects
        creditsUsed:
          type: number
        balanceAfter:
          type: number
        brandProfile:
          type: object
    PostApiV1ContentSug001ImageRequest:
      type: object
      properties:
        imageIndex:
          type: number
          description: 'Slide index for carousels (0-based). Default: 0'
        customPrompt:
          type: string
          description: Override the auto-generated image prompt
    PostApiV1ContentSug001ImageResponse:
      type: object
      properties:
        imageUrl:
          type: string
        creditsUsed:
          type: number
    PostApiV1ContentSug001PostRequest:
      type: object
      properties:
        targets:
          type: array
          description: Array of target objects with accountId and platform
      required:
      - targets
    PostApiV1ContentSug001PostResponse:
      type: object
      properties:
        suggestionId:
          type: string
        results:
          type: array
          description: Array of posting results
    PostApiV1ContentSug001ScheduleRequest:
      type: object
      properties:
        scheduledFor:
          type: string
          description: ISO 8601 datetime in the future
        targets:
          type: array
          description: Array of target objects with accountId and platform
      required:
      - scheduledFor
      - targets
    PostApiV1ContentSug001ScheduleResponse:
      type: object
      properties:
        suggestionId:
          type: string
        scheduledFor:
          type: string
        targets:
          type: array
    PostApiV1ContentUploadMediaRequest:
      type: object
      properties:
        mediaUrl:
          type: string
          description: HTTPS URL to image/video. Max 8MB images, 100MB videos
        businessId:
          type: string
          description: Business ID
        caption:
          type: string
          description: Caption text for the post
        contentFormat:
          type: string
          description: IMAGE, VIDEO, CAROUSEL, REEL, STORY
        title:
          type: string
          description: Optional title. Defaults to first 50 chars of caption
        tags:
          type: array
          description: 'Hashtags without # prefix'
        mediaUrls:
          type: array
          description: 'For CAROUSEL only: 2-10 image URLs (replaces mediaUrl)'
      required:
      - mediaUrl
      - businessId
    PostApiV1ContentUploadMediaResponse:
      type: object
      properties:
        suggestionId:
          type: string
        sessionId:
          type: string
        contentFormat:
          type: string
        mediaUrl:
          type: string
        creditsUsed:
          type: integer
    GetApiV1CreditsBalanceResponse:
      type: object
      properties:
        balance:
          type: number
    PostApiV1CreditsBalanceRequest:
      type: object
      properties:
        prompt:
          type: string
        businessId:
          type: string
        contentFormat:
          type: string
    PostApiV1CreditsBalanceResponse:
      type: object
      properties:
        sessionId:
          type: string
        suggestions:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              title:
                type: string
              body:
                type: string
              contentFormat:
                type: string
              tags:
                type: array
                items:
                  type: string
        creditsUsed:
          type: integer
        balanceAfter:
          type: integer
    GetApiV1CreditsCostPreviewResponse:
      type: object
      properties:
        type:
          type: string
        cost:
          type: number
        currentBalance:
          type: number
    GetApiV1ScheduleOptimalTimeResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
          description: Contains scheduledDateTime, confidence, reasoning
    PostApiV1VideoRequest:
      type: object
      properties:
        prompt:
          type: string
          description: Scene description with subject, action, camera, mood
        duration:
          type: number
          description: '4, 6, or 8 seconds. Default: 8'
        aspectRatio:
          type: string
          description: '"9:16" (vertical) or "16:9" (horizontal). Default: 9:16'
        style:
          type: string
          description: '"realistic", "animated", "cinematic", "social". Default: social'
      required:
      - prompt
    PostApiV1VideoResponse:
      type: object
      properties:
        operationId:
          type: string
        status:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api