BAMF.ai

BAMF.ai X API

The X API from BAMF.ai — 5 operation(s) for x.

GitHub OpenAPI

Operations 5

GET /x/posts List X posts #
GET /x/analytics/posts List X post analytics #
GET /x/analytics/summary Get X analytics summary #
POST /x/analytics/sync Queue X analytics sync #
GET /x/bookmarks List private X/Twitter bookmark imports #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/bamf-ai/openapi/bamf-ai-x-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/bamf-ai/json-schema/bamf-ai-profile-snapshot-ingest-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/bamf-ai/json-schema/bamf-ai-outreach-growth-delivery-prepare-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/bamf-ai/json-schema/bamf-ai-generate-image-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/bamf-ai/json-schema/bamf-ai-exact-thread-reply-prepare-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/bamf-ai/json-schema/bamf-ai-creator-context-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/bamf-ai/json-schema/bamf-ai-run-node-event-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/bamf-ai:bamf-ai-x-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

bamf-ai-x-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: BAMF Developer Platform X API
  version: 0.1.0
servers:
- url: https://api.bamf.ai/v1
security:
- BearerAuth: []
tags:
- name: X
paths:
  /x/posts:
    get:
      summary: List X posts
      description: Returns saved X/Twitter posts for a creator space, including owned metrics when the connected account and X API plan expose them.
      parameters:
      - name: creator_id
        in: query
        schema:
          type: string
      - name: limit
        in: query
        schema:
          type: integer
          maximum: 500
      responses:
        '200':
          description: X posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericListResponse'
      tags:
      - X
      operationId: getXPosts
      x-operation-id-source: derived
  /x/analytics/posts:
    get:
      summary: List X post analytics
      description: Returns saved X/Twitter post analytics rows for a creator space.
      parameters:
      - name: creator_id
        in: query
        schema:
          type: string
      - name: limit
        in: query
        schema:
          type: integer
          maximum: 500
      responses:
        '200':
          description: X post analytics rows
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericListResponse'
      tags:
      - X
      operationId: getXAnalyticsPosts
      x-operation-id-source: derived
  /x/analytics/summary:
    get:
      summary: Get X analytics summary
      description: Returns account snapshots, totals, engagement rate, and top X posts from saved creator analytics rows.
      parameters:
      - name: creator_id
        in: query
        schema:
          type: string
      responses:
        '200':
          description: X analytics summary
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericDataResponse'
      tags:
      - X
      operationId: getXAnalyticsSummary
      x-operation-id-source: derived
  /x/analytics/sync:
    post:
      summary: Queue X analytics sync
      description: Triggers the X analytics sync function for the current or requested creator space.
      responses:
        '202':
          description: X analytics sync queued
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiJobResponse'
      tags:
      - X
      operationId: postXAnalyticsSync
      x-operation-id-source: derived
  /x/bookmarks:
    get:
      summary: List private X/Twitter bookmark imports
      description: Requires ideas:read. Private creator inspiration source; opt-in only when passed into idea/post generation. Each bookmark includes folder_memberships (an array of {folder_id, folder_name}); legacy folder_id and folder_name fields remain as a compatibility projection.
      parameters:
      - name: creator_id
        in: query
        schema:
          type: string
      - name: status
        in: query
        schema:
          type: string
      - name: folder_id
        in: query
        schema:
          type: string
      - name: folder_name
        in: query
        schema:
          type: string
      - name: search
        in: query
        schema:
          type: string
      - name: since
        in: query
        description: Only return bookmarks imported at or after this timestamp.
        schema:
          type: string
          format: date-time
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 50
      responses:
        '200':
          description: Bookmark rows
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        folder_id:
                          type:
                          - string
                          - 'null'
                        folder_name:
                          type:
                          - string
                          - 'null'
                        folder_memberships:
                          type: array
                          items:
                            type: object
                            properties:
                              folder_id:
                                type: string
                              folder_name:
                                type: string
      tags:
      - X
      operationId: getXBookmarks
      x-operation-id-source: derived
components:
  schemas:
    ApiJob:
      type: object
      properties:
        id:
          type: string
        job_type:
          type: string
          enum:
          - post.generate
          - post.edit
          - image.generate
          - carousel.generate
          - carousel.pdf
          - brand_kit.generate
          - research.run
          - knowledge.process
          - analytics.sync
        status:
          type: string
          enum:
          - queued
          - running
          - succeeded
          - completed
          - failed
          - cancelled
          - canceled
        creator_id:
          type: string
        input:
          $ref: '#/components/schemas/JSONValue'
        output:
          $ref: '#/components/schemas/JSONValue'
        error:
          $ref: '#/components/schemas/JSONValue'
          description: Private founder-video jobs may return a PrivateVideoJobError with allowlisted stage, category, provider, request ID, status, and HTTP status fields; no raw provider text or URLs are exposed.
        created_at:
          type:
          - string
          - 'null'
          format: date-time
        updated_at:
          type:
          - string
          - 'null'
          format: date-time
    GenericDataResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/JSONValue'
    ApiJobResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/ApiJob'
    JSONValue:
      description: Any JSON value returned by flexible workflow, analytics, context, or generation payloads.
    GenericListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/JSONValue'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer